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