次の方法で共有

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

例 4: 非表示の項目のパスを変換する

既定では、 Convert-Path は非表示のアイテムを返しません。 この例では、 Force パラメーターを使用して非表示のアイテムを検索します。 Get-Item コマンドは、.git フォルダーが非表示になっていることを確認します。 Force パラメーターなしでConvert-Pathを使用すると、表示される項目のみが返されます。 Force パラメーターを追加すると、非表示のアイテムを含むすべての項目が返されます。

PS> Get-Item .git -Force

    Directory: D:\Git\PS-Docs\PowerShell-Docs

Mode                 LastWriteTime         Length Name
----                 -------------         ------ ----
d--h-           9/25/2024  4:46 PM                .git

PS> Convert-Path .git*
D:\Git\PS-Docs\PowerShell-Docs\.github
D:\Git\PS-Docs\PowerShell-Docs\.gitattributes
D:\Git\PS-Docs\PowerShell-Docs\.gitignore

PS> Convert-Path .git* -Force
D:\Git\PS-Docs\PowerShell-Docs\.git
D:\Git\PS-Docs\PowerShell-Docs\.github
D:\Git\PS-Docs\PowerShell-Docs\.gitattributes
D:\Git\PS-Docs\PowerShell-Docs\.gitignore

パラメーター

-Force

非表示ファイルやシステム ファイルなど、ユーザーがアクセスできない項目をコマンドレットが取得できるようにします。 Force パラメーターは、セキュリティ制限をオーバーライドしません。 実装はプロバイダーごとに異なります。 詳細については、「 about_Providers」を参照してください。

このパラメーターは、PowerShell 7.5-preview.5 で追加されました。

型:SwitchParameter
配置:Named
規定値:False
必須:False
パイプライン入力を受け取る:False
ワイルドカード文字を受け取る:False

-LiteralPath

変換するパスを文字列配列として指定します。 LiteralPath パラメーターの値は、型指定されたとおりに使用されます。 ワイルドカードとして解釈される文字はありません。 パスにエスケープ文字が含まれている場合は、単一引用符で囲みます。 単一引用符は、エスケープ シーケンスとして文字を解釈しないように PowerShell に指示します。

詳細については、「 about_Quoting_Rules」を参照してください。

型:String[]
Aliases:PSPath, LP
配置:Named
規定値:None
必須:True
パイプライン入力を受け取る:True
ワイルドカード文字を受け取る:False

-Path

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

型:String[]
配置:0
規定値:None
必須:True
パイプライン入力を受け取る:True
ワイルドカード文字を受け取る:True

入力

String

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

出力

String

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

メモ

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

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

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

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

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

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