Convert-Path
Konvertiert einen Pfad aus einem PowerShell-Pfad in einen PowerShell-Anbieterpfad.
Syntax
Path (Standard)
Convert-Path
[-Path] <String[]>
[<CommonParameters>]
LiteralPath
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, müssen Sie ihn in einfache Anführungszeichen einschließen. Einfache Anführungszeichen signalisieren PowerShell, dass keine Zeichen als Escapesequenzen interpretiert werden sollen.
Parametereigenschaften
| Typ: | String[] |
| Standardwert: | None |
| Unterstützt Platzhalter: | False |
| Nicht anzeigen: | False |
| Aliase: | PSPath, EP |
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 zu konvertierenden PowerShell-Pfad an.
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 |
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 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 Pfadnamens 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, 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 über_Anbieter.
Convert-Path konvertiert nur vorhandene Pfade. Es kann nicht verwendet werden, um einen Standort zu konvertieren, der noch nicht existiert.