将路径和子路径合并到单个路径中。提供程序将提供路径分隔符。
语法
Join-Path [-Path] <string[]> [-ChildPath] <string> [-Credential <PSCredential>] [-Resolve] [-UseTransaction] [<CommonParameters>]
说明
Join-Path cmdlet 将路径和子路径合并到单个路径中。提供程序将提供路径分隔符。
参数
-ChildPath <string>
指定要追加到 Path 的值中的元素。允许使用通配符。ChildPath 参数是必需的，但参数名（“ChildPath”）是可选的。
|
是否为必需？ |
true |
|
位置？ |
2 |
|
默认值 |
|
|
是否接受管道输入？ |
true (ByPropertyName) |
|
是否接受通配符？ |
false |
-Credential <PSCredential>
指定有权执行此操作的用户帐户。默认值为当前用户。
键入用户名，例如“User01”或“Domain01\User01”。或者，输入 PSCredential 对象，例如由 Get-Credential cmdlet 生成的对象。如果键入用户名，则将提示您输入密码。
随同 Windows PowerShell 一起安装的任何提供程序都不支持此参数。
|
是否为必需？ |
false |
|
位置？ |
named |
|
默认值 |
|
|
是否接受管道输入？ |
true (ByPropertyName) |
|
是否接受通配符？ |
false |
-Path <string[]>
指定子路径追加到的主路径。允许使用通配符。
Path 的值可确定哪个提供程序将联接路径并添加路径分隔符。Path 参数是必需的，但参数名（“Path”）是可选的。
|
是否为必需？ |
true |
|
位置？ |
1 |
|
默认值 |
|
|
是否接受管道输入？ |
true (ByValue, ByPropertyName) |
|
是否接受通配符？ |
false |
-Resolve
显示联接的路径所引用的项。
|
是否为必需？ |
false |
|
位置？ |
named |
|
默认值 |
|
|
是否接受管道输入？ |
false |
|
是否接受通配符？ |
false |
-UseTransaction
将命令包含在活动事务中。仅当正在执行事务时，此参数才有效。有关详细信息，请参阅 about_Transactions。
|
是否为必需？ |
false |
|
位置？ |
named |
|
默认值 |
|
|
是否接受管道输入？ |
false |
|
是否接受通配符？ |
false |
<CommonParameters>
此 cmdlet 支持通用参数：-Verbose、-Debug、-ErrorAction、-ErrorVariable、-OutBuffer 和 -OutVariable。有关详细信息，请参阅 about_Commonparameters.
输入和输出
输入类型是指可通过管道传递给 cmdlet 的对象的类型。返回类型是指 Cmdlet 所返回对象的类型。
|
输入 |
System.String 可以通过管道将包含路径的字符串传递给 Join-Path。 |
|
输出 |
System.String Join-Path 返回一个包含结果路径的字符串。 |
说明
包含 Path 名词的 cmdlet (Path cmdlet) 采用路径名称作为参数，以所有 Windows PowerShell 提供程序都能够解释的简明格式返回名称。这些 cmdlet 用于需要在其中以特定格式显示全部或部分路径名称的程序或脚本中。您可以像使用 Dirname、Normpath、Realpath、Join 或其他路径操作程序那样使用这些 cmdlet。
可以将路径 cmdlet 与某些提供程序一起使用，包括 FileSystem、Registry 和 Certificate 提供程序。
Join-Path cmdlet 可使用由任何提供程序公开的数据。要列出会话中可用的提供程序，请键入“Get-PSProvider”。有关详细信息，请参阅 about_Providers。
示例 1
C:\PS>join-path -path c:\win* -childpath System* 说明 ----------- 此命令使用 Join-Path 将“c:\Win*”路径与“System*”子路径合并。FileSystem（Windows PowerShell 文件系统提供程序）联接路径并添加“\”分隔符。
示例 2
C:\PS>join-path c:\win* System* -resolve 说明 ----------- 此命令显示通过联接“c:\Win*”路径和“System*”子路径而引用的文件和文件夹。此命令显示与 Get-ChildItem 相同的文件和文件夹，但它还显示每个项的完全限定路径。在此命令中，省略了 Path 和 ChildPath 可选参数名称。
示例 3
C:\PS>PS HKLM:\> join-path System *ControlSet* -resolve 说明 ----------- 此命令显示 HKLM\System 注册表子项中包括“ControlSet”的注册表项。此示例演示如何将 Join-Path 与 Windows PowerShell 注册表提供程序一起使用。
示例 4
C:\PS>join-path -path C:, D:, E:, F: -childpath New 说明 ----------- 此命令使用 Join-Path 将多个路径根与一个子路径组合在一起。
示例 5
C:\PS>get-psdrive -psprovider filesystem | foreach {$_.root} | join-path -childpath Subdir
说明
-----------
此命令将控制台中每个 Windows PowerShell 文件系统驱动器的根与 Subdir 子路径组合在一起。
该命令使用 Get-PSDrive cmdlet 获取 FileSystem 提供程序支持的 Windows PowerShell 驱动器。ForEach 语句仅选择 PSDriveInfo 对象的 Root 属性并将其与指定的子路径组合在一起。
输出显示计算机上的 Windows PowerShell 驱动器包含映射到 C:\Program Files 目录的驱动器。
另请参阅