Convert-Path

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

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

構文

Convert-Path
       [-Path] <String[]>
       [<CommonParameters>]
Convert-Path
       -LiteralPath <String[]>
       [<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」を参照してください。

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

-Path

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

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

入力

String

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

出力

String

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

メモ

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

  • すべてのプラットフォーム:
    • cvpa

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

パス コマンドレットは、FileSystem、レジストリ、証明書プロバイダーなど、複数のプロバイダーで使用できます。

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

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