如下说明是翻译: 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的位置).
例3
C:/PS>test-path C:/CAD/Commercial_buildings/* -exclude *.dwg
此命令可以测试Commercial Buildings目录中除了*.dwg文件外, 是否存在其他文件.
例4
C:/PS>test-path $profile -pathtype leaf
此命令测试存储在变量$profile中的路径是否为叶子.
相关链接
Convert-Path
Split-Path
Resolve-Path
Join-Path
about_namespace