Join-Path
パスと子パスを 1 つのパスに結合します。パスの区切り記号はプロバイダーによって追加されます。
構文
Join-Path [-Path] <string[]> [-ChildPath] <string> [-Credential <PSCredential>] [-Resolve] [-UseTransaction] [<CommonParameters>]
説明
Join-Path コマンドレットは、パスと子パスを 1 つのパスに結合します。パスの区切り記号はプロバイダーによって追加されます。
パラメーター
-ChildPath <string>
Path の値に追加する要素を指定します。ワイルドカードを使用できます。ChildPath パラメーターは必須ですが、パラメーター名 ("ChildPath") は省略可能です。
必須 |
true |
位置 |
2 |
既定値 |
|
パイプライン入力を許可する |
true (ByPropertyName) |
ワイルドカード文字を許可する |
false |
-Credential <PSCredential>
この処理を実行するアクセス許可を持つユーザー アカウントを指定します。既定値は現在のユーザーです。
"User01" や "Domain01\User01" などユーザー名を入力します。または、Get-Credential コマンドレットで生成されるような PSCredential オブジェクトを入力します。ユーザー名を入力すると、パスワードの入力を促すメッセージが表示されます。
このパラメーターは、Windows PowerShell でインストールされるプロバイダーではサポートされていません。
必須 |
false |
位置 |
named |
既定値 |
|
パイプライン入力を許可する |
true (ByPropertyName) |
ワイルドカード文字を許可する |
false |
-Path <string[]>
子パスを追加するメイン パスを 1 つ以上指定します。ワイルドカードを使用できます。
Path の値によって、パスを結合し区切り記号を追加するプロバイダーが決まります。Path パラメーターは必須ですが、パラメーター名 ("Path") は省略可能です。
必須 |
true |
位置 |
1 |
既定値 |
|
パイプライン入力を許可する |
true (ByValue, ByPropertyName) |
ワイルドカード文字を許可する |
false |
-Resolve
結合されたパスによって参照される項目を表示します。
必須 |
false |
位置 |
named |
既定値 |
|
パイプライン入力を許可する |
false |
ワイルドカード文字を許可する |
false |
-UseTransaction
コマンドを有効なトランザクションに含めます。このパラメーターは、トランザクションの進行中のみ有効です。詳細については、「about_Transactions」を参照してください。
必須 |
false |
位置 |
named |
既定値 |
|
パイプライン入力を許可する |
false |
ワイルドカード文字を許可する |
false |
<CommonParameters>
このコマンドレットは、次の共通パラメーターをサポートします: -Verbose、-Debug、-ErrorAction、-ErrorVariable、-OutBuffer、および -OutVariable。詳細については、次を参照してください: about_Commonparameters.
入力と出力
入力値の型は、コマンドレットへのパイプが可能なオブジェクトの型です。戻り値の型は、コマンドレットによって返されるオブジェクトの型です。
入力 |
System.String パイプを使用してパスを含む文字列を Join-Path に渡すことができます。 |
出力 |
System.String Join-Path は、結果のパスを含む文字列を返します。 |
注
Path という名詞を含むコマンドレット (Path コマンドレット) は、パス名を操作し、すべての Windows PowerShell プロバイダーが解釈できる簡潔な形式の名前を返します。プログラムやスクリプトで、パス名の全部または一部を特定の形式で表示するために使用することを目的としています。Dirname、Normpath、Realpath、Join など、他のパス操作コマンドレットと同じように使用します。
パス コマンドレットは、FileSystem、Registry、Certificate など、いくつかのプロバイダーで使用できます。
Join-Path コマンドレットは、プロバイダーによって公開されているデータを使用するように設計されています。セッションで使用可能なプロバイダーの一覧を表示するには、「Get-PSProvider」と入力します。詳細については、「about_Providers」を参照してください。
例 1
C:\PS>join-path -path c:\win* -childpath System*
説明
-----------
このコマンドは、Join-Path を使用して、パス c:\Win* と子パス System* を結合します。Windows PowerShell のファイル システム プロバイダー FileSystem によってパスが結合され、区切り記号 \ が追加されます。
例 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 コマンドレットを使用して、FileSystem プロバイダーによってサポートされている Windows PowerShell ドライブを取得します。ForEach ステートメントは PSDriveInfo オブジェクトの Root プロパティのみを選択し、指定された子パスと結合します。
出力には、C:\Program Files ディレクトリにマッピングされたドライブがコンピューターの Windows PowerShell ドライブに含まれていたことが表示されます。
関連項目
概念
about_Providers
Test-Path
Split-Path
Resolve-Path
Convert-Path