Test-Path 帮助信息

PowerShell

墨衍会员 · AI 创作全网分发码龄19年

关注

翻译最新推荐文章于 2026-09-20 20:46:55 发布 2.9k 阅读 AI 写同款· GEO 优化 ›

PowerShell: 在自定义代码中支持Tab键自动补全熟悉和使用PowerShell的自动补全功能，可以提高我们的工作效率。同时也可以写出更加易用的PowerShell脚本，以提高工作效率。阅读详情

如下说明是翻译: help Test-Path 产生的帮助信息.

译者: Edengundam(马涛)

Test-Path

大纲

确定路径中所有元素是否都存在.

语法

Test-Path [-path] <string[]> [-pathType {<Any> | <Container> | <Leaf>}] [-isValid] [-include <string[]>] [-exclude <string[]>] [-filter <string>] [-credential <PSCredential>] [<CommonParameters>]

Test-Path [-literalPath] <string[]> [-pathType {<Any> | <Container> | <Leaf>}] [-isValid] [-include <string[]>] [-exclude <string[]>] [-filter <string>] [-credential <PSCredential>] [<CommonParameters>]

详细描述

Test-Path cmdlet确定路径中所有元素是否都存在. 如果所有成员都存在, 此命令返回"true" ($true). 如果任何一个成员不存在, 此命令返回"false" ($false).

参数

-path <string[]>

指定需要测试的路径(允许使用通配符). 如果路径名中含有空白字符, 使用引号将路径名保护起来. 参数名("-Path")可以不指出.

强制参数?	true
参数位置?	1
默认值	无 – 必须指出路径
允许从管道绑定输入?	true (根据值, 根据属性名)
允许通配符扩展?	true

-pathType <TestPathType>

确定路径指定位置的元素类型. 如果该元素为指定类型返回真, 否则返回假.

合法取值为:

· 容器(Container): 可以包含其他元素的元素, 例如: 目录或注册表键值(registry key).

· 叶子(Leaf): 不能包含其他元素的元素, 例如: 普通文件或注册表项(registry entry).

· 任意: 容器或叶子.

强制参数?	false
参数位置?	命令行指定
默认值	Any
允许从管道绑定输入?	false
允许通配符扩展?	false

-isValid <SwitchParameter>

确定路径语法是否正确, 不检查该路径元素是否存在. 如果路径语法正确返回真, 否则返回假.

强制参数?	false
参数位置?	命令行指定
默认值
允许从管道绑定输入?	false
允许通配符扩展?	false

-include <string[]>

对指定的路径进行测试. 此参数值用于限定Path参数. 输入一个路径元素或模式, 例如"*.txt"(此参数允许通配符).

强制参数?	false
参数位置?	命令行指定
默认值
允许从管道绑定输入?	false
允许通配符扩展?	true

-exclude <string[]>

忽略对指定的路径. 此参数值用于限定Path参数. 输入一个路径元素或模式, 例如"*.txt"(此参数允许通配符).

强制参数?	false
参数位置?	命令行指定
默认值
允许从管道绑定输入?	false
允许通配符扩展?	true

-filter <string>

指定特定provider格式或语言的过滤器. 此参数值用于限定Path参数. 过滤器的语法取决于provider(是否支持通配符也依赖provider). 过滤器相比其他参数更加有效, 主要因为provider取值时候使用过滤器, 而不是等到provider将所有内容返回后, 由Windows PowerShell 过滤对象.

强制参数?	false
参数位置?	命令行指定
默认值
允许从管道绑定输入?	false
允许通配符扩展?	false

-credential <PSCredential>

使用其他凭证进行资源访问认证. <Credential>代表着用户名(例如: "User01"或"Domain01/User01") 或者PSCredential对象(例如: 通过Get-Credential cmdlet取得的对象). 如果此处使用用户名, 命令执行时会提示输入该用户密码. 尽管此参数出现, 但是并非所有Windows PowerShell核心cmdlets或providers支持此功能.

强制参数?	false
参数位置?	命令行指定
默认值
允许从管道绑定输入?	true (根据属性名)
允许通配符扩展?	false

-literalPath <string[]>

指定需要测试的路径. 与Path不同, LiteralPath的值被直接使用, 不会对任何通配符进行解释. 如果路径中包含了转义字符, 需要将路径用单引号保护. 单引号指示Windows PowerShell不对字符串中的转义字符进行处理.

强制参数?	true
参数位置?	1
默认值
允许从管道绑定输入?	true (根据属性名)
允许通配符扩展?	false

<公共参数>

此命令支持公共参数: -Verbose, -Debug, -ErrorAction, -ErrorVariable, and -OutVariable. 更多信息, 输入, "get-help about_commonparameters".

输入类型

字符串

返回类型

布尔类型

注意

更多信息, 输入"Get-Help Test-Path -detailed".需要技术信息, 输入"Get-Help Test-Path -full".

路径类的cmdlets (*-path)操作路径名称, 并返回Windows PowerShell providers能够解释的简单名称格式. 设计这些命令为了在程序或脚本中, 允许显示全部或部分路径名称为特定的格式. 使用它们就好像是用Dirname, Normpath, Realpath, Join, 或者其他路径操作命令.

你可以在不同provider上使用路径类的cmdlets, 包括文件系统, 注册表,和证书providers.

如果需要为该命令提供多个参数, 请使用逗号进行分隔. 例如, "<parameter-name> <value1>, <value2>".

例1

C:/PS>test-path "C:/Documents and Settings/Nicole"

此命令确定路径中各个元素是否存在.

例2

C:/PS>test-path $PROFILE

C:/PS>test-path $PROFILE -IsValid

这些命令用于测试Windows PowerShell profile路径. 第一个命令测试路径中所有元素是否都存在. 第二个命令测试路径的语法是否正确. 此例子中, 虽然测试路径返回结果为假, 但是语法确实正确的(真). 这些命令使用$PROFILE变量(无论此路径是否存在, 此内置变量都指向profile的位置).