Test-Path 帮助信息

如下说明是翻译: 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