Convert-Path
パスを PowerShell パスから PowerShell プロバイダー パスに変換します。
構文
Path (既定)
Convert-Path
[-Path] <String[]>
[-UseTransaction]
[<CommonParameters>]
LiteralPath
Convert-Path
-LiteralPath <String[]>
[-UseTransaction]
[<CommonParameters>]
説明
Convert-Path コマンドレットは、PowerShell パスから PowerShell プロバイダー パスにパスを変換します。
例
例 1: 作業ディレクトリーを標準ファイル・システム・パスに変換する
次の使用例は、ドット (.) で表される現在の作業ディレクトリを標準の FileSystem パスに変換します。
PS C:\> Convert-Path .
C:\
例 2: プロバイダー パスを標準レジストリ パスに変換する
この例では、PowerShell プロバイダーのパスを標準レジストリ パスに変換します。
PS C:\> Convert-Path HKLM:\Software\Microsoft
HKEY_LOCAL_MACHINE\Software\Microsoft
例 3: パスを文字列に変換する
次の使用例は、FileSystem プロバイダーである現在のプロバイダーのホーム ディレクトリへのパスを文字列に変換します。
PS C:\> Convert-Path ~
C:\Users\User01
パラメーター
-LiteralPath
変換するパスを文字列配列として指定します。 LiteralPath パラメーターの値は、入力されたとおりに正確に使用されます。 ワイルドカードとして解釈される文字はありません。 パスにエスケープ文字が含まれている場合は、単一引用符で囲みます。 単一引用符は、エスケープ シーケンスとして文字を解釈しないように PowerShell に指示します。
詳細については、about_Quoting_Rulesを参照してください。
パラメーターのプロパティ
| 型: | String[] |
| 規定値: | None |
| ワイルドカードのサポート: | False |
| DontShow: | False |
| Aliases: | PSPath |
パラメーター セット
LiteralPath
| 配置: | Named |
| 必須: | True |
| パイプラインからの値: | False |
| プロパティ名別のパイプラインからの値: | True |
| 残りの引数からの値: | False |
-Path
変換する PowerShell パスを指定します。
パラメーターのプロパティ
| 型: | String[] |
| 規定値: | None |
| ワイルドカードのサポート: | True |
| DontShow: | False |
パラメーター セット
Path
| 配置: | 0 |
| 必須: | True |
| パイプラインからの値: | True |
| プロパティ名別のパイプラインからの値: | True |
| 残りの引数からの値: | 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
このコマンドレットは、変換されたパスを含む文字列を返します。
メモ
Windows PowerShell には、Convert-Pathの次のエイリアスが含まれています。
cvpa
Path 名詞を含むコマンドレットは、パス名を操作し、すべての PowerShell プロバイダーが解釈できる簡潔な形式で名前を返します。 これらは、パスのすべてまたは一部を特定の形式で表示するプログラムやスクリプトで使用するように設計されています。 Dirname、Normpath、Realpath、Join、またはその他のパス マニピュレーターを使用する場合と同様に使用します。
パス コマンドレットは、
このコマンドレットは、任意のプロバイダーによって公開されるデータを操作するように設計されています。 セッションで使用可能なプロバイダーを一覧表示するには、「Get-PSProvider」と入力します。 詳細については、about_Providersを参照してください。
Convert-Path は、既存のパスのみを変換します。 まだ存在しない場所を変換するために使用することはできません。
