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.

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

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.