Konvertiert einen Pfad aus einem Windows PowerShell-Pfad in einen Windows PowerShell-Anbieterpfad.
Syntax
Convert-Path [-LiteralPath] <string[]> [-UseTransaction] [<CommonParameters>] Convert-Path [-Path] <string[]> [-UseTransaction] [<CommonParameters>]
Beschreibung
Das Cmdlet "Convert-Path" konvertiert einen Pfad aus einem Windows PowerShell-Pfad in einen Windows PowerShell-Anbieterpfad.
Parameter
-LiteralPath <string[]>
Gibt den zu konvertierenden Pfad an. Der Wert des LiteralPath-Parameters wird genau so verwendet, wie er eingegeben wurde. 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 veranlassen Windows PowerShell, Zeichen nicht als Escapesequenzen zu interpretieren.
|
Erforderlich? |
true |
|
Position? |
1 |
|
Standardwert |
|
|
Pipelineeingaben akzeptieren? |
true (ByPropertyName) |
|
Platzhalterzeichen akzeptieren? |
false |
-Path <string[]>
Gibt den zu konvertierenden Windows PowerShell-Pfad an.
|
Erforderlich? |
true |
|
Position? |
1 |
|
Standardwert |
|
|
Pipelineeingaben akzeptieren? |
true (ByValue, ByPropertyName) |
|
Platzhalterzeichen akzeptieren? |
false |
-UseTransaction
Schließt den Befehl in die aktive Transaktion ein. Dieser Parameter ist nur gültig, wenn eine Transaktion ausgeführt wird. Weitere Informationen finden Sie unter "about_Transactions".
|
Erforderlich? |
false |
|
Position? |
named |
|
Standardwert |
|
|
Pipelineeingaben akzeptieren? |
false |
|
Platzhalterzeichen akzeptieren? |
false |
<CommonParameters>
Dieses Cmdlet unterstützt die folgenden allgemeinen Parameter: -Verbose, -Debug, -ErrorAction, -ErrorVariable, -OutBuffer und -OutVariable. Weitere Informationen finden Sie unter about_Commonparameters.
Eingaben und Ausgaben
Der Eingabetyp ist der Typ der Objekte, die über die Pipeline an das Cmdlet übergeben werden können. Der Rückgabetyp ist der Typ der Objekte, die das Cmdlet zurückgibt.
|
Eingaben |
System.String Sie können einen Pfad (jedoch keinen literalen Pfad) über die Pipeline an Convert-Path übergeben. |
|
Ausgaben |
System.String Convert-Path gibt eine Zeichenfolge zurück, die den konvertierten Pfad enthält. |
Hinweise
Die Cmdlets, die das Substantiv "Path" enthalten (die Path-Cmdlets), bearbeiten Pfadnamen und geben die Namen in einem präzisen Format zurück, das von allen Windows PowerShell-Anbietern interpretiert werden kann. Diese können in Programmen und Skripts verwendet werden, in denen ein Pfadname vollständig oder teilweise in einem bestimmten Format angezeigt werden soll. Die Verwendung entspricht der von "Dirname", "Normpath", "Realpath", "Join" und anderer Befehle zum Bearbeiten von Pfaden.
Sie können die Pfad-Cmdlets mit verschiedenen Anbietern verwenden, u. a. dem FileSystem-, Registry- und Certificate-Anbieter..
Das Cmdlet "Convert-Path" ist für die Verwendung mit Daten konzipiert, die von beliebigen Anbietern verfügbar gemacht werden. Um die in der Sitzung verfügbaren Anbieter aufzuführen, geben Sie "Get-PSProvider" ein. Weitere Informationen finden Sie unter "about_Providers".
Beispiel 1
C:\PS>convert-path ~ Beschreibung ----------- Mit diesem Befehl wird das aktuelle Arbeitsverzeichnis erweitert.
Beispiel 2
C:\PS>convert-path HKLM:\software\microsoft Beschreibung ----------- Mit diesem Befehl wird der Windows PowerShell-Anbieterpfad in einen Standardregistrierungspfad konvertiert.
Siehe auch