Join-Path
パスと子パスを 1 つのパスに結合します。
構文
Join-Path
[-Path] <String[]>
[-ChildPath] <String>
[[-AdditionalChildPath] <String[]>]
[-Resolve]
[-Credential <PSCredential>]
[<CommonParameters>]
説明
コマンドレットは Join-Path
、パスと子パスを 1 つのパスに結合します。
パスの区切り記号はプロバイダーによって追加されます。
例
例 1: パスと子パスを結合する
PS C:\> Join-Path -Path "path" -ChildPath "childpath"
path\childpath
このコマンドでは、 を使用 Join-Path
して、パスと子パスを組み合わせます。
コマンドはプロバイダーから実行されるため、パスをFileSystem
\
結合するための区切り記号が提供されます。
例 2: ディレクトリ区切り記号が既に含まれているパスを結合する
PS C:\> Join-Path -Path "path\" -ChildPath "\childpath"
path\childpath
既存の \
ディレクトリ区切り記号と 処理済みなので、 と の間 Path
には区切り記号が 1 つだけあります ChildPath
例 3: パスと子パスを結合してファイルとフォルダーを表示する
Join-Path "C:\win*" "System*" -Resolve
このコマンドは、C:\Win* パスと System* 子パスを結合することによって参照されるファイルとフォルダーを表示します。
と同じファイルとフォルダー Get-ChildItem
が表示されますが、各項目への完全修飾パスが表示されます。
このコマンドでは、 Path
および ChildPath
省略可能なパラメーター名は省略されます。
例 4: PowerShell レジストリ プロバイダーで Join-Path を使用する
PS HKLM:\> Join-Path -Path System -ChildPath *ControlSet* -Resolve
HKLM:\System\ControlSet001
HKLM:\System\CurrentControlSet
このコマンドは、 を含むControlSet
レジストリ サブキーにHKLM\System
レジストリ キーを表示します。
パラメーターは Resolve
、現在のプロバイダー パスからのワイルドカードを含む、結合されたパスの解決を試みます HKLM:\
例 5: 複数のパス ルートと子パスを結合する
Join-Path -Path C:, D:, E:, F: -ChildPath New
C:\New
D:\New
E:\New
F:\New
このコマンドでは、 を使用 Join-Path
して、複数のパス ルートを子パスと結合します。
注意
で Path
指定されたドライブが存在する必要があります。または、そのエントリの結合は失敗します。
例 6: ファイル システム ドライブのルートと子パスを結合する
Get-PSDrive -PSProvider filesystem | ForEach-Object {$_.root} | Join-Path -ChildPath "Subdir"
C:\Subdir
D:\Subdir
このコマンドは、コンソール内の各 PowerShell ファイル システム ドライブのルートと Subdir 子パスを結合します。
コマンドでは、 コマンドレットを Get-PSDrive
使用して、FileSystem プロバイダーでサポートされている PowerShell ドライブを取得します。
ステートメントは ForEach-Object
、オブジェクトの PSDriveInfo
Root プロパティのみを選択し、指定された子パスと組み合わせます。
出力は、コンピューター上の PowerShell ドライブに、C:\Program Files ディレクトリにマップされたドライブが含まれていることを示しています。
例 7: 不定数のパスを結合する
Join-Path a b c d e f g
a\b\c\d\e\f\g
パラメーターを AdditionalChildPath
使用すると、無制限の数のパスを結合できます。
この例では、パラメーター名は使用されません。したがって、"a" は に Path
バインドされ、"b" は に ChildPath
バインドされ、"c-g" は にバインドされます。 AdditionalChildPath
パラメーター
-AdditionalChildPath
Path パラメーターの値に追加する追加の要素を指定します。 パラメーターは ChildPath
引き続き必須であり、同様に指定する必要があります。
このパラメーターは、 プロパティを ValueFromRemainingArguments
使用して指定します。これにより、不定数のパスを結合できます。
Type: | String[] |
Position: | 2 |
Default value: | None |
Required: | False |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-ChildPath
パラメーターの値に追加する要素を Path
指定します。
ワイルドカードを使用できます。
パラメーター名 ChildPath
("ChildPath") は省略可能ですが、 パラメーターは必須です。
Type: | String |
Position: | 1 |
Default value: | None |
Required: | True |
Accept pipeline input: | True |
Accept wildcard characters: | True |
-Credential
注意
このパラメーターは、PowerShell でインストールされているプロバイダーではサポートされていません。 別のユーザーを偽装したり、このコマンドレットの実行時に資格情報を昇格したりするには、 Invoke-Command を使用します。
Type: | PSCredential |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-Path
子パスを追加するメイン パスを 1 つ以上指定します。 ワイルドカードを使用できます。
の Path
値によって、パスを結合し、パス区切り記号を追加するプロバイダーが決まります。
パラメーター名 Path
("Path") は省略可能ですが、 パラメーターは必須です。
Type: | String[] |
Aliases: | PSPath |
Position: | 0 |
Default value: | None |
Required: | True |
Accept pipeline input: | True |
Accept wildcard characters: | True |
-Resolve
このコマンドレットが、現在のプロバイダーからの参加済みパスの解決を試みる必要があることを示します。
- ワイルドカードを使用する場合、コマンドレットは結合されたパスと一致するすべてのパスを返します。
- ワイルドカードが使用 されていない 場合、パスが存在しない場合、コマンドレットはエラーになります。
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
入力
このコマンドレットへのパスを含む文字列をパイプできます。
出力
このコマンドレットは、結果のパスを含む文字列を返します。
メモ
Path 名詞 (Path コマンドレット) を含むコマンドレットは、パス名を操作し、すべての PowerShell プロバイダーが解釈できる簡潔な形式で名前を返します。 プログラムやスクリプトで、パス名の全部または一部を特定の形式で表示するために使用することを目的としています。 Dirname、Normpath、Realpath、Join など、他のパス操作コマンドレットと同じように使用します。
パス コマンドレットは、プロバイダーなど、複数のFileSystem
Registry
プロバイダーでCertificate
使用できます。
このコマンドレットは、任意のプロバイダーによって公開されるデータを操作するように設計されています。
セッションで使用できるプロバイダーを一覧表示するには、「」と入力します Get-PSProvider
。
詳細については、「about_Providers」を参照してください。