Resolve-Path
Löst die Wildcardzeichen in einem Pfad auf und zeigt den Pfadinhalt an.
Syntax
Path (Standard)
Resolve-Path
[-Path] <String[]>
[-Relative]
[-Credential <PSCredential>]
[-UseTransaction]
[<CommonParameters>]
LiteralPath
Resolve-Path
-LiteralPath <String[]>
[-Relative]
[-Credential <PSCredential>]
[-UseTransaction]
[<CommonParameters>]
Beschreibung
Das Cmdlet Resolve-Path zeigt die Elemente und Container an, die mit dem Wildcardmuster an der angegebenen Position übereinstimmen. Die Übereinstimmung kann Dateien, Ordner, Registrierungsschlüssel oder ein anderes Objekt enthalten, auf das von einem PSDrive--Anbieter zugegriffen werden kann.
Beispiele
Beispiel 1: Auflösen des Pfads des Startordners
Das Tildezeichen (~) ist eine Kurznotation für den Startordner des aktuellen Benutzers. In diesem Beispiel wird gezeigt, Resolve-Path den vollqualifizierten Pfadwert zurückgeben.
Resolve-Path ~
Path
----
C:\Users\User01
Beispiel 2: Auflösen des Pfads des Windows-Ordners
Resolve-Path -Path "windows"
Path
----
C:\Windows
Wenn dieser Befehl vom Stammverzeichnis des C: Laufwerks ausgeführt wird, gibt dieser Befehl den Pfad des ordners Windows auf dem laufwerk C: zurück.
Beispiel 3: Abrufen aller Pfade im Windows-Ordner
"C:\windows\*" | Resolve-Path
Dieser Befehl gibt alle Dateien und Ordner im ordner C:\Windows zurück. Der Befehl verwendet einen Pipelineoperator (|), um eine Pfadzeichenfolge an Resolve-Pathzu senden.
Beispiel 4: Auflösen eines UNC-Pfads
Resolve-Path -Path "\\Server01\public"
Dieser Befehl löst einen UNC-Pfad (Universal Naming Convention) auf und gibt die Freigaben im Pfad zurück.
Beispiel 5: Abrufen relativer Pfade
Resolve-Path -Path "C:\prog*" -Relative
.\Program Files
.\Program Files (x86)
.\programs.txt
Dieser Befehl gibt relative Pfade für die Verzeichnisse im Stammverzeichnis des laufwerks C: zurück.
Beispiel 6: Auflösen eines Pfads mit eckigen Klammern
In diesem Beispiel wird der LiteralPath Parameter verwendet, um den Pfad des unterordners Test[xml] aufzulösen.
Wenn LiteralPath verwendet wird, werden die Klammern nicht als regulärer Ausdruck, sondern als normale Zeichen behandelt.
Resolve-Path -LiteralPath 'test[xml]'
Parameter
-Credential
Gibt ein Benutzerkonto an, das über die Berechtigung zum Ausführen dieser Aktion verfügt. Die Standardeinstellung ist der aktuelle Benutzer.
Geben Sie einen Benutzernamen ein, z. B. User01 oder Domain01\User01, oder übergeben Sie ein PSCredential--Objekt. Sie können ein PSCredential--Objekt mithilfe des cmdlets Get-Credential erstellen. Wenn Sie einen Benutzernamen eingeben, werden Sie von diesem Cmdlet aufgefordert, ein Kennwort einzugeben.
Dieser Parameter wird von anbietern, die mit PowerShell installiert sind, nicht unterstützt.
Parametereigenschaften
| Typ: | PSCredential |
| Standardwert: | None |
| Unterstützt Platzhalter: | False |
| Nicht anzeigen: | False |
Parametersätze
(All)
| Position: | Named |
| Obligatorisch: | False |
| Wert aus Pipeline: | False |
| Wert aus Pipeline nach dem Eigenschaftsnamen: | True |
| Wert aus verbleibenden Argumenten: | False |
-LiteralPath
Gibt den Pfad an, der aufgelöst werden soll. Der Wert des LiteralPath--Parameters wird genau wie eingegeben verwendet. Es werden keine Zeichen als Wildcardzeichen interpretiert. Wenn der Pfad Escapezeichen enthält, schließen Sie ihn in einfache Anführungszeichen (') ein. 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 |
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 auflösenden PowerShell-Pfad an. Dieser Parameter ist erforderlich. Sie können auch eine Pfadzeichenfolge an Resolve-Pathübergeben. Platzhalterzeichen sind zulässig.
Parametereigenschaften
| Typ: | String[] |
| Standardwert: | None |
| Unterstützt Platzhalter: | True |
| 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 |
-Relative
Gibt an, dass dieses Cmdlet einen relativen Pfad zurückgibt.
Parametereigenschaften
| Typ: | SwitchParameter |
| Standardwert: | None |
| Unterstützt Platzhalter: | False |
| Nicht anzeigen: | False |
Parametersätze
(All)
| Position: | Named |
| Obligatorisch: | False |
| Wert aus Pipeline: | False |
| Wert aus Pipeline nach dem Eigenschaftsnamen: | False |
| 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 eine Zeichenfolge weiterleiten, die einen Pfad zu diesem Cmdlet enthält.
Ausgaben
PathInfo
Standardmäßig gibt dieses Cmdlet ein PathInfo-objekt zurück.
String
Wenn Sie den Parameter Relative angeben, gibt dieses Cmdlet einen Zeichenfolgenwert für den aufgelösten Pfad zurück.
Hinweise
Windows PowerShell enthält die folgenden Aliase für Resolve-Path:
rvpa
Die *-Path-Cmdlets arbeiten mit den FileSystem-, Registrierungs-und Zertifikatanbietern zusammen.
Resolve-Path ist für die Zusammenarbeit mit jedem Anbieter konzipiert. Geben Sie Get-PSProviderein, um die in Ihrer Sitzung verfügbaren Anbieter auflisten zu können. Weitere Informationen finden Sie unter über_Anbieter.
Resolve-Path löst nur vorhandene Pfade auf. Es kann nicht verwendet werden, um einen Speicherort aufzulösen, der noch nicht vorhanden ist.