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