Freigeben über

Convert-Path

Modul:
Microsoft.PowerShell.Management Module

Konvertiert einen Pfad von einem Windows PowerShell-Pfad in einen Windows PowerShell-Anbieterpfad.

Syntax

Path (Standard) 

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

LiteralPath 

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

Beschreibung

Mit dem Cmdlet Convert-Path wird ein Pfad von einem Windows PowerShell-Pfad in einen Windows PowerShell-Anbieterpfad konvertiert.

Beispiele

Beispiel 1: Konvertieren des Arbeitsverzeichnisses in einen Standarddateisystempfad

PS C:\> Convert-Path .

Dieser Befehl konvertiert das aktuelle Arbeitsverzeichnis, das durch einen Punkt (.) dargestellt wird, in einen Standard-Dateisystempfad.

Beispiel 2: Konvertieren eines Anbieterpfads in einen Standardregistrierungspfad

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

Mit diesem Befehl wird der Windows PowerShell-Anbieterpfad in einen Standardregistrierungspfad konvertiert.

Beispiel 3: Konvertieren eines Pfads in eine Zeichenfolge

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

Mit diesem Befehl wird der Pfad zum Basisverzeichnis des aktuellen Providers, bei dem es sich um den FileSystem-Provider handelt, in eine Zeichenfolge konvertiert.

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, müssen Sie ihn in einfache Anführungszeichen einschließen. Einfache Anführungszeichen weisen Windows PowerShell an, keine Zeichen als Escapesequenzen zu interpretieren.

Parametereigenschaften

Typ:

String[]

Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False
Aliase:PSPath

Parametersätze

LiteralPath
Position:Named
Obligatorisch:True
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:True
Wert aus verbleibenden Argumenten:False

-Path

Gibt den Windows PowerShell-Pfad an, der konvertiert werden soll.

Parametereigenschaften

Typ:

String[]

Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False

Parametersätze

Path
Position:0
Obligatorisch:True
Wert aus Pipeline:True
Wert aus Pipeline nach dem Eigenschaftsnamen:True
Wert aus verbleibenden Argumenten:False

-UseTransaction

Enthält den Befehl in der aktiven Transaktion. Dieser Parameter ist nur gültig, wenn eine Transaktion ausgeführt wird. Weitere Informationen finden Sie unter about_Transactions.

Parametereigenschaften

Typ:SwitchParameter
Standardwert:False
Unterstützt Platzhalter:False
Nicht anzeigen:False
Aliase:usetx

Parametersätze

(All)
Position:Named
Obligatorisch:False
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten:False

CommonParameters

Dieses Cmdlet unterstützt die allgemeinen Parameter -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction und -WarningVariable. Weitere Informationen findest du unter about_CommonParameters.

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

  • Die Cmdlets, die das Substantiv "Pfad" enthalten, bearbeiten Pfadnamen und geben die Namen in einem prägnanten Format zurück, das von allen Windows PowerShell-Anbietern interpretiert werden kann. Sie sind für die Verwendung in Programmen und Skripts vorgesehen, in denen Sie den Gesamten oder Einen Teil eines Pfadnamens in einem bestimmten Format anzeigen möchten. Verwenden Sie sie wie Dirname, Normpath, Realpath, Join oder andere Pfadmanipulatoren.

    Sie können die Pfad-Cmdlets mit mehreren Anbietern verwenden, z. B. mit den Anbietern "Dateisystem", "Registrierung" und "Zertifikat".

    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.