Freigeben über

Split-Path

  • Referenz
Modul:
Microsoft.PowerShell.Management

Gibt den angegebenen Teil eines Pfads zurück.

Syntax

Split-Path
     [-Path] <String[]>
     [-Parent]
     [-Resolve]
     [-Credential <PSCredential>]
     [-UseTransaction]
     [<CommonParameters>]
Split-Path
     [-Path] <String[]>
     [-NoQualifier]
     [-Resolve]
     [-Credential <PSCredential>]
     [-UseTransaction]
     [<CommonParameters>]
Split-Path
     [-Path] <String[]>
     [-Leaf]
     [-Resolve]
     [-Credential <PSCredential>]
     [-UseTransaction]
     [<CommonParameters>]
Split-Path
     [-Path] <String[]>
     [-Qualifier]
     [-Resolve]
     [-Credential <PSCredential>]
     [-UseTransaction]
     [<CommonParameters>]
Split-Path
     [-Path] <String[]>
     [-Resolve]
     [-IsAbsolute]
     [-Credential <PSCredential>]
     [-UseTransaction]
     [<CommonParameters>]
Split-Path
     -LiteralPath <String[]>
     [-Resolve]
     [-Credential <PSCredential>]
     [-UseTransaction]
     [<CommonParameters>]

Beschreibung

Das Split-Path Cmdlet gibt nur den angegebenen Teil eines Pfads zurück, z. B. den übergeordneten Ordner, einen Unterordner oder einen Dateinamen. Außerdem können Elemente abgerufen werden, auf die von dem geteilten Pfad verwiesen wird, und es kann angegeben werden, ob es sich um einen relativen oder absoluten Pfad handelt.

Sie können mit diesem Cmdlet nur einen ausgewählten Teil eines Pfads abrufen oder senden.

Beispiele

Beispiel 1: Abrufen des Qualifizierers eines Pfads

Split-Path -Path "HKCU:\Software\Microsoft" -Qualifier

HKCU:

Dieser Befehl gibt nur den Qualifizierer des Pfads zurück. Der Qualifizierer ist das Laufwerk.

Beispiel 2: Anzeigen des Dateinamenteils des Pfads

Gibt bei Verwendung des Leaf-Parameters Split-Path nur das letzte Element in der angegebenen Pfadzeichenfolge zurück, unabhängig davon, ob es sich bei diesem Element um eine Datei oder ein Verzeichnis handelt.

Split-Path -Path .\folder1\*.txt -Leaf

*.txt

Split-Path -Path .\folder1\*.txt -Leaf -Resolve

file1.txt
file2.txt

Wenn Sie den Resolve-Parameter verwenden, Split-Path wird die angegebene Pfadzeichenfolge aufgelöst und die Vom Pfad referenzierten Elemente zurückgegeben.

Beispiel 3: Abrufen des übergeordneten Containers

Gibt bei Verwendung des Parent-Parameters Split-Path nur den übergeordneten Containerteil der angegebenen Pfadzeichenfolge zurück. Wenn die Pfadzeichenfolge keinen übergeordneten Container enthält, Split-Path wird eine leere Zeichenfolge zurückgegeben.

Split-Path -Path .\folder1\file1.txt -Parent

.\folder1

Split-Path -Path .\folder1\file1.txt -Parent -Resolve

D:\temp\test\folder1

Wenn Sie den Resolve-Parameter verwenden, Split-Path wird die angegebene Pfadzeichenfolge aufgelöst und der vollständige Pfad des übergeordneten Containers zurückgegeben.

Beispiel 4: Bestimmt, ob ein Pfad absolut ist.

Mit diesem Befehl wird bestimmt, ob der Pfad relativ oder absolut ist. In diesem Fall ist der Pfad relativ zum aktuellen Ordner, der durch einen Punkt (.) dargestellt wird, zurückgegeben $False.

Split-Path -Path ".\My Pictures\*.jpg" -IsAbsolute

False

Beispiel 5: Ändern des Speicherorts in einen angegebenen Pfad

Dieser Befehl ändert Ihren Speicherort in den Ordner, der das PowerShell-Profil enthält.

PS C:\> Set-Location (Split-Path -Path $profile)
PS C:\Users\User01\Documents\PowerShell>

Der Befehl in Klammern verwendet Split-Path , um nur das übergeordnete Element des Pfads zurückzugeben, der in der integrierten $Profile Variablen gespeichert ist. Der Parameter "Parent " ist der standardmäßige Parameter für geteilte Speicherorte. Daher können Sie ihn aus dem Befehl weglassen. Die Klammern leiten PowerShell an, um den Befehl zuerst auszuführen. Dies ist eine nützliche Möglichkeit zum Verschieben in einen Ordner mit einem langen Pfadnamen.

Beispiel 6: Teilen eines Pfads mithilfe der Pipeline

'C:\Users\User01\My Documents\My Pictures' | Split-Path

C:\Users\User01\My Documents

Dieser Befehl verwendet einen Pipelineoperator (|) zum Senden eines Pfads zu Split-Path. Der Pfad wird in Anführungszeichen eingeschlossen, um anzugeben, dass es sich um ein einzelnes Token handelt.

Parameter

-Credential

Hinweis

Dieser Parameter wird von anbietern, die mit PowerShell installiert sind, nicht unterstützt. Verwenden Sie "Invoke-Command", um die Identität eines anderen Benutzers zu imitieren oder Ihre Anmeldeinformationen beim Ausführen dieses Cmdlets zu erhöhen.

Typ:PSCredential
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:True
Platzhalterzeichen akzeptieren:False

-IsAbsolute

Gibt an, dass dieses Cmdlet zurückgibt $True , ob der Pfad absolut $False und relativ ist. Unter Windows muss eine absolute Pfadzeichenfolge mit einem Anbieterlaufwerksbezeichner C: wie oder HKCU:. Ein relativer Pfad beginnt mit einem Punkt (.) oder einem Punkt (..).

Typ:SwitchParameter
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-Leaf

Gibt bei Verwendung des Leaf-Parameters Split-Path nur das letzte Element in der angegebenen Pfadzeichenfolge zurück, unabhängig davon, ob es sich bei diesem Element um eine Datei oder ein Verzeichnis handelt.

Typ:SwitchParameter
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:True
Platzhalterzeichen akzeptieren:False

-LiteralPath

Gibt die zu teilenden Pfade an. Im Gegensatz zu Path wird der Wert von LiteralPath genau so verwendet, wie er eingegeben wird. 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 weisen PowerShell an, keine Zeichen als Escapesequenzen zu interpretieren.

Typ:String[]
Aliase:PSPath
Position:Named
Standardwert:None
Erforderlich:True
Pipelineeingabe akzeptieren:True
Platzhalterzeichen akzeptieren:False

-NoQualifier

Gibt an, dass dieses Cmdlet den Pfad ohne den Qualifizierer zurückgibt. Für fileSystem- oder Registrierungsanbieter ist der Qualifizierer das Laufwerk des Anbieterpfads, z C: . B. oder HKCU:. Im Pfad wird z. B C:\Test\Logs\Pass1.log. nur \Test\Logs\Pass1.logzurückgegeben.

Typ:SwitchParameter
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:True
Platzhalterzeichen akzeptieren:False

-Parent

Split-Path gibt nur den übergeordneten Containerteil der angegebenen Pfadzeichenfolge zurück. Wenn die Pfadzeichenfolge keinen übergeordneten Container enthält, Split-Path wird eine leere Zeichenfolge zurückgegeben.

Typ:SwitchParameter
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:True
Platzhalterzeichen akzeptieren:False

-Path

Gibt die zu teilenden Pfade an. Platzhalterzeichen sind zulässig. Wenn der Pfad Leerzeichen enthält, müssen Sie ihn in Anführungszeichen einschließen. Sie können auch einen Pfad zu diesem Cmdlet weiterleiten.

Typ:String[]
Position:0
Standardwert:None
Erforderlich:True
Pipelineeingabe akzeptieren:True
Platzhalterzeichen akzeptieren:True

-Qualifier

Gibt an, dass dieses Cmdlet nur den Qualifizierer des angegebenen Pfads zurückgibt. Für fileSystem- oder Registrierungsanbieter ist der Qualifizierer das Laufwerk des Anbieterpfads, z C: . B. oder HKCU:.

Typ:SwitchParameter
Position:1
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:True
Platzhalterzeichen akzeptieren:False

-Resolve

Gibt an, dass dieses Cmdlet die Elemente anzeigt, auf die durch den resultierenden geteilten Pfad verwiesen wird, anstatt die Pfadelemente anzuzeigen.

Typ:SwitchParameter
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-UseTransaction

Schließt den Befehl in die aktive Transaktion ein. Dieser Parameter ist nur gültig, wenn gerade eine Transaktion ausgeführt wird. Weitere Informationen finden Sie unter about_Transactions.

Typ:SwitchParameter
Aliase:usetx
Position:Named
Standardwert:False
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

Eingaben

String

Sie können eine Zeichenfolge weiterleiten, die einen Pfad zu diesem Cmdlet enthält.

Ausgaben

String

Dieses Cmdlet gibt Textzeichenfolgen zurück. Wenn Sie den Resolve-Parameter angeben, wird eine Zeichenfolge zurückgegeben, die die Position der Elemente beschreibt. Es werden keine Objekte zurückgegeben, die die Elemente darstellen, z. B. ein FileInfo - oder RegistryKey-Objekt .

Boolean

Wenn Sie den Parameter IsAbsolute angeben, gibt dieses Cmdlet einen booleschen Wert zurück.

Hinweise

  • Die Parameter für geteilte Speicherorte (Qualifizierer, übergeordnetes Element, Blatt und NoQualifier) sind exklusiv. In einem Befehl kann immer nur ein Parameter angegeben werden.

  • Die Cmdlets, die das Path-Substantiv (die Pfad-Cmdlets ) enthalten, arbeiten mit Pfadnamen und geben die Namen in einem präzisen Format zurück, das von allen PowerShell-Anbietern interpretiert werden kann. Sie sind für die Verwendung in Programmen und Skripts vorgesehen, in denen Sie den Gesamten oder Einen Teil eines Pfadnamens in einem bestimmten Format anzeigen möchten. Verwenden Sie sie so, wie Sie Dirname, Normpath, Realpath, Join oder andere Pfadmanipulationen verwenden würden.

  • Sie können die Path-Cmdlets zusammen mit mehreren Anbietern verwenden. Dazu gehören die FileSystem-, Registrierungs- und Zertifikatanbieter.

  • Split-Path ist für die Arbeit mit den Daten konzipiert, die von jedem Anbieter verfügbar gemacht werden. Geben Sie ein, um die in Ihrer Sitzung verfügbaren Anbieter auflisten zu können Get-PSProvider. Weitere Informationen finden Sie unter about_Providers.