Convert-Path

  • リファレンス
モジュール:
Microsoft.PowerShell.Management

パスを PowerShell パスから PowerShell プロバイダー パスに変換します。

構文

Convert-Path
       [-Path] <String[]>
       [-UseTransaction]
       [<CommonParameters>]
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 に指示します。

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

-Path

変換する PowerShell パスを指定します。

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

-UseTransaction

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

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

入力

String

このコマンドレットには、リテラル パスではなくパスをパイプできます。

出力

String

このコマンドレットは、変換されたパスを含む文字列を返します。

メモ

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

  • cvpa

Path 名詞を含むコマンドレットは、パス名を操作し、すべての PowerShell プロバイダーが解釈できる簡潔な形式で名前を返します。 プログラムやスクリプトで、パス名の全部または一部を特定の形式で表示するために使用することを目的としています。 Dirname、Normpath、Realpath、Join、またはその他のパス マニピュレータを使用する場合と同じように使用します。

パス コマンドレットは、FileSystem、Registry、Certificate など、いくつかのプロバイダーで使用できます。

このコマンドレットは、任意のプロバイダーによって公開されるデータを操作するように設計されています。 セッションで使用できるプロバイダーを一覧表示するには、「」と入力します Get-PSProvider。 詳細については、「about_Providers」を参照してください。

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