Resolve-Path

モジュール:: Microsoft.PowerShell.Management

パス内のワイルドカード文字を解決し、パスの内容を表示します。

構文

Resolve-Path
       [-Path] <String[]>
       [-Relative]
       [-Credential <PSCredential>]
       [-UseTransaction]
       [<CommonParameters>]

Resolve-Path
       -LiteralPath <String[]>
       [-Relative]
       [-Credential <PSCredential>]
       [-UseTransaction]
       [<CommonParameters>]

説明

Resolve-Path コマンドレットは、指定された場所のワイルドカードパターンに一致する項目とコンテナーを表示します。一致には、ファイル、フォルダー、レジストリキー、または PSDrive プロバイダーからアクセス可能なその他のオブジェクトを含めることができます。

例

例 1: ホームフォルダーのパスを解決する

チルダ文字 (~) は、現在のユーザーのホームフォルダの省略形表記です。この例では、完全修飾パス値を返す Resolve-Path を示します。

PS C:\> Resolve-Path ~

Path
----
C:\Users\User01

例 2: Windows フォルダーのパスを解決する

PS C:\> Resolve-Path -Path "windows"

Path
----
C:\Windows

C: ドライブのルートから実行すると、このコマンドは C: ドライブ内の Windows フォルダのパスを返します。

例 3: Windows フォルダー内のすべてのパスを取得する

PS C:\> "C:\windows\*" | Resolve-Path

このコマンドは、C:\Windows フォルダ内のすべてのフォルダを返します。このコマンドでは、パイプライン演算子 (|) を使用してパス文字列を Resolve-Path に送信します。

例 4: UNC パスを解決する

PS C:\> Resolve-Path -Path "\\Server01\public"

このコマンドは、汎用名前付け規則 (UNC) パスを解決し、パス内の共有を返します。

例 5: 相対パスを取得する

PS C:\> Resolve-Path -Path "c:\prog*" -Relative

.\Program Files
.\Program Files (x86)
.\programs.txt

このコマンドは、C: ドライブのルートにあるディレクトリの相対パスを返します。

例 6: 角かっこを含むパスを解決する

この例では、 LiteralPath パラメーターを使用して、Test[xml] サブフォルダーのパスを解決します。 LiteralPath を使用すると、角かっこは正規表現ではなく通常の文字として扱われます。

PS C:\> Resolve-Path -LiteralPath 'test[xml]'

パラメーター

-Credential

このアクションを実行するアクセス許可を持つユーザーアカウントを指定します。既定値は現在のユーザーです。

User01 や Domain01\User01 などのユーザー名を入力するか、 PSCredential オブジェクトを渡します。コマンドレットを使用して、Get-Credential オブジェクトを作成できます。ユーザー名を入力すると、このコマンドレットによってパスワードの入力が求められます。

このパラメーターは、PowerShell でインストールされているプロバイダーではサポートされていません。

型:	PSCredential
配置:	Named
規定値:	None
必須:	False
パイプライン入力を受け取る:	True
ワイルドカード文字を受け取る:	False

-LiteralPath

解決するパスを指定します。 LiteralPath パラメーターの値は、型指定されたとおりに使用されます。ワイルドカード文字として解釈される文字はありません。パスにエスケープ文字が含まれている場合は、単一引用符で囲みます。単一引用符は、エスケープシーケンスとして文字を解釈しないように PowerShell に指示します。

型:	String[]
Aliases:	PSPath
配置:	Named
規定値:	None
必須:	True
パイプライン入力を受け取る:	True
ワイルドカード文字を受け取る:	False

-Path

解決する PowerShell パスを指定します。このパラメーターは必須です。パス文字列をパイプして Resolve-Pathすることもできます。

型:	String[]
配置:	1
規定値:	None
必須:	True
パイプライン入力を受け取る:	True
ワイルドカード文字を受け取る:	False

-Relative

このコマンドレットから相対パスが返されることを示します。

型:	SwitchParameter
配置:	Named
規定値:	None
必須:	False
パイプライン入力を受け取る:	False
ワイルドカード文字を受け取る:	False

-UseTransaction

アクティブなトランザクションにコマンドを含みます。このパラメーターは、トランザクションが進行中の場合にのみ有効です。詳細については、「about_transactions」を参照してください。

型:	SwitchParameter
Aliases:	usetx
配置:	Named
規定値:	False
必須:	False
パイプライン入力を受け取る:	False
ワイルドカード文字を受け取る:	False

入力

String

このコマンドレットへのパスを含む文字列をパイプ処理できます。

出力

System.Management.Automation.PathInfo, System.String

PathInfo オブジェクトを返します。 Relative パラメータを指定した場合に、解決されたパスの文字列値を返します。

メモ

*-Path コマンドレットは、FileSystem、Registry、および Certificate プロバイダーと連携します。
Resolve-Path は、任意のプロバイダーと連携するように設計されています。セッションで使用可能なプロバイダーを一覧表示するには、「Get-PSProvider」と入力します。詳細については、about_providersを参照してください。