Löst die Platzhalterzeichen in einem Pfad auf und zeigt den Inhalt des Pfads an.
Syntax
Resolve-Path [-LiteralPath] <string[]> [-Credential <PSCredential>] [-Relative] [-UseTransaction] [<CommonParameters>] Resolve-Path [-Path] <string[]> [-Credential <PSCredential>] [-Relative] [-UseTransaction] [<CommonParameters>]
Beschreibung
Das Cmdlet "Resolve-Path" interpretiert die Platzhalterzeichen in einem Pfad und zeigt die Elemente und Container am durch den Pfad angegebenen Speicherort an, z. B. die Dateien und Ordner oder die Registrierungsschlüssel und -unterschlüssel.
Parameter
-Credential <PSCredential>
Gibt ein Benutzerkonto an, das über die Berechtigung zum Ausführen dieser Aktion verfügt. Der Standardwert ist der aktuelle Benutzer.
Geben Sie einen Benutzernamen ein, z. B. "User01" oder "Domain01\User01". Oder geben Sie ein PSCredential-Objekt ein, z. B. ein vom Cmdlet "Get-Credential" generiertes Objekt. Wenn Sie einen Benutzernamen eingeben, werden Sie zur Eingabe eines Kennworts aufgefordert.
Dieser Parameter wird nicht von mit Windows PowerShell installierten Anbietern unterstützt.
|
Erforderlich? |
false |
|
Position? |
named |
|
Standardwert |
|
|
Pipelineeingaben akzeptieren? |
true (ByPropertyName) |
|
Platzhalterzeichen akzeptieren? |
false |
-LiteralPath <string[]>
Gibt den aufzulösenden Pfad an. Der Wert von "LiteralPath" 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 aufzulösenden Windows PowerShell-Pfad an. Dieser Parameter ist erforderlich. Sie können eine Pfadzeichenfolge auch über die Pipeline an Resolve-Path übergeben.
|
Erforderlich? |
true |
|
Position? |
1 |
|
Standardwert |
|
|
Pipelineeingaben akzeptieren? |
true (ByValue, ByPropertyName) |
|
Platzhalterzeichen akzeptieren? |
false |
-Relative
Gibt einen relativen Pfad zurück.
|
Erforderlich? |
false |
|
Position? |
named |
|
Standardwert |
|
|
Pipelineeingaben akzeptieren? |
false |
|
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 eine Zeichenfolge mit einem Pfad über die Pipeline an Resolve-Path übergeben. |
|
Ausgaben |
System.String Resolve-Path gibt eine Zeichenfolge zurück, die den aufgelösten 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 "Resolve-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>resolve-path ~ C:\Users\User01 Beschreibung ----------- Mit diesem Befehl wird der durch die Tilde (~) dargestellte Pfad aufgelöst, der dem Basisverzeichnis entspricht.
Beispiel 2
C:\PS>resolve-path windows C:\Windows Beschreibung ----------- Wenn der Befehl im Stammverzeichnis von Laufwerk "C:" ausgeführt wird, gibt er den Pfad zum Verzeichnis "Windows" auf Laufwerk "C:" zurück.
Beispiel 3
C:\PS>"C:\windows\*" | resolve-path Beschreibung ----------- Dieser Befehl gibt alle Verzeichnisse im Verzeichnis "C:\Windows" zurück. In diesem Befehl wird eine Pfadzeichenfolge unter Verwendung eines Pipelineoperators (|) an Resolve-Path gesendet.
Beispiel 4
C:\PS>resolve-path \\Server01\public Beschreibung ----------- Dieser Befehl löst einen UNC-Pfad (Universal Naming Convention) auf und gibt die Freigaben im Pfad zurück.
Beispiel 5
C:\PS>resolve-path c:\prog* -relative ..\Program Files ..\Program Files (x86) ..\programs.txt Beschreibung ----------- Dieser Befehl gibt relative Pfade für die Verzeichnisse im Stammverzeichnis von Laufwerk "C:" zurück.
Beispiel 6
C:\PS>resolve-path -literalPath test[xml] Beschreibung ----------- Dieser Befehl löst den Pfad zum Unterverzeichnis "Test[xml]" des aktuellen Verzeichnisses auf. Mit dem LiteralPath-Parameter wird angegeben, dass die eckigen Klammern keine Zeichen für reguläre Ausdrücke sind.
Siehe auch