Split-Path
Zwraca określoną część ścieżki.
Składnia
Split-Path
[-Path] <String[]>
[-Parent]
[-Resolve]
[-Credential <PSCredential>]
[<CommonParameters>]
Split-Path
[-Path] <String[]>
-Leaf
[-Resolve]
[-Credential <PSCredential>]
[<CommonParameters>]
Split-Path
[-Path] <String[]>
-LeafBase
[-Resolve]
[-Credential <PSCredential>]
[<CommonParameters>]
Split-Path
[-Path] <String[]>
-Extension
[-Resolve]
[-Credential <PSCredential>]
[<CommonParameters>]
Split-Path
[-Path] <String[]>
-Qualifier
[-Resolve]
[-Credential <PSCredential>]
[<CommonParameters>]
Split-Path
[-Path] <String[]>
-NoQualifier
[-Resolve]
[-Credential <PSCredential>]
[<CommonParameters>]
Split-Path
[-Path] <String[]>
[-Resolve]
-IsAbsolute
[-Credential <PSCredential>]
[<CommonParameters>]
Split-Path
-LiteralPath <String[]>
[-Resolve]
[-Credential <PSCredential>]
[<CommonParameters>]
Opis
Polecenie cmdlet 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
o wyświetlaniu elementów, do których odwołuje się ścieżka podziału, zamiast wyświetlać ścieżkę podziału.
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 -Path "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 do określenia podziału, Split-Path
używa domyślnej lokalizacji podziału, która jest elementem nadrzędnym.
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 wartość $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
metody , aby zwrócić tylko element nadrzędny ścieżki przechowywanej we wbudowanej $Profile
zmiennej. Parametr nadrzędny 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 (|
), aby wysłać ścieżkę do Split-Path
. Ścieżka jest ujęta w znaki cudzysłowu, aby wskazać, że jest to pojedynczy token.
Parametry
-Credential
Uwaga
Ten parametr nie jest obsługiwany przez żadnych dostawców zainstalowanych w programie PowerShell. Aby personifikować innego użytkownika lub podnieść poziom poświadczeń podczas uruchamiania tego polecenia cmdlet, użyj polecenia Invoke-Command.
Type: | PSCredential |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-Extension
Wskazuje, że to polecenie cmdlet zwraca tylko rozszerzenie liścia. Na przykład w ścieżce C:\Test\Logs\Pass1.log
zwraca tylko .log
wartość .
Ten parametr został wprowadzony w programie PowerShell 6.0.
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Required: | True |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-IsAbsolute
Wskazuje, że to polecenie cmdlet zwraca wartość $True
, jeśli ścieżka jest bezwzględna i $False, jeśli jest względna. Ścieżka bezwzględna ma długość większą niż zero i nie używa kropki (.
), aby wskazać bieżącą ścieżkę.
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Required: | True |
Accept pipeline input: | False |
Accept wildcard characters: | 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.log
metoda zwraca tylko Pass1.log.
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Required: | True |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-LeafBase
Wskazuje, że to polecenie cmdlet zwraca tylko podstawową nazwę liścia. Na przykład w ścieżce C:\Test\Logs\Pass1.log
zwraca tylko Pass1
wartość .
Ten parametr został wprowadzony w programie PowerShell 6.0.
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Required: | True |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-LiteralPath
Określa ścieżki do podziału. W przeciwieństwie do ścieżki wartość LiterałuPath jest używana dokładnie tak, jak jest typowana. Znaki wieloznaczne nie są interpretowane jako znaki wieloznaczne. Jeśli ścieżka zawiera znaki ucieczki, należy ująć ją w znaki pojedynczego cudzysłowu. Znaki pojedynczego cudzysłowu informują program PowerShell, aby nie interpretował żadnych znaków jako sekwencji ucieczki.
Type: | String[] |
Aliases: | PSPath, LP |
Position: | Named |
Default value: | None |
Required: | True |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-NoQualifier
Wskazuje, że to polecenie cmdlet zwraca ścieżkę bez kwalifikatora. W przypadku dostawcy 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.log
zwraca tylko \Test\Logs\Pass1.log
wartość .
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Required: | True |
Accept pipeline input: | True |
Accept wildcard characters: | 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 wartość C:\Test\Logs
.
Parametr nadrzędny jest domyślnym parametrem lokalizacji podziału.
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-Path
Określa ścieżki do podziału. Dozwolone są symbole wieloznaczne. Jeśli ścieżka zawiera spacje, należy ująć ją w cudzysłów. Możesz również przekazać ścieżkę do tego polecenia cmdlet.
Type: | String[] |
Position: | 0 |
Default value: | None |
Required: | True |
Accept pipeline input: | True |
Accept wildcard characters: | True |
-Qualifier
Wskazuje, że to polecenie cmdlet zwraca tylko kwalifikator określonej ścieżki. W przypadku dostawcy systemu plików lub rejestru kwalifikator jest dyskiem ścieżki dostawcy, takiej jak C:
lub HKCU:
.
Type: | SwitchParameter |
Position: | 1 |
Default value: | None |
Required: | True |
Accept pipeline input: | True |
Accept wildcard characters: | 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.
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Dane wejściowe
Możesz potokować ciąg zawierający ścieżkę do tego polecenia cmdlet.
Dane wyjściowe
System.String, System.Boolean
Split-Path
Zwraca ciągi tekstowe. Po określeniu parametru Split-Path
Resolve zwraca ciąg opisujący lokalizację elementów. Nie zwraca on obiektów reprezentujących elementy, takich jak FileInfo lub RegistryKey.
Po określeniu parametru Split-Path
IsAbsolute zwraca wartość logiczną.
Uwagi
Parametry lokalizacji podzielonej (kwalifikator, nadrzędny, rozszerzenie, liść, leafbase i noQualifier) są wyłączne. W każdym poleceniu można użyć tylko jednego polecenia.
Polecenia cmdletzawierającee ścieżki (polecenia cmdlet ścieżki ) 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ć wszystkie lub część nazwy ścieżki w określonym formacie. Użyj ich w taki sposób, aby używać dirname, Normpath, Realpath, Join lub innych manipulatorów ścieżek.
Polecenia cmdlet ścieżki można używać razem z kilkoma dostawcami. Należą do nich dostawcy systemów plików, rejestru i certyfikatów.
Split-Path
jest przeznaczony do pracy z danymi udostępnianymi przez dowolnego dostawcę. Aby wyświetlić listę dostawców dostępnych w sesji, wpiszGet-PSProvider
. Aby uzyskać więcej informacji, zobacz about_Providers.