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