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