Resolve-Path
パス内のワイルドカード文字を解決し、パスの内容を表示します。
構文
Path (既定)
Resolve-Path
[-Path] <String[]>
[-Relative]
[-Credential <PSCredential>]
[-UseTransaction]
[<CommonParameters>]
LiteralPath
Resolve-Path
-LiteralPath <String[]>
[-Relative]
[-Credential <PSCredential>]
[-UseTransaction]
[<CommonParameters>]
説明
Resolve-Path コマンドレットは、指定された場所のワイルドカード パターンに一致する項目とコンテナーを表示します。 一致には、ファイル、フォルダー、レジストリ キー、PSDrive プロバイダーからアクセスできるその他のオブジェクトを含めることができます。
例
例 1: ホーム フォルダーのパスを解決する
チルダ文字 (~) は、現在のユーザーのホーム フォルダーの短縮表記です。 この例では、完全修飾パス値を返す Resolve-Path を示します。
Resolve-Path ~
Path
----
C:\Users\User01
例 2: Windows フォルダーのパスを解決する
Resolve-Path -Path "windows"
Path
----
C:\Windows
C: ドライブのルートから実行すると、このコマンドは、Windows ドライブ内の C: フォルダーのパスを返します。
例 3: Windows フォルダー内のすべてのパスを取得する
"C:\windows\*" | Resolve-Path
このコマンドは、C:\Windows フォルダー内のすべてのファイルとフォルダーを返します。 このコマンドでは、パイプライン演算子 (|) を使用して、パス文字列を Resolve-Pathに送信します。
例 4: UNC パスを解決する
Resolve-Path -Path "\\Server01\public"
このコマンドは、汎用名前付け規則 (UNC) パスを解決し、パス内の共有を返します。
例 5: 相対パスを取得する
Resolve-Path -Path "C:\prog*" -Relative
.\Program Files
.\Program Files (x86)
.\programs.txt
このコマンドは、C: ドライブのルートにあるディレクトリの相対パスを返します。
例 6: 角かっこを含むパスを解決する
この例では、LiteralPath パラメーターを使用して、Test[xml] サブフォルダーのパスを解決します。
LiteralPath を使用すると、角かっこは正規表現ではなく通常の文字として扱われます。
Resolve-Path -LiteralPath 'test[xml]'
パラメーター
-Credential
このアクションを実行するアクセス許可を持つユーザー アカウントを指定します。 既定値は現在のユーザーです。
User01 や Domain01\User01などのユーザー名を入力するか、PSCredential オブジェクトを渡します。
コマンドレットを使用して、Get-Credential オブジェクトを作成できます。 ユーザー名を入力すると、このコマンドレットによってパスワードの入力が求められます。
このパラメーターは、PowerShell でインストールされているプロバイダーではサポートされていません。
パラメーターのプロパティ
| 型: | PSCredential |
| 規定値: | None |
| ワイルドカードのサポート: | False |
| DontShow: | False |
パラメーター セット
(All)
| 配置: | Named |
| 必須: | False |
| パイプラインからの値: | False |
| プロパティ名別のパイプラインからの値: | True |
| 残りの引数からの値: | False |
-LiteralPath
解決するパスを指定します。
LiteralPath パラメーターの値は、型指定されたとおりに使用されます。 ワイルドカード文字として解釈される文字はありません。 パスにエスケープ文字が含まれている場合は、単一引用符 (') で囲みます。 単一引用符は、エスケープ シーケンスとして文字を解釈しないように PowerShell に指示します。
パラメーターのプロパティ
| 型: | String[] |
| 規定値: | None |
| ワイルドカードのサポート: | False |
| DontShow: | False |
| Aliases: | PSPath |
パラメーター セット
LiteralPath
| 配置: | Named |
| 必須: | True |
| パイプラインからの値: | False |
| プロパティ名別のパイプラインからの値: | True |
| 残りの引数からの値: | False |
-Path
解決する PowerShell パスを指定します。 このパラメーターは必須です。 パス文字列をパイプして Resolve-Pathすることもできます。 ワイルドカード文字を使用できます。
パラメーターのプロパティ
| 型: | String[] |
| 規定値: | None |
| ワイルドカードのサポート: | True |
| DontShow: | False |
パラメーター セット
Path
| 配置: | 0 |
| 必須: | True |
| パイプラインからの値: | True |
| プロパティ名別のパイプラインからの値: | True |
| 残りの引数からの値: | False |
-Relative
このコマンドレットから相対パスが返されることを示します。
パラメーターのプロパティ
| 型: | 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
このコマンドレットへのパスを含む文字列をパイプ処理できます。
出力
PathInfo
既定では、このコマンドレットは PathInfo オブジェクトを返します。
String
Relative パラメーターを指定した場合、このコマンドレットは解決されたパスの文字列値を返します。
メモ
Windows PowerShell には、Resolve-Pathの次のエイリアスが含まれています。
rvpa
*-Path コマンドレットは、FileSystem、Registry、および証明書 プロバイダー 使用できます。
Resolve-Path は、任意のプロバイダーと連携するように設計されています。 セッションで使用可能なプロバイダーを一覧表示するには、「Get-PSProvider」と入力します。 詳細については、about_Providersを参照してください。
Resolve-Path は既存のパスのみを解決します。 まだ存在しない場所を解決するために使用することはできません。
