Freigeben über

Resolve-Path

Modul:
Microsoft.PowerShell.Management Module

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 andere Objekte enthalten, auf die über einen PSDrive-Anbieter zugegriffen werden kann.

Beispiele

Beispiel 1: Auflösen des Pfads des Startordners

Das Tildezeichen (~) ist die Kurzschreibweise für den Benutzerordner des aktuellen Benutzers. In diesem Beispiel wird gezeigt, Resolve-Path den vollqualifizierten Pfadwert zurückgeben.

PS C:\> Resolve-Path ~

Path
----
C:\Users\User01

Beispiel 2: Auflösen des Pfads des Windows-Ordners

PS C:\> Resolve-Path -Path "windows"

Path
----
C:\Windows

Wenn dieser Befehl aus dem Stammverzeichnis des Laufwerks C: ausgeführt wird, gibt er den Pfad des Windows-Ordners auf Laufwerk C: zurück.

Beispiel 3: Abrufen aller Pfade im Windows-Ordner

PS C:\> "C:\windows\*" | Resolve-Path

Dieser Befehl gibt alle 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

PS C:\> 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

PS C:\> 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.

PS C:\> 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, 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

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.

Parametereigenschaften

Typ:

String[]

Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False

Parametersätze

Path
Position:1
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

System.Management.Automation.PathInfo, System.String

Gibt ein PathInfo-Objekt zurück. Gibt einen Zeichenfolgenwert für den aufgelösten Pfad zurück, wenn Sie den Parameter Relative angeben.

Hinweise

  • Die *-Path Cmdlets funktionieren mit den Anbietern FileSystem, Registry und Certificate.
  • 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 about_providers.