Split-Path
Mengembalikan bagian jalur yang ditentukan.
Sintaks
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>]
Deskripsi
Split-Path
Cmdlet hanya mengembalikan bagian jalur yang ditentukan, seperti folder induk, subfolder, atau nama file. Ini juga bisa mendapatkan item yang dirujuk oleh jalur terpisah dan memberi tahu apakah jalur relatif atau absolut.
Anda dapat menggunakan cmdlet ini untuk mendapatkan atau mengirimkan hanya bagian jalur yang dipilih.
Contoh
Contoh 1: Mendapatkan kualifikasi jalur
Split-Path -Path "HKCU:\Software\Microsoft" -Qualifier
HKCU:
Perintah ini hanya mengembalikan kualifikasi jalur. Kualifikasi adalah drive.
Contoh 2: Menampilkan nama file
Split-Path -Path "C:\Test\Logs\*.log" -Leaf -Resolve
Pass1.log
Pass2.log
...
Perintah ini menampilkan file yang dirujuk oleh jalur terpisah. Karena jalur ini dibagi ke item terakhir, juga dikenal sebagai daun, perintah hanya menampilkan nama file.
Parameter Atasi memberi tahu Split-Path
untuk menampilkan item yang dirujuk jalur terpisah, alih-alih menampilkan jalur terpisah.
Seperti semua Split-Path
perintah, perintah ini mengembalikan string. Ini tidak mengembalikan objek FileInfo yang mewakili file.
Contoh 3: Mendapatkan kontainer induk
Split-Path -Parent "C:\WINDOWS\system32\WindowsPowerShell\V1.0\about_*.txt"
C:\WINDOWS\system32\WindowsPowerShell\V1.0
Perintah ini hanya mengembalikan kontainer induk jalur. Karena tidak menyertakan parameter apa pun untuk menentukan pemisahan, Split-Path
menggunakan default lokasi terpisah, yaitu Induk.
Contoh 4: Menentukan apakah jalur bersifat absolut
Split-Path -Path ".\My Pictures\*.jpg" -IsAbsolute
False
Perintah ini menentukan apakah jalur relatif atau absolut. Dalam hal ini, karena jalur relatif terhadap folder saat ini, yang diwakili oleh titik (.
), jalur mengembalikan $False
.
Contoh 5: Mengubah lokasi ke jalur tertentu
PS C:\> Set-Location (Split-Path -Path $profile)
PS C:\Documents and Settings\User01\My Documents\WindowsPowerShell>
Perintah ini mengubah lokasi Anda ke folder yang berisi profil PowerShell.
Perintah dalam tanda kurung hanya menggunakan Split-Path
untuk mengembalikan induk jalur yang disimpan dalam variabel bawaan $Profile
. Parameter Induk adalah parameter lokasi terpisah default.
Oleh karena itu, Anda dapat menghilangkannya dari perintah. Tanda kurung mengarahkan PowerShell untuk menjalankan perintah terlebih dahulu. Ini adalah cara yang berguna untuk berpindah ke folder yang memiliki nama jalur panjang.
Contoh 6: Memisahkan jalur menggunakan alur
'C:\Documents and Settings\User01\My Documents\My Pictures' | Split-Path
C:\Documents and Settings\User01\My Documents
Perintah ini menggunakan operator alur (|
) untuk mengirim jalur ke Split-Path
. Jalur diapit dalam tanda kutip untuk menunjukkan bahwa itu adalah token tunggal.
Parameter
-Credential
Catatan
Parameter ini tidak didukung oleh penyedia apa pun yang diinstal dengan PowerShell. Untuk meniru pengguna lain, atau meningkatkan kredensial Anda saat menjalankan cmdlet ini, gunakan Invoke-Command.
Type: | PSCredential |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-Extension
Menunjukkan bahwa cmdlet ini hanya mengembalikan ekstensi daun. Misalnya, di jalur C:\Test\Logs\Pass1.log
, hanya mengembalikan .log
.
Parameter ini diperkenalkan di PowerShell 6.0.
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Required: | True |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-IsAbsolute
Menunjukkan bahwa cmdlet ini kembali $True
jika jalurnya absolut dan $False
jika relatif. Jalur absolut memiliki panjang yang lebih besar dari nol dan tidak menggunakan titik (.
) untuk menunjukkan jalur saat ini.
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Required: | True |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Leaf
Menunjukkan bahwa cmdlet ini hanya mengembalikan item atau kontainer terakhir di jalur. Misalnya, di jalur C:\Test\Logs\Pass1.log
, hanya mengembalikan Pass1.log
.
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Required: | True |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-LeafBase
Menunjukkan bahwa cmdlet ini hanya mengembalikan nama dasar daun. Misalnya, di jalur C:\Test\Logs\Pass1.log
, hanya mengembalikan Pass1
.
Parameter ini diperkenalkan di PowerShell 6.0.
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Required: | True |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-LiteralPath
Menentukan jalur yang akan dipisahkan. Tidak seperti Path, nilai LiteralPath digunakan persis seperti yang ditik. Tidak ada karakter yang ditafsirkan sebagai karakter kartubebas. Jika jalur menyertakan karakter escape, sertakan dalam tanda kutip tunggal. Tanda kutip tunggal memberi tahu PowerShell untuk tidak menginterpretasikan karakter apa pun sebagai urutan escape.
Type: | String[] |
Aliases: | PSPath, LP |
Position: | Named |
Default value: | None |
Required: | True |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-NoQualifier
Menunjukkan bahwa cmdlet ini mengembalikan jalur tanpa kualifikasi. Untuk penyedia FileSystem atau registri, kualifikasi adalah drive jalur penyedia, seperti C:
atau HKCU:
. Misalnya, di jalur C:\Test\Logs\Pass1.log
, hanya mengembalikan \Test\Logs\Pass1.log
.
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Required: | True |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-Parent
Menunjukkan bahwa cmdlet ini hanya mengembalikan kontainer induk item atau kontainer yang ditentukan oleh jalur. Misalnya, di jalur C:\Test\Logs\Pass1.log
, mengembalikan C:\Test\Logs
.
Parameter Induk adalah parameter lokasi terpisah default.
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-Path
Menentukan jalur yang akan dipisahkan. Karakter kartubebas diizinkan. Jika jalur menyertakan spasi, sertakan dalam tanda kutip. Anda juga dapat menyalurkan jalur ke cmdlet ini.
Type: | String[] |
Position: | 0 |
Default value: | None |
Required: | True |
Accept pipeline input: | True |
Accept wildcard characters: | True |
-Qualifier
Menunjukkan bahwa cmdlet ini hanya mengembalikan kualifikasi dari jalur yang ditentukan. Untuk penyedia FileSystem atau registri, kualifikasi adalah drive jalur penyedia, seperti C:
atau HKCU:
.
Type: | SwitchParameter |
Position: | 1 |
Default value: | None |
Required: | True |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-Resolve
Menunjukkan bahwa cmdlet ini menampilkan item yang dirujuk oleh jalur pemisahan yang dihasilkan alih-alih menampilkan elemen jalur.
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Input
Anda dapat menyalurkan string yang berisi jalur ke cmdlet ini.
Output
Cmdlet ini mengembalikan string teks. Saat Anda menentukan parameter Atasi , parameter mengembalikan string yang menjelaskan lokasi item. Ini tidak mengembalikan objek yang mewakili item, seperti objek FileInfo atau RegistryKey .
Saat Anda menentukan parameter IsAbsolute , cmdlet ini mengembalikan nilai Boolean .
Catatan
Parameter lokasi terpisah (Qualifier, Parent, Extension, Leaf, LeafBase, dan NoQualifier) bersifat eksklusif. Anda hanya dapat menggunakan satu di setiap perintah.
Cmdlet yang berisi kata benda Jalur ( cmdlet Jalur ) berfungsi dengan nama jalur dan mengembalikan nama dalam format ringkas yang dapat ditafsirkan oleh semua penyedia PowerShell. Mereka dirancang untuk digunakan dalam program dan skrip di mana Anda ingin menampilkan semua atau sebagian dari nama jalur dalam format tertentu. Gunakan dengan cara yang akan Anda gunakan Dirname, Normpath, Realpath, Join, atau manipulator jalur lainnya.
Anda dapat menggunakan cmdlet Jalur bersama dengan beberapa penyedia. Ini termasuk penyedia FileSystem, Registry, dan Sertifikat.
Split-Path
dirancang untuk bekerja dengan data yang diekspos oleh penyedia mana pun. Untuk mencantumkan penyedia yang tersedia di sesi Anda, ketikGet-PSProvider
. Untuk informasi selengkapnya, lihat about_Providers.
Link Terkait
Saran dan Komentar
https://aka.ms/ContentUserFeedback.
Segera hadir: Sepanjang tahun 2024 kami akan menghentikan penggunaan GitHub Issues sebagai mekanisme umpan balik untuk konten dan menggantinya dengan sistem umpan balik baru. Untuk mengetahui informasi selengkapnya, lihat:Kirim dan lihat umpan balik untuk