Resolve-Path
パス中のワイルドカード文字を解決し、パスの内容を表示します。
構文
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 オブジェクトを渡します。 コマンドレットを使用して 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: | 1 |
Default value: | None |
Required: | True |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-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 |
入力
このコマンドレットへのパスを含む文字列をパイプ処理できます。
出力
System.Management.Automation.PathInfo, System.String
PathInfo オブジェクトを返します。 Relative パラメーターを指定した場合は、解決されたパスの文字列値を返します。
メモ
- コマンドレットは
*-Path
、FileSystem、Registry、および証明書プロバイダーと連携します。 Resolve-Path
は、任意のプロバイダーと連携するように設計されています。 セッションで使用できるプロバイダーを一覧表示するには、「」と入力しますGet-PSProvider
。 詳細については、「 about_providers」を参照してください。