Join-Path
パスと子パスを 1 つのパスに結合します。
構文
Default (既定)
Join-Path
[-Path] <String[]>
[-ChildPath] <String>
[-Resolve]
[-Credential <PSCredential>]
[-UseTransaction]
[<CommonParameters>]
説明
Join-Path コマンドレットは、パスと子パスを 1 つのパスに結合します。
プロバイダーはパス区切り記号を提供します。
例
例 1: パスと子パスを結合する
Join-Path -Path "path" -ChildPath "childpath"
path\childpath
このコマンドでは、Join-Path を使用してパスと子パスを組み合わせます。
コマンドは FileSystem プロバイダーから実行されるため、パスを結合するための \ 区切り記号が提供されます。
例 2: ディレクトリ区切り記号が既に含まれているパスを結合する
Join-Path -Path "path\" -ChildPath "\childpath"
path\childpath
既存のディレクトリ区切り記号 \ は処理されるため、Path と ChildPathの間には区切り記号が 1 つだけあります。
例 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
このコマンドは、HKLM\Systemを含む ControlSet レジストリ サブキーにレジストリ キーを表示します。
Resolve パラメーターは、現在のプロバイダー パスのワイルドカードを含め、結合されたパスの解決を試みます HKLM:\
例 5: 複数のパス ルートを子パスと結合する
Join-Path -Path C:, D:, E:, F: -ChildPath New
C:\New
D:\New
E:\New
F:\New
このコマンドでは、Join-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 オブジェクトの ルート プロパティのみを選択し、指定された子パスと結合します。
出力は、コンピューター上の PowerShell ドライブに、C:\Program Files ディレクトリにマップされたドライブが含まれていることを示しています。
パラメーター
-ChildPath
Path パラメーターの値に追加する要素を指定します。 ワイルドカードを使用できます。
ChildPath パラメーターは必須ですが、パラメーター名 ("ChildPath") は省略可能です。
パラメーターのプロパティ
| 型: | String |
| 規定値: | None |
| ワイルドカードのサポート: | True |
| DontShow: | False |
パラメーター セット
(All)
| 配置: | 1 |
| 必須: | True |
| パイプラインからの値: | False |
| プロパティ名別のパイプラインからの値: | True |
| 残りの引数からの値: | False |
-Credential
手記
このパラメーターは、PowerShell でインストールされているプロバイダーではサポートされていません。 別のユーザーを偽装したり、このコマンドレットの実行時に資格情報を昇格したりするには、Invoke-Commandを使用します。
パラメーターのプロパティ
| 型: | PSCredential |
| 規定値: | None |
| ワイルドカードのサポート: | False |
| DontShow: | False |
パラメーター セット
(All)
| 配置: | Named |
| 必須: | False |
| パイプラインからの値: | False |
| プロパティ名別のパイプラインからの値: | True |
| 残りの引数からの値: | False |
-Path
子パスを追加するメイン パス (またはパス) を指定します。 パス の値によって、パスに結合するプロバイダーとパス区切り記号を追加するプロバイダーが決まります。 ワイルドカードを使用できます。
パラメーターのプロパティ
| 型: | String[] |
| 規定値: | None |
| ワイルドカードのサポート: | True |
| DontShow: | False |
| Aliases: | PSPath |
パラメーター セット
(All)
| 配置: | 0 |
| 必須: | True |
| パイプラインからの値: | True |
| プロパティ名別のパイプラインからの値: | True |
| 残りの引数からの値: | False |
-Resolve
このコマンドレットが、現在のプロバイダーからの参加済みパスの解決を試みる必要があることを示します。
- ワイルドカードを使用すると、コマンドレットは結合されたパスと一致するすべてのパスを返します。
- ワイルドカードを使用しない場合、パスが存在しない場合、コマンドレットはエラーを返します。
パラメーターのプロパティ
| 型: | SwitchParameter |
| 規定値: | None |
| ワイルドカードのサポート: | False |
| DontShow: | False |
パラメーター セット
(All)
| 配置: | Named |
| 必須: | False |
| パイプラインからの値: | False |
| プロパティ名別のパイプラインからの値: | False |
| 残りの引数からの値: | False |
-UseTransaction
アクティブなトランザクションにコマンドを含みます。 このパラメーターは、トランザクションが進行中の場合にのみ有効です。 詳細については、about_Transactionsを参照してください。
パラメーターのプロパティ
| 型: | SwitchParameter |
| 規定値: | False |
| ワイルドカードのサポート: | False |
| DontShow: | False |
| Aliases: | usetx |
パラメーター セット
(All)
| 配置: | Named |
| 必須: | False |
| パイプラインからの値: | False |
| プロパティ名別のパイプラインからの値: | False |
| 残りの引数からの値: | False |
CommonParameters
このコマンドレットでは、一般的なパラメーター -Debug、-ErrorAction、-ErrorVariable、-InformationAction、-InformationVariable、-OutBuffer、-OutVariable、-PipelineVariable、-ProgressAction、-Verbose、-WarningAction、-WarningVariable の各パラメーターがサポートされています。 詳細については、about_CommonParametersを参照してください。
入力
String
このコマンドレットへのパスを含む文字列をパイプ処理できます。
出力
String
このコマンドレットは、結果のパスを含む文字列を返します。
メモ
Path 名詞を含むコマンドレットは、パス名を操作し、すべての PowerShell プロバイダーが解釈できる簡潔な形式で名前を返します。 これらは、パスのすべてまたは一部を特定の形式で表示する場所で使用するように設計されています。
Dirname、Normpath、Realpath、Join、その他のパス マニピュレーターを使用する場合と同様に使用します。
パス コマンドレットは、FileSystem、Registry、Certificate プロバイダーなど、複数のプロバイダーで使用できます。
このコマンドレットは、任意のプロバイダーによって公開されるデータを操作するように設計されています。 セッションで使用可能なプロバイダーを一覧表示するには、「Get-PSProvider」と入力します。 詳細については、about_Providersを参照してください。
