次の方法で共有

Convert-Path

モジュール:
Microsoft.PowerShell.Management Module

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

構文

Path (既定) 

Convert-Path
    [-Path] <String[]>
    [<CommonParameters>]

LiteralPath 

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 フォルダーが非表示になっていることを確認します。 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
規定値:False
ワイルドカードのサポート:False
DontShow:False

パラメーター セット

(All)
配置:Named
必須:False
パイプラインからの値:False
プロパティ名別のパイプラインからの値:False
残りの引数からの値:False

-LiteralPath

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

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

パラメーターのプロパティ

型:

String[]

規定値:None
ワイルドカードのサポート:False
DontShow:False
Aliases:PSPath, LP

パラメーター セット

LiteralPath
配置:Named
必須:True
パイプラインからの値:False
プロパティ名別のパイプラインからの値:True
残りの引数からの値:False

-Path

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

パラメーターのプロパティ

型:

String[]

規定値:None
ワイルドカードのサポート:True
DontShow:False

パラメーター セット

Path
配置:0
必須:True
パイプラインからの値:True
プロパティ名別のパイプラインからの値:True
残りの引数からの値:False

CommonParameters

このコマンドレットでは、一般的なパラメーター -Debug、-ErrorAction、-ErrorVariable、-InformationAction、-InformationVariable、-OutBuffer、-OutVariable、-PipelineVariable、-ProgressAction、-Verbose、-WarningAction、-WarningVariable の各パラメーターがサポートされています。 詳細については、about_CommonParametersを参照してください。

入力

String

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

出力

String

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

メモ

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

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

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

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

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

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