Split-Path

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>]

Das cmdlet Split-Path 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.

PS C:\> Split-Path -Path "HKCU:\Software\Microsoft" -Qualifier
HKCU:

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

PS C:\> 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 Parameter Resolve weist Split-Path- an, die Elemente anzuzeigen, auf die der geteilte Pfad verweist, anstatt den geteilten Pfad anzuzeigen.

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

PS C:\> 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 sie keine Parameter zum Angeben der Aufteilung enthält, verwendet Split-Path- den Standardwert für den geteilten Speicherort, der übergeordnetenist.

PS C:\> Split-Path -Path ".\My Pictures\*.jpg" -IsAbsolute
False

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

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.

PS C:\> '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-Path-zu senden. Der Pfad wird in Anführungszeichen eingeschlossen, um anzugeben, dass es sich um ein einzelnes Token handelt.

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.

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

Split-Path- textzeichenfolgen zurückgibt. Wenn Sie den Parameter Resolve angeben, gibt Split-Path- eine Zeichenfolge zurück, die die Position der Elemente beschreibt; Es werden keine Objekte zurückgegeben, die die Elemente darstellen, z. B. ein FileInfo-- oder RegistryKey--Objekt.

Wenn Sie den IsAbsolute-Parameter angeben, gibt Split-Path- einen booleschen Wert zurück.

• Die Parameter für geteilte Speicherorte (Qualifizierer, übergeordnete, Blatt-und 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- wurde entwickelt, um mit den Daten zu arbeiten, 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 about_Providers.