Split-Path

Moduł:

Microsoft.PowerShell.Management Module

Zwraca określoną część ścieżki.

Składnia

ParentSet (domyślnie)

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

Opis

Polecenie cmdlet Split-Path zwraca tylko określoną część ścieżki, taką jak folder nadrzędny, podfolder lub nazwa pliku. Może również pobierać elementy, do których odwołuje się ścieżka podziału, i określać, czy ścieżka jest względna, czy bezwzględna.

To polecenie cmdlet służy do pobierania lub przesyłania tylko wybranej części ścieżki.

Przykłady

Przykład 1. Pobieranie kwalifikatora ścieżki

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

HKCU:

To polecenie zwraca tylko kwalifikator ścieżki. Kwalifikator to dysk.

Przykład 2: Wyświetlanie nazw plików

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

Pass1.log
Pass2.log
...

To polecenie wyświetla pliki, do których odwołuje się ścieżka podziału. Ponieważ ta ścieżka jest podzielona na ostatni element, znany również jako liść, polecenie wyświetla tylko nazwy plików.

Parametr Resolve informuje Split-Path , aby wyświetlić elementy, do których odwołuje się ścieżka podzielona, zamiast wyświetlać ścieżkę podzieloną.

Podobnie jak wszystkie Split-Path polecenia, to polecenie zwraca ciągi. Nie zwraca obiektów FileInfo reprezentujących pliki.

Przykład 3. Pobieranie kontenera nadrzędnego

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

C:\WINDOWS\system32\WindowsPowerShell\V1.0

To polecenie zwraca tylko kontenery nadrzędne ścieżki. Ponieważ nie zawiera żadnych parametrów określających podział, Split-Path używa domyślnej lokalizacji podziału, czyli elementu nadrzędnego.

Przykład 4. Określa, czy ścieżka jest bezwzględna

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

False

To polecenie określa, czy ścieżka jest względna, czy bezwzględna. W tym przypadku, ponieważ ścieżka jest względna względem bieżącego folderu, który jest reprezentowany przez kropkę (.), zwraca $False.

Przykład 5. Zmiana lokalizacji na określoną ścieżkę

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

To polecenie zmienia lokalizację folderu zawierającego profil programu PowerShell.

Polecenie w nawiasach używa Split-Path, aby zwrócić tylko element nadrzędny ścieżki przechowywanej we wbudowanej zmiennej $Profile. Parametr parent jest domyślnym parametrem lokalizacji podziału. W związku z tym można go pominąć za pomocą polecenia . Nawiasy kierują program PowerShell, aby najpierw uruchomić polecenie. Jest to przydatny sposób przejścia do folderu, który ma długą nazwę ścieżki.

Przykład 6. Dzielenie ścieżki przy użyciu potoku

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

C:\Documents and Settings\User01\My Documents

To polecenie używa operatora potoku (|) do wysyłania ścieżki do Split-Path. Ścieżka jest ujęta w cudzysłów, aby wskazać, że jest to pojedynczy token.

Parametry

-Credential

Uwaga / Notatka

Ten parametr nie jest obsługiwany przez żadnych dostawców zainstalowanych w programie PowerShell. Aby podszyć się pod innego użytkownika lub podnieść swoje uprawnienia podczas uruchamiania tego cmdletu, użyj Invoke-Command.

Właściwości parametru

Typ:	PSCredential
Domyślna wartość:	None
Obsługuje symbole wieloznaczne:	False
DontShow:	False

Zestawy parametrów

(All)

Position:	Named
Obowiązkowe:	False
Wartość z potoku:	False
Wartość z potoku według nazwy właściwości:	True
Wartość z pozostałych argumentów:	False

-Extension

Wskazuje, że to polecenie cmdlet zwraca tylko rozszerzenie liścia. Na przykład w ścieżce C:\Test\Logs\Pass1.logfunkcja zwraca tylko .log.

Ten parametr został wprowadzony w programie PowerShell 6.0.

Właściwości parametru

Typ:	SwitchParameter
Domyślna wartość:	None
Obsługuje symbole wieloznaczne:	False
DontShow:	False

Zestawy parametrów

ExtensionSet

Position:	Named
Obowiązkowe:	True
Wartość z potoku:	False
Wartość z potoku według nazwy właściwości:	True
Wartość z pozostałych argumentów:	False

-IsAbsolute

Wskazuje, że to polecenie cmdlet zwraca $True, jeśli ścieżka jest bezwzględna i $False, jeśli jest względna. Ścieżka bezwzględna ma długość większą od zera i nie używa kropki (.) do wskazania bieżącej ścieżki.

Właściwości parametru

Typ:	SwitchParameter
Domyślna wartość:	None
Obsługuje symbole wieloznaczne:	False
DontShow:	False

Zestawy parametrów

IsAbsoluteSet

Position:	Named
Obowiązkowe:	True
Wartość z potoku:	False
Wartość z potoku według nazwy właściwości:	False
Wartość z pozostałych argumentów:	False

-Leaf

Wskazuje, że to polecenie cmdlet zwraca tylko ostatni element lub kontener w ścieżce. Na przykład w ścieżce C:\Test\Logs\Pass1.logfunkcja zwraca tylko Pass1.log.

Właściwości parametru

Typ:	SwitchParameter
Domyślna wartość:	None
Obsługuje symbole wieloznaczne:	False
DontShow:	False

Zestawy parametrów

LeafSet

Position:	Named
Obowiązkowe:	True
Wartość z potoku:	False
Wartość z potoku według nazwy właściwości:	True
Wartość z pozostałych argumentów:	False

-LeafBase

Wskazuje, że to polecenie cmdlet zwraca tylko nazwę podstawową liścia. Na przykład w ścieżce C:\Test\Logs\Pass1.logfunkcja zwraca tylko Pass1.

Ten parametr został wprowadzony w programie PowerShell 6.0.

Właściwości parametru

Typ:	SwitchParameter
Domyślna wartość:	None
Obsługuje symbole wieloznaczne:	False
DontShow:	False

Zestawy parametrów

LeafBaseSet

Position:	Named
Obowiązkowe:	True
Wartość z potoku:	False
Wartość z potoku według nazwy właściwości:	True
Wartość z pozostałych argumentów:	False

-LiteralPath

Określa ścieżki do podziału. W przeciwieństwie do Pathwartość LiteralPath jest używana dokładnie tak, jak jest typowana. Żadne znaki nie są interpretowane jako symbole wieloznaczne. Jeśli ścieżka zawiera znaki ucieczki, należy ująć ją w pojedynczy cudzysłów. Pojedyncze cudzysłowy wskazują programowi PowerShell, aby nie interpretował żadnych znaków jako sekwencji ucieczki.

Właściwości parametru

Typ:	String[]
Domyślna wartość:	None
Obsługuje symbole wieloznaczne:	False
DontShow:	False
Aliasy:	PSPath, LP

Zestawy parametrów

LiteralPathSet

Position:	Named
Obowiązkowe:	True
Wartość z potoku:	False
Wartość z potoku według nazwy właściwości:	True
Wartość z pozostałych argumentów:	False

-NoQualifier

Wskazuje, że to polecenie cmdlet zwraca ścieżkę bez kwalifikatora. W przypadku dostawców systemu plików lub rejestru kwalifikator jest dyskiem ścieżki dostawcy, takiej jak C: lub HKCU:. Na przykład w ścieżce C:\Test\Logs\Pass1.logfunkcja zwraca tylko \Test\Logs\Pass1.log.

Właściwości parametru

Typ:	SwitchParameter
Domyślna wartość:	None
Obsługuje symbole wieloznaczne:	False
DontShow:	False

Zestawy parametrów

NoQualifierSet

Position:	Named
Obowiązkowe:	True
Wartość z potoku:	False
Wartość z potoku według nazwy właściwości:	True
Wartość z pozostałych argumentów:	False

-Parent

Wskazuje, że to polecenie cmdlet zwraca tylko kontenery nadrzędne elementu lub kontenera określonego przez ścieżkę. Na przykład w ścieżce C:\Test\Logs\Pass1.log, zwraca C:\Test\Logs. Parametr parent jest domyślnym parametrem lokalizacji podziału.

Właściwości parametru

Typ:	SwitchParameter
Domyślna wartość:	None
Obsługuje symbole wieloznaczne:	False
DontShow:	False

Zestawy parametrów

ParentSet

Position:	Named
Obowiązkowe:	False
Wartość z potoku:	False
Wartość z potoku według nazwy właściwości:	True
Wartość z pozostałych argumentów:	False

-Path

Określa ścieżki do podziału. Symbole wieloznaczne są dozwolone. Jeśli ścieżka zawiera spacje, należy ująć ją w cudzysłów. Możesz również przekazać ścieżkę do tego polecenia cmdlet.

Właściwości parametru

Typ:	String[]
Domyślna wartość:	None
Obsługuje symbole wieloznaczne:	True
DontShow:	False

Zestawy parametrów

ParentSet

Position:	0
Obowiązkowe:	True
Wartość z potoku:	True
Wartość z potoku według nazwy właściwości:	True
Wartość z pozostałych argumentów:	False

LeafSet

Position:	0
Obowiązkowe:	True
Wartość z potoku:	True
Wartość z potoku według nazwy właściwości:	True
Wartość z pozostałych argumentów:	False

LeafBaseSet

Position:	0
Obowiązkowe:	True
Wartość z potoku:	True
Wartość z potoku według nazwy właściwości:	True
Wartość z pozostałych argumentów:	False

ExtensionSet

Position:	0
Obowiązkowe:	True
Wartość z potoku:	True
Wartość z potoku według nazwy właściwości:	True
Wartość z pozostałych argumentów:	False

QualifierSet

Position:	0
Obowiązkowe:	True
Wartość z potoku:	True
Wartość z potoku według nazwy właściwości:	True
Wartość z pozostałych argumentów:	False

NoQualifierSet

Position:	0
Obowiązkowe:	True
Wartość z potoku:	True
Wartość z potoku według nazwy właściwości:	True
Wartość z pozostałych argumentów:	False

IsAbsoluteSet

Position:	0
Obowiązkowe:	True
Wartość z potoku:	True
Wartość z potoku według nazwy właściwości:	True
Wartość z pozostałych argumentów:	False

-Qualifier

Wskazuje, że to polecenie cmdlet zwraca tylko kwalifikator określonej ścieżki. W przypadku dostawców systemu plików lub rejestru kwalifikator jest dyskiem ścieżki dostawcy, takiej jak C: lub HKCU:.

Właściwości parametru

Typ:	SwitchParameter
Domyślna wartość:	None
Obsługuje symbole wieloznaczne:	False
DontShow:	False

Zestawy parametrów

QualifierSet

Position:	1
Obowiązkowe:	True
Wartość z potoku:	False
Wartość z potoku według nazwy właściwości:	True
Wartość z pozostałych argumentów:	False

-Resolve

Wskazuje, że to polecenie cmdlet wyświetla elementy, do których odwołuje się wynikowa ścieżka podziału, zamiast wyświetlać elementy ścieżki.

Właściwości parametru

Typ:	SwitchParameter
Domyślna wartość:	None
Obsługuje symbole wieloznaczne:	False
DontShow:	False

Zestawy parametrów

(All)

Position:	Named
Obowiązkowe:	False
Wartość z potoku:	False
Wartość z potoku według nazwy właściwości:	False
Wartość z pozostałych argumentów:	False

CommonParameters

To polecenie cmdlet obsługuje typowe parametry: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction i -WarningVariable. Aby uzyskać więcej informacji, zobacz about_CommonParameters.

Dane wejściowe

String

Możesz przekierować ciąg zawierający ścieżkę do tego cmdletu.

Dane wyjściowe

String

To polecenie cmdlet zwraca ciągi tekstowe. Po określeniu parametru Resolve zwraca on ciąg opisujący lokalizację elementów. Nie zwraca obiektów reprezentujących elementy, takich jak FileInfo lub RegistryKey obiektu.

Boolean

Po określeniu parametru IsAbsolute to polecenie cmdlet zwraca wartość logiczną .

Uwagi

• Parametry lokalizacji podziału (kwalifikator, nadrzędne, rozszerzenia, Leaf, LeafBasei NoQualifier) są wyłączne. W każdym poleceniu można użyć tylko jednego polecenia.

• Polecenia cmdlet zawierające Path noun (Path cmdlet) działają z nazwami ścieżek i zwracają nazwy w zwięzłym formacie, który mogą interpretować wszyscy dostawcy programu PowerShell. Są one przeznaczone do użytku w programach i skryptach, w których chcesz wyświetlić całą lub część nazwy ścieżki w określonym formacie. Użyj ich w taki sposób, aby używać Dirname, Normpath, Realpath, Joinlub innych manipulatorów ścieżek.

• Możesz użyć poleceń cmdlet ścieżki wraz z kilkoma dostawcami. Należą do nich dostawcy systemów plików, rejestru i certyfikatów.

• Split-Path jest przeznaczona do pracy z danymi udostępnianymi przez dowolnego dostawcę. Aby wyświetlić listę dostawców dostępnych w sesji, wpisz Get-PSProvider. Aby uzyskać więcej informacji, zobacz about_Providers.

Linki powiązane

• Convert-Path
• Join-Path
• Resolve-Path
• Test-Path