Split-Path

Modul:

Microsoft.PowerShell.Management Module

Mengembalikan bagian jalur yang ditentukan.

Sintaks

ParentSet (Default)

Split-Path
    [-Path] <String[]>
    [-Parent]
    [-Resolve]
    [-Credential <PSCredential>]
    [-UseTransaction]
    [<CommonParameters>]

NoQualifierSet

Split-Path
    [-Path] <String[]>
    [-NoQualifier]
    [-Resolve]
    [-Credential <PSCredential>]
    [-UseTransaction]
    [<CommonParameters>]

LeafSet

Split-Path
    [-Path] <String[]>
    [-Leaf]
    [-Resolve]
    [-Credential <PSCredential>]
    [-UseTransaction]
    [<CommonParameters>]

QualifierSet

Split-Path
    [-Path] <String[]>
    [-Qualifier]
    [-Resolve]
    [-Credential <PSCredential>]
    [-UseTransaction]
    [<CommonParameters>]

IsAbsoluteSet

Split-Path
    [-Path] <String[]>
    [-Resolve]
    [-IsAbsolute]
    [-Credential <PSCredential>]
    [-UseTransaction]
    [<CommonParameters>]

LiteralPathSet

Split-Path
    -LiteralPath <String[]>
    [-Resolve]
    [-Credential <PSCredential>]
    [-UseTransaction]
    [<CommonParameters>]

Deskripsi

Cmdlet Split-Path 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 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 Resolve, 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 Penyelesaian, 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 menggunakan Split-Path untuk mengembalikan hanya induk jalur yang disimpan dalam variabel $PROFILE bawaan. 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

Nota

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.

Properti parameter

Jenis:	PSCredential
Nilai default:	None
Mendukung wildcard:	False
DontShow:	False

Kumpulan parameter

(All)

Position:	Named
Wajib:	False
Nilai dari alur:	False
Nilai dari alur berdasarkan nama properti:	True
Nilai dari argumen yang tersisa:	False

-IsAbsolute

Menunjukkan bahwa cmdlet ini mengembalikan $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 (..).

Properti parameter

Jenis:	SwitchParameter
Nilai default:	None
Mendukung wildcard:	False
DontShow:	False

Kumpulan parameter

IsAbsoluteSet

Position:	Named
Wajib:	False
Nilai dari alur:	False
Nilai dari alur berdasarkan nama properti:	False
Nilai dari argumen yang tersisa:	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.

Properti parameter

Jenis:	SwitchParameter
Nilai default:	None
Mendukung wildcard:	False
DontShow:	False

Kumpulan parameter

LeafSet

Position:	Named
Wajib:	False
Nilai dari alur:	False
Nilai dari alur berdasarkan nama properti:	True
Nilai dari argumen yang tersisa:	False

-LiteralPath

Menentukan jalur yang akan dipisahkan. Tidak seperti Path, nilai LiteralPath digunakan persis seperti yang diketik. Tidak ada karakter yang ditafsirkan sebagai karakter pengganti. Jika jalur menyertakan karakter escape, bungkus jalur tersebut dalam tanda kutip tunggal. Tanda kutip tunggal memberi tahu PowerShell untuk tidak menginterpretasikan karakter apa pun sebagai urutan escape.

Properti parameter

Jenis:	String[]
Nilai default:	None
Mendukung wildcard:	False
DontShow:	False
Alias:	PSPath

Kumpulan parameter

LiteralPathSet

Position:	Named
Wajib:	True
Nilai dari alur:	False
Nilai dari alur berdasarkan nama properti:	True
Nilai dari argumen yang tersisa:	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, jalur hanya mengembalikan \Test\Logs\Pass1.log.

Properti parameter

Jenis:	SwitchParameter
Nilai default:	None
Mendukung wildcard:	False
DontShow:	False

Kumpulan parameter

NoQualifierSet

Position:	Named
Wajib:	False
Nilai dari alur:	False
Nilai dari alur berdasarkan nama properti:	True
Nilai dari argumen yang tersisa:	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.

Properti parameter

Jenis:	SwitchParameter
Nilai default:	None
Mendukung wildcard:	False
DontShow:	False

Kumpulan parameter

ParentSet

Position:	Named
Wajib:	False
Nilai dari alur:	False
Nilai dari alur berdasarkan nama properti:	True
Nilai dari argumen yang tersisa:	False

-Path

Menentukan jalur yang akan dipisahkan. Karakter pengganti diizinkan. Jika jalur menyertakan spasi, sertakan dalam tanda kutip. Anda juga dapat menyalurkan jalur ke cmdlet ini.

Properti parameter

Jenis:	String[]
Nilai default:	None
Mendukung wildcard:	True
DontShow:	False

Kumpulan parameter

ParentSet

Position:	0
Wajib:	True
Nilai dari alur:	True
Nilai dari alur berdasarkan nama properti:	True
Nilai dari argumen yang tersisa:	False

NoQualifierSet

Position:	0
Wajib:	True
Nilai dari alur:	True
Nilai dari alur berdasarkan nama properti:	True
Nilai dari argumen yang tersisa:	False

LeafSet

Position:	0
Wajib:	True
Nilai dari alur:	True
Nilai dari alur berdasarkan nama properti:	True
Nilai dari argumen yang tersisa:	False

QualifierSet

Position:	0
Wajib:	True
Nilai dari alur:	True
Nilai dari alur berdasarkan nama properti:	True
Nilai dari argumen yang tersisa:	False

IsAbsoluteSet

Position:	0
Wajib:	True
Nilai dari alur:	True
Nilai dari alur berdasarkan nama properti:	True
Nilai dari argumen yang tersisa:	False

-Qualifier

Menunjukkan bahwa cmdlet ini hanya mengembalikan kualifikasi dari jalur yang ditentukan. Untuk penyedia FileSystem atau Registry, kualifikasi adalah drive jalur penyedia, seperti C: atau HKCU:.

Properti parameter

Jenis:	SwitchParameter
Nilai default:	None
Mendukung wildcard:	False
DontShow:	False

Kumpulan parameter

QualifierSet

Position:	1
Wajib:	False
Nilai dari alur:	False
Nilai dari alur berdasarkan nama properti:	True
Nilai dari argumen yang tersisa:	False

-Resolve

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

Properti parameter

Jenis:	SwitchParameter
Nilai default:	None
Mendukung wildcard:	False
DontShow:	False

Kumpulan parameter

(All)

Position:	Named
Wajib:	False
Nilai dari alur:	False
Nilai dari alur berdasarkan nama properti:	False
Nilai dari argumen yang tersisa:	False

-UseTransaction

Menyertakan perintah dalam transaksi aktif. Parameter ini hanya valid ketika transaksi sedang berlangsung. Untuk informasi selengkapnya, lihat about_Transactions.

Properti parameter

Jenis:	SwitchParameter
Nilai default:	False
Mendukung wildcard:	False
DontShow:	False
Alias:	usetx

Kumpulan parameter

(All)

Position:	Named
Wajib:	False
Nilai dari alur:	False
Nilai dari alur berdasarkan nama properti:	False
Nilai dari argumen yang tersisa:	False

CommonParameters

Cmdlet ini mendukung parameter umum: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction, dan -WarningVariable. Untuk informasi selengkapnya, lihat about_CommonParameters.

Input

String

Anda dapat menyalurkan string yang berisi jalur ke cmdlet ini.

Output

String

Cmdlet ini mengembalikan string teks. Saat Anda menentukan parameter Resolve, 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, Leaf, dan NoQualifier) bersifat eksklusif. Anda hanya dapat menggunakan satu di setiap perintah.

• Cmdlet yang berisi kata benda Jalur (cmdlet Path) 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, Bergabung, 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 dalam sesi Anda, ketik Get-PSProvider. Untuk informasi selengkapnya, lihat tentang_Penyedia.

Link Terkait

• Konversi-Jalur
• Join-Path
• Tentukan-Jalur
• Test-Path