Join-Path 帮助信息

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

译者: Edengundam(马涛)

 

Join-Path

 

大纲

将路径和子路径连接成一个单独的路径. 路径分隔符由提供程序提供.

 

语法

Join-Path [-path] <string[]> [-childPath] <string> [-resolve] [-credential <PSCredential>] [<CommonParameters>]

 

详细描述

Join-Path cmdlet将路径和子路径连接成一个单独的路径. 路径分隔符由提供程序提供.

 

参数

 

-path <string[]>

指定子路径所添加的主路径(允许指定多个). 允许使用通配符.

 

Path的值决定了使用的哪个提供程序连接路径和路径分隔符. 尽管参数名称(-path)可以省略, 但是参数Path的值不能省略.

 

强制参数?	true
参数位置?	1
默认值	N/A – 并须指定Path
允许从管道绑定输入?	true (根据值, 根据属性名)
允许通配符扩展?	true

 

-childPath <string>

指定被添加到Path值的子路径. 允许使用通配符. 尽管参数名称(-ChildPath)可以省略, 但是参数ChildPath的值不能省略.

 

强制参数?	true
参数位置?	2
默认值	N/A – 并须指定ChildPath
允许从管道绑定输入?	true (根据属性名)
允许通配符扩展?	true

 

-resolve <SwitchParameter>

指定连接后的路径所引用的对象.

 

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

 

-credential <PSCredential>

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

 

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

 

<公共参数>

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

 

输入类型

String

 

返回类型

String

 

注意

 

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

 

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

 

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

 

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

 

例1

 

C:/PS>join-path -path c:/win* -childpath System*

 

此命令使用Join-Path将路径"c:/Win*"与子路径"System*"连接起来. Windows PowerShell文件系统提供程序, 将路径连接起来, 并添加必要的分隔符"/".

 

c:/win*/System*

 

例2

 

C:/PS>join-path c:/win* System* -resolve

 

此命令将会显示将路径"c:/Win*"和子路径"System*"连接后所引用的文件和目录. 它将会显示与一样Get-Childitem的文件和目录, 但是每一项都会以完全限定路径显示. 此命令中, 可选的参数名称Path和Childpath被省略.

 

C:/WINDOWS/system

C:/WINDOWS/system32

C:/WINDOWS/system.ini

 

例3

 

C:/PS HKLM:/> join-path System *ControlSet* -resolve

 

此命令显示HKLM/System注册表项中所有"ControlSet"相关的项. 此命令显示如何使用Join-Path处理Windows PowerShell注册表提供程序.

 

HKLM:/System/ControlSet001

HKLM:/System/ControlSet002

HKLM:/System/CurrentControlSet

 

相关链接

Test-Path

Split-Path

Resolve-Path

Convert-Path

about_namespace