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[]>
       [<CommonParameters>]
Convert-Path
       -LiteralPath <String[]>
       [<CommonParameters>]

Beschreibung

Das cmdlet Convert-Path 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, das durch einen Punkt (.) dargestellt wird, in einen Standardmäßigen FileSystem-Pfad konvertiert.

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 Wildcards interpretiert. Wenn der Pfad Escapezeichen enthält, schließen Sie ihn in einfache Anführungszeichen ein. Einfache Anführungszeichen weisen PowerShell an, keine Zeichen als Escapesequenzen zu interpretieren.

Weitere Informationen finden Sie unter about_Quoting_Rules.

Typ:String[]
Aliase:PSPath, LP
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

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

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

  • Alle Plattformen:
    • 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, Joinoder andere Pfadmanipulatoren.

Sie können die Pfad-Cmdlets mit mehreren Anbietern verwenden, einschließlich des FileSystem-, Registrierungsregistrierungs-und Zertifikatanbieter n.

Dieses Cmdlet wurde entwickelt, um mit den Daten zu arbeiten, die von einem beliebigen Anbieter verfügbar gemacht werden. Geben Sie Get-PSProviderein, um die in Ihrer Sitzung verfügbaren Anbieter auflisten zu können. 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.