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 。

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

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

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

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

Type:PSCredential
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-LiteralPath

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

Type:String[]
Aliases:PSPath
Position:Named
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-Path

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

Type:String[]
Position:0
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:True

-Relative

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

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-UseTransaction

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

Type:SwitchParameter
Aliases:usetx
Position:Named
Default value:False
Required:False
Accept pipeline input:False
Accept wildcard characters:False

入力

String

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

出力

PathInfo

既定では、このコマンドレットは PathInfo オブジェクトを返します。

String

Relative パラメーターを指定すると、このコマンドレットは解決されたパスの文字列値を返します。

メモ

Windows PowerShell には、次のエイリアスが Resolve-Path含まれています。

  • rvpa

コマンドレットは*-Path、FileSystem、Registry、および証明書プロバイダーと連携します。

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

Resolve-Path は既存のパスのみを解決します。 まだ存在しない場所を解決するために使用することはできません。