Split-Path 帮助信息

  

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

译者: Edengundam(马涛)

 

Split-Path

 

大纲

返回路径中指定的部分.

 

语法

Split-Path [-path] <string[]> [-parent] [-resolve] [-credential <PSCredential>] [-literalPath <string[]>] [<CommonParameters>]

 

Split-Path [-path] <string[]> [[-qualifier]] [-resolve] [-credential <PSCredential>] [-literalPath <string[]>] [<CommonParameters>]

 

Split-Path [-path] <string[]> [-noQualifier] [-resolve] [-credential <PSCredential>] [-literalPath <string[]>] [<CommonParameters>]

 

Split-Path [-path] <string[]> [-leaf] [-resolve] [-credential <PSCredential>] [-literalPath <string[]>] [<CommonParameters>]

 

Split-Path [-path] <string[]> [-isAbsolute] [-resolve] [-credential <PSCredential>] [-literalPath <string[]>] [<CommonParameters>]

 

详细描述

Split-Path cmdlet returns只返回路径中指定的部分, 例如: 父目录, 子目录或者文件名. 你可以使用此cmdlet在脚本或应用中, 选择路径的一部分来显示或提交.

 

参数

 

-path <string[]>

指定要被分解的路径(允许使用通配符). 如果路径中包含空格, 使用引号将输入路径保护起来.

 

强制参数?	true
参数位置?	1
默认值	N/A - The path must be specified
允许从管道绑定输入?	true (根据值, 根据属性名)
允许通配符扩展?	true

 

-qualifier <SwitchParameter>

返回指定目录中的限定符(译者注: 此处英文中使用单词qualifier, 根据单词qualify + er变成具有限定功能的某某.). 对于文件系统或者注册表的providers, 限定名就是provider路径的驱动器名称, 例如C:或者HKCU:.

 

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

 

-parent <SwitchParameter>

返回通过参数path指定对象的父容器. 例如, 在"C:/Test/Logs/Pass1.log"路径中, 此命令将返回"C:/Test/Logs". 默认分解的路径是参数Parent.

 

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

 

-leaf <SwitchParameter>

返回路径中的最后一项(可以是容器, 译者注: 容器: 能够容纳其他对象的对象, 目录, 注册键都属于容器. ). 例如, 对于路径"C:/Test/Logs/Pass1.log", 此命令只返回"Pass1.log".

 

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

 

-noQualifier <SwitchParameter>

返回路径中除限定符的其余部分. 对于文件系统或者注册表的providers, 限定名就是provider路径的驱动器名称, 例如C:或者HKCU:. 例如, 对于路径"C:/Test/Logs/Pass1.log", 此命令只返回"/Test/Logs/Pass1.log".

 

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

 

-isAbsolute <SwitchParameter>

如果路径是绝对路径则返回真, 否则返回假. 绝对路径的长度大于0, 并且不使用"."指示当前路径(译者注: ".."表示父目录).

 

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

 

-resolve <SwitchParameter>

显示分解后剩余部分引用的项目. (译者注: 如果输入路径包含通配符, 使用此参数可以使通配符指定对象都被返回. 请参看例2. )

 

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

 

-credential <PSCredential>

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

 

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

 

-literalPath <string[]>

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

 

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

 

<公共参数>

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

 

返回类型

Strings

 

注意

 

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

 

分解的定位参数 -- Qualifier, Parent, Leaf和NoQualifier – 是互斥的. 你同时只能使用它们中的一个.

 

路径类cmdlets(*-path)操作路径名, 并返回所有Windows PowerShell providers 可以解释的简化命名格式. 它们被设计用于在程序或脚本中, 你想要显示路径为特定的格式. 使用它们就像你使用Dirname, Normpath, Realpath, Join或其他路径操作命令.

 

你可以对于不同的providers使用路径类cmdlets, 包括文件系统(FileSystem), 注册表(Registry),和证书(Certificate) providers.

 

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

 

例1

 

C:/PS>split-path "HKCU:/Software/Microsoft" -qualifier

 

此命令只返回路径中的限定符(盘符).

 

HKCU:

 

例2

 

C:/PS>split-path "C:/Test/Logs/*.log" -leaf -resolve

 

此命令显示被分解路径所引用的文件. 因为分解最后的部分("leaf"部分), 所以只有路径中的文件名被显示. (译者注: 如果不使用resolve, 此命令只返回"*.log", 而不会进行通配符展开. )

 

Pass1.log

Pass2.log

...

 

例3

 

C:/PS>split-path "C:/WINDOWS/system32/WindowsPowerShell/V1.0/about_*.txt"

 

此命令只返回路径名中的父容器. 由于此处没有指定任何参数, Split-Path将会使用默认参数Parent.

 

C:/WINDOWS/system32/WindowsPowerShell

 

例4

 

C:/PS>split-path –IsAbsolute "./My Pictures/*.jpg"

 

此命令判断路径是相对路径还是绝对路径. 此例中, 因为路径是相对当前路径指定的(通过使用"."), 此命令返回假($false).

 

False

 

例5

 

C:/PS>cd (split-path $profile)

 

此命令转换目录到包含Windows PowerShell profile的目录. "CD"是Set-Location cmdlet的别名, 用于改变当前目录. 括号中的命令使用Split-Path cmdlet返回内建变量$Profile中存储路径的父容器路径. (参数Parent是分解路径参数的默认值, 所以在命令输入时可以忽略该参数.) 括号指示Windows PowerShell首先执行括号内命令. 这是切换到径名较长位置的便捷方式.

 

PS C:/Documents and Settings/NicoleH/My Documents/PSConfiguration>

 

相关链接

Test-Path

Convert-Path

Resolve-Path

Join-Path

about_namespace