Udostępnij za pośrednictwem

Split-Path

  • Odwołanie
Moduł:
Microsoft.PowerShell.Management

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

Składnia

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

Opis

Polecenie Split-Path 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 części nazwy pliku ścieżki

W przypadku korzystania z parametru Split-Path Leaf zwraca tylko ostatni element w podanym ciągu ścieżki, niezależnie od tego, czy ten element jest plikiem, czy katalogiem.

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

*.txt

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

file1.txt
file2.txt

Jeśli używasz parametru Resolve , Split-Path usuwa podany ciąg ścieżki i zwraca elementy, do których odwołuje się ścieżka.

Przykład 3. Pobieranie kontenera nadrzędnego

W przypadku używania parametru Split-Path nadrzędnego zwraca tylko część nadrzędnego kontenera podanego ciągu ścieżki. Jeśli ciąg path nie zawiera kontenera nadrzędnego, Split-Path zwraca pusty ciąg.

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

.\folder1

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

D:\temp\test\folder1

Jeśli używasz parametru Resolve , Split-Path usuwa podany ciąg ścieżki i zwraca pełną ścieżkę kontenera nadrzędnego.

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

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.

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

False

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

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

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

Polecenie w nawiasach używa Split-Path metody , aby zwrócić tylko element nadrzędny ścieżki przechowywanej w 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:\Users\User01\My Documents\My Pictures' | Split-Path

C:\Users\User01\My Documents

To polecenie używa operatora potoku (|), aby wysłać ścieżkę do Split-Path. Ścieżka jest ujęta w cudzysłów, 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.

Typ:PSCredential
Position:Named
Domyślna wartość:None
Wymagane:False
Akceptowanie danych wejściowych potoku:True
Akceptowanie symboli wieloznacznych:False

-IsAbsolute

Wskazuje, że to polecenie cmdlet zwraca $True wartość , jeśli ścieżka jest bezwzględna i $False czy jest względna. W systemie Windows ciąg ścieżki bezwzględnej musi rozpoczynać się od specyfikatora dysku dostawcy, takiego jak C: lub HKCU:. Ścieżka względna rozpoczyna się kropką (.) lub kropką (..).

Typ:SwitchParameter
Position:Named
Domyślna wartość:None
Wymagane:False
Akceptowanie danych wejściowych potoku:False
Akceptowanie symboli wieloznacznych:False

-Leaf

W przypadku korzystania z parametru Split-Path Leaf zwraca tylko ostatni element w podanym ciągu ścieżki, niezależnie od tego, czy ten element jest plikiem, czy katalogiem.

Typ:SwitchParameter
Position:Named
Domyślna wartość:None
Wymagane:False
Akceptowanie danych wejściowych potoku:True
Akceptowanie symboli wieloznacznych: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 nie są interpretowane jako symbole wieloznaczne. Jeśli ścieżka zawiera znaki ucieczki, należy ująć ją w pojedynczy cudzysłów. Pojedyncze znaki cudzysłowu informują program PowerShell, aby nie interpretował żadnych znaków jako sekwencji ucieczki.

Typ:String[]
Aliasy:PSPath
Position:Named
Domyślna wartość:None
Wymagane:True
Akceptowanie danych wejściowych potoku:True
Akceptowanie symboli wieloznacznych: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.logzwraca tylko \Test\Logs\Pass1.logwartość .

Typ:SwitchParameter
Position:Named
Domyślna wartość:None
Wymagane:False
Akceptowanie danych wejściowych potoku:True
Akceptowanie symboli wieloznacznych:False

-Parent

Split-Path Zwraca tylko część nadrzędnego kontenera podanego ciągu ścieżki. Jeśli ciąg path nie zawiera kontenera nadrzędnego, Split-Path zwraca pusty ciąg.

Typ:SwitchParameter
Position:Named
Domyślna wartość:None
Wymagane:False
Akceptowanie danych wejściowych potoku:True
Akceptowanie symboli wieloznacznych: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.

Typ:String[]
Position:0
Domyślna wartość:None
Wymagane:True
Akceptowanie danych wejściowych potoku:True
Akceptowanie symboli wieloznacznych:True

-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:.

Typ:SwitchParameter
Position:1
Domyślna wartość:None
Wymagane:False
Akceptowanie danych wejściowych potoku:True
Akceptowanie symboli wieloznacznych: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.

Typ:SwitchParameter
Position:Named
Domyślna wartość:None
Wymagane:False
Akceptowanie danych wejściowych potoku:False
Akceptowanie symboli wieloznacznych:False

-UseTransaction

Zawiera polecenie w aktywnej transakcji. Ten parametr jest prawidłowy tylko wtedy, gdy transakcja jest w toku. Aby uzyskać więcej informacji, zobacz about_Transactions.

Typ:SwitchParameter
Aliasy:usetx
Position:Named
Domyślna wartość:False
Wymagane:False
Akceptowanie danych wejściowych potoku:False
Akceptowanie symboli wieloznacznych:False

Dane wejściowe

String

Możesz potokować ciąg zawierający ścieżkę do tego polecenia cmdlet.

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, takie jak FileInfo lub RegistryKey .

Boolean

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

Uwagi

  • Parametry lokalizacji podziału (kwalifikator, nadrzędny, liści i noQualifier) są wyłączne. W każdym poleceniu można użyć tylko jednego polecenia.

  • Polecenia cmdletzawierającee ścieżki ( polecenia cmdlet path ) działają z nazwami ścieżek i zwracają nazwy w zwięzłym formacie, który może 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, Join lub innych manipulatorów ścieżek.

  • Polecenia cmdlet Path 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, wpisz Get-PSProvider. Aby uzyskać więcej informacji, zobacz about_Providers.