Freigeben über


Split-Path

Gibt den angegebenen Teil eines Pfads zurück.

Syntax

ParentSet (Standard)

Split-Path
    [-Path] <String[]>
    [-Parent]
    [-Resolve]
    [-Credential <PSCredential>]
    [<CommonParameters>]

LeafSet

Split-Path
    [-Path] <String[]>
    -Leaf
    [-Resolve]
    [-Credential <PSCredential>]
    [<CommonParameters>]

LeafBaseSet

Split-Path
    [-Path] <String[]>
    -LeafBase
    [-Resolve]
    [-Credential <PSCredential>]
    [<CommonParameters>]

ExtensionSet

Split-Path
    [-Path] <String[]>
    -Extension
    [-Resolve]
    [-Credential <PSCredential>]
    [<CommonParameters>]

QualifierSet

Split-Path
    [-Path] <String[]>
    -Qualifier
    [-Resolve]
    [-Credential <PSCredential>]
    [<CommonParameters>]

NoQualifierSet

Split-Path
    [-Path] <String[]>
    -NoQualifier
    [-Resolve]
    [-Credential <PSCredential>]
    [<CommonParameters>]

IsAbsoluteSet

Split-Path
    [-Path] <String[]>
    -IsAbsolute
    [-Resolve]
    [-Credential <PSCredential>]
    [<CommonParameters>]

LiteralPathSet

Split-Path
    -LiteralPath <String[]>
    [-Resolve]
    [-Credential <PSCredential>]
    [<CommonParameters>]

Beschreibung

Das 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 vom geteilten Pfad verwiesen wird, und es wird angegeben, ob der Pfad relativ oder absolut ist.

Sie können dieses Cmdlet verwenden, um nur einen ausgewählten Teil eines Pfads abzurufen oder zu übermitteln.

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 von Dateinamen

Split-Path -Path "C:\Test\Logs\*.log" -Leaf -Resolve
Pass1.log
Pass2.log
...

Mit diesem Befehl werden die Dateien angezeigt, auf die vom geteilten Pfad verwiesen wird. Da dieser Pfad auf das letzte Element aufgeteilt ist, auch als Blatt bezeichnet, zeigt der Befehl nur die Dateinamen an.

Der Resolve-Parameter weist an, dass die Elemente angezeigt werden sollen Split-Path , auf die der geteilte Pfad verweist, anstatt der geteilte Pfad anzuzeigen.

Wie alle Split-Path Befehle gibt auch dieser Befehl Zeichenfolgen zurück. Es gibt keine FileInfo- Objekte zurück, die die Dateien darstellen.

Beispiel 3: Abrufen des übergeordneten Containers

Split-Path -Path "C:\WINDOWS\system32\WindowsPowerShell\V1.0\about_*.txt"
C:\WINDOWS\system32\WindowsPowerShell\V1.0

Dieser Befehl gibt nur die übergeordneten Container des Pfads zurück. Da es keine Parameter zum Angeben der Teilung enthält, wird die Standardeinstellung für die Teilungsposition verwendet, Split-Path die übergeordnet ist.

Beispiel 4: Bestimmt, ob ein Pfad absolut ist.

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

Mit diesem Befehl wird bestimmt, ob der Pfad relativ oder absolut ist. In diesem Fall, da der Pfad relativ zum aktuellen Ordner ist, der durch einen Punkt (.) dargestellt wird, gibt er $Falsezurück.

Beispiel 5: Ändern des Speicherorts in einen angegebenen Pfad

PS C:\> Set-Location (Split-Path -Path $profile)
PS C:\Documents and Settings\User01\My Documents\WindowsPowerShell>

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

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 standardparameter für geteilte Position. 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:\Documents and Settings\User01\My Documents\My Pictures' | Split-Path
C:\Documents and Settings\User01\My Documents

Dieser Befehl verwendet einen Pipelineoperator (|), um einen Pfad zu Split-Pathzu senden. 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.

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

-Extension

Gibt an, dass dieses Cmdlet nur die Erweiterung des Blatts zurückgibt. Im Pfad C:\Test\Logs\Pass1.logwird beispielsweise nur .logzurückgegeben.

Dieser Parameter wurde in PowerShell 6.0 eingeführt.

Parametereigenschaften

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

Parametersätze

ExtensionSet
Position:Named
Obligatorisch:True
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:True
Wert aus verbleibenden Argumenten:False

-IsAbsolute

Gibt an, dass dieses Cmdlet zurückgibt $True , ob der Pfad absolut und $False relativ ist. Ein absoluter Pfad hat eine Länge größer als Null und verwendet keinen Punkt (.), um den aktuellen Pfad anzugeben.

Parametereigenschaften

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

Parametersätze

IsAbsoluteSet
Position:Named
Obligatorisch:True
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten:False

-Leaf

Gibt an, dass dieses Cmdlet nur das letzte Element oder den letzten Container im Pfad zurückgibt. Im Pfad C:\Test\Logs\Pass1.logwird beispielsweise nur Pass1.log zurückgegeben.

Parametereigenschaften

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

Parametersätze

LeafSet
Position:Named
Obligatorisch:True
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:True
Wert aus verbleibenden Argumenten:False

-LeafBase

Gibt an, dass dieses Cmdlet nur den Basisnamen des Blatts zurückgibt. Im Pfad C:\Test\Logs\Pass1.logwird beispielsweise nur Pass1zurückgegeben.

Dieser Parameter wurde in PowerShell 6.0 eingeführt.

Parametereigenschaften

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

Parametersätze

LeafBaseSet
Position:Named
Obligatorisch:True
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:True
Wert aus verbleibenden Argumenten:False

-LiteralPath

Gibt die zu teilenden Pfade an. Im Gegensatz zu Path wird der Wert von LiteralPath genau so verwendet, wie er eingegeben wurde. 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, EP

Parametersätze

LiteralPathSet
Position:Named
Obligatorisch:True
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:True
Wert aus verbleibenden Argumenten: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. B. C: oder HKCU:. Im Pfad C:\Test\Logs\Pass1.logwird beispielsweise nur \Test\Logs\Pass1.logzurückgegeben.

Parametereigenschaften

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

Parametersätze

NoQualifierSet
Position:Named
Obligatorisch:True
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:True
Wert aus verbleibenden Argumenten:False

-Parent

Gibt an, dass dieses Cmdlet nur die übergeordneten Container des Elements oder des durch den Pfad angegebenen Containers zurückgibt. Im Pfad C:\Test\Logs\Pass1.logwird beispielsweise zurückgegeben C:\Test\Logs. Der parameter Parent ist der standardparameter für geteilte Position.

Parametereigenschaften

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

Parametersätze

ParentSet
Position:Named
Obligatorisch:False
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:True
Wert aus verbleibenden Argumenten:False

-Path

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

Parametereigenschaften

Typ:

String[]

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

Parametersätze

ParentSet
Position:0
Obligatorisch:True
Wert aus Pipeline:True
Wert aus Pipeline nach dem Eigenschaftsnamen:True
Wert aus verbleibenden Argumenten:False
LeafSet
Position:0
Obligatorisch:True
Wert aus Pipeline:True
Wert aus Pipeline nach dem Eigenschaftsnamen:True
Wert aus verbleibenden Argumenten:False
LeafBaseSet
Position:0
Obligatorisch:True
Wert aus Pipeline:True
Wert aus Pipeline nach dem Eigenschaftsnamen:True
Wert aus verbleibenden Argumenten:False
ExtensionSet
Position:0
Obligatorisch:True
Wert aus Pipeline:True
Wert aus Pipeline nach dem Eigenschaftsnamen:True
Wert aus verbleibenden Argumenten:False
QualifierSet
Position:0
Obligatorisch:True
Wert aus Pipeline:True
Wert aus Pipeline nach dem Eigenschaftsnamen:True
Wert aus verbleibenden Argumenten:False
NoQualifierSet
Position:0
Obligatorisch:True
Wert aus Pipeline:True
Wert aus Pipeline nach dem Eigenschaftsnamen:True
Wert aus verbleibenden Argumenten:False
IsAbsoluteSet
Position:0
Obligatorisch:True
Wert aus Pipeline:True
Wert aus Pipeline nach dem Eigenschaftsnamen:True
Wert aus verbleibenden Argumenten:False

-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. B. C: oder HKCU:.

Parametereigenschaften

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

Parametersätze

QualifierSet
Position:1
Obligatorisch:True
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:True
Wert aus verbleibenden Argumenten:False

-Resolve

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

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

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.String, System.Boolean

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

Wenn Sie den Parameter IsAbsolute angeben, Split-Path wird ein boolescher Wert zurückgegeben.

Hinweise

  • Die Parameter für geteilte Speicherorte (Qualifizierer, Parent, Extension, Leaf, LeafBaseund NoQualifier) sind exklusiv. Sie können in jedem Befehl nur eins verwenden.

  • Die Cmdlets, die das Path Substantiv (die Path 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, Joinoder andere Pfadmanipulatoren 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 Get-PSProviderein, um die in Ihrer Sitzung verfügbaren Anbieter auflisten zu können. Weitere Informationen finden Sie unter über_Anbieter.