Freigeben über

Convert-Path

  • Referenz
Modul:
Microsoft.PowerShell.Management

Konvertiert einen Pfad aus einem PowerShell-Pfad in einen PowerShell-Anbieterpfad.

Syntax

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

Beschreibung

Das Convert-Path Cmdlet konvertiert einen Pfad aus einem PowerShell-Pfad in einen PowerShell-Anbieterpfad.

Beispiele

Beispiel 1: Konvertieren des Arbeitsverzeichnisses in einen Standarddateisystempfad

In diesem Beispiel wird das aktuelle Arbeitsverzeichnis konvertiert, das durch einen Punkt (.) dargestellt wird, in einen Standardmäßigen FileSystem-Pfad.

PS C:\> Convert-Path .
C:\

Beispiel 2: Konvertieren eines Anbieterpfads in einen Standardregistrierungspfad

In diesem Beispiel wird der PowerShell-Anbieterpfad in einen Standardregistrierungspfad konvertiert.

PS C:\> Convert-Path HKLM:\Software\Microsoft
HKEY_LOCAL_MACHINE\Software\Microsoft

Beispiel 3: Konvertieren eines Pfads in eine Zeichenfolge

In diesem Beispiel wird der Pfad in das Startverzeichnis des aktuellen Anbieters konvertiert, bei dem es sich um den FileSystem-Anbieter handelt, in eine Zeichenfolge.

PS C:\> Convert-Path ~
C:\Users\User01

Parameter

-LiteralPath

Gibt als Zeichenfolgenarray den zu konvertierenden Pfad an. Der Wert des LiteralPath-Parameters wird genau so verwendet, wie er eingegeben wird. Es werden keine Zeichen als Platzhalter interpretiert. Wenn der Pfad Escapezeichen enthält, müssen Sie ihn in einfache Anführungszeichen einschließen. Einfache Anführungszeichen weisen PowerShell an, keine Zeichen als Escapesequenzen zu interpretieren.

Weitere Informationen finden Sie unter about_Quoting_Rules.

Typ:String[]
Aliase:PSPath
Position:Named
Standardwert:None
Erforderlich:True
Pipelineeingabe akzeptieren:True
Platzhalterzeichen akzeptieren:False

-Path

Gibt den zu konvertierenden PowerShell-Pfad an.

Typ:String[]
Position:0
Standardwert:None
Erforderlich:True
Pipelineeingabe akzeptieren:True
Platzhalterzeichen akzeptieren:True

-UseTransaction

Schließt den Befehl in die aktive Transaktion ein. Dieser Parameter ist nur gültig, wenn gerade eine Transaktion ausgeführt wird. Weitere Informationen finden Sie unter about_transactions.

Typ:SwitchParameter
Aliase:usetx
Position:Named
Standardwert:False
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

Eingaben

String

Sie können einen Pfad, aber keinen Literalpfad, an dieses Cmdlet weiterleiten.

Ausgaben

String

Dieses Cmdlet gibt eine Zeichenfolge zurück, die den konvertierten Pfad enthält.

Hinweise

Windows PowerShell enthält die folgenden Aliase für Convert-Path:

  • cvpa

Die Cmdlets, die das Path-Substantiv enthalten, bearbeiten Pfadnamen und geben die Namen in einem präzisen Format zurück, das alle PowerShell-Anbieter interpretieren können. Sie sind für die Verwendung in Programmen und Skripts vorgesehen, in denen Sie den gesamten oder einen Teil eines Pfads in einem bestimmten Format anzeigen möchten. Verwenden Sie sie wie "Dirname", "Normpath", "Realpath", "Join" oder andere Pfadmanipulationen.

Sie können die Pfad-Cmdlets mit mehreren Anbietern verwenden, einschließlich fileSystem, Registry und Zertifikatanbietern.

Dieses Cmdlet wurde entwickelt, um mit den Daten zu arbeiten, die von einem beliebigen Anbieter verfügbar gemacht werden. Geben Sie ein, um die in Ihrer Sitzung verfügbaren Anbieter auflisten zu können Get-PSProvider. Weitere Informationen finden Sie unter about_Providers.

Convert-Path konvertiert nur vorhandene Pfade. Es kann nicht verwendet werden, um einen Speicherort zu konvertieren, der noch nicht vorhanden ist.