Freigeben über


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.