Bagikan melalui

Split-Path

  • Referensi
Modul:
Microsoft.PowerShell.Management

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. Jika Anda membagi jalur tanpa menentukan parameter lain, Split-Path mengembalikan bagian induk dari jalur yang disediakan.

Perintah Split-Path mengembalikan string. Ini tidak mengembalikan FileInfo atau objek item lainnya seperti *-Item perintah.

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 bagian nama file dari jalur

Saat menggunakan parameter Leaf , Split-Path hanya mengembalikan item terakhir dalam string jalur yang disediakan, terlepas dari apakah item tersebut adalah file atau direktori.

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

*.txt

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

file1.txt
file2.txt

Saat Anda menggunakan parameter Atasi , Split-Path menyelesaikan string jalur yang disediakan dan mengembalikan item yang dirujuk oleh jalur.

Contoh 3: Mendapatkan kontainer induk

Saat menggunakan parameter Induk , Split-Path hanya mengembalikan bagian kontainer induk dari string jalur yang disediakan. Jika string Jalur tidak berisi kontainer induk, Split-Path mengembalikan string kosong.

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

.\folder1

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

D:\temp\test\folder1

Saat Anda menggunakan parameter Atasi , Split-Path menyelesaikan string jalur yang disediakan dan mengembalikan jalur lengkap kontainer induk.

Contoh 4: Menentukan apakah jalur bersifat absolut

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.

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

False

Contoh 5: Mengubah lokasi ke jalur tertentu

Perintah ini mengubah lokasi Anda ke folder yang berisi profil PowerShell.

PS C:\> Set-Location (Split-Path -Path $profile)
PS C:\Users\User01\Documents\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:\Users\User01\My Documents\My Pictures' | Split-Path

C:\Users\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.

Jenis:PSCredential
Position:Named
Nilai default:None
Diperlukan:False
Terima input alur:True
Terima karakter wildcard: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.

Jenis:SwitchParameter
Position:Named
Nilai default:None
Diperlukan:True
Terima input alur:True
Terima karakter wildcard:False

-IsAbsolute

Menunjukkan bahwa cmdlet ini kembali $True jika jalurnya absolut dan $False jika relatif. Di Windows, string jalur absolut harus dimulai dengan penentu drive penyedia, seperti C: atau HKCU:. Jalur relatif dimulai dengan titik (.) atau titik-titik (..).

Jenis:SwitchParameter
Position:Named
Nilai default:None
Diperlukan:True
Terima input alur:False
Terima karakter wildcard:False

-Leaf

Saat menggunakan parameter Leaf , Split-Path hanya mengembalikan item terakhir dalam string jalur yang disediakan, terlepas dari apakah item tersebut adalah file atau direktori.

Jenis:SwitchParameter
Position:Named
Nilai default:None
Diperlukan:True
Terima input alur:True
Terima karakter wildcard: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.

Jenis:SwitchParameter
Position:Named
Nilai default:None
Diperlukan:True
Terima input alur:True
Terima karakter wildcard: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.

Jenis:String[]
Alias:PSPath, LP
Position:Named
Nilai default:None
Diperlukan:True
Terima input alur:True
Terima karakter wildcard: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.

Jenis:SwitchParameter
Position:Named
Nilai default:None
Diperlukan:True
Terima input alur:True
Terima karakter wildcard:False

-Parent

Split-Path hanya mengembalikan bagian kontainer induk dari string jalur yang disediakan. Jika string Jalur tidak berisi kontainer induk, Split-Path mengembalikan string kosong.

Jenis:SwitchParameter
Position:Named
Nilai default:None
Diperlukan:False
Terima input alur:True
Terima karakter wildcard: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.

Jenis:String[]
Position:0
Nilai default:None
Diperlukan:True
Terima input alur:True
Terima karakter wildcard: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:.

Jenis:SwitchParameter
Position:1
Nilai default:None
Diperlukan:True
Terima input alur:True
Terima karakter wildcard:False

-Resolve

Menunjukkan bahwa cmdlet ini menampilkan item yang dirujuk oleh jalur pemisahan yang dihasilkan alih-alih menampilkan elemen jalur.

Jenis:SwitchParameter
Position:Named
Nilai default:None
Diperlukan:False
Terima input alur:False
Terima karakter wildcard:False

Input

String

Anda dapat menyalurkan string yang berisi jalur ke cmdlet ini.

Output

String

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 .

Boolean

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, ketik Get-PSProvider. Untuk informasi selengkapnya, lihat about_Providers.