Split-Path

Modul:

Microsoft.PowerShell.Management Module

Mengembalikan bagian jalur yang ditentukan.

Sintaks

ParentSet (Default)

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

LeafSet

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

LeafBaseSet

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

ExtensionSet

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

QualifierSet

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

NoQualifierSet

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

IsAbsoluteSet

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

LiteralPathSet

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

Deskripsi

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 Resolve memberi tahu Split-Path untuk menampilkan item yang direferensikan jalur terpisah, alih-alih menampilkan jalur terpisah.

Seperti semua Split-Path perintah, perintah ini mengembalikan string. Ini tidak mengembalikan fileInfo objek yang mewakili file.

Contoh 3: Mendapatkan kontainer induk

Split-Path -Path "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 pemisahan, 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 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 dengan 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

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

-Extension

Menunjukkan bahwa cmdlet ini hanya mengembalikan ekstensi daun. Misalnya, di jalur C:\Test\Logs\Pass1.log, jalur hanya mengembalikan .log.

Parameter ini diperkenalkan di PowerShell 6.0.

Properti parameter

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

Kumpulan parameter

ExtensionSet

Position:	Named
Wajib:	True
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 jalur bersifat absolut dan $False jika relatif. Jalur absolut memiliki panjang lebih besar dari nol dan tidak menggunakan titik (.) untuk menunjukkan jalur saat ini.

Properti parameter

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

Kumpulan parameter

IsAbsoluteSet

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

-Leaf

Menunjukkan bahwa cmdlet ini hanya mengembalikan item atau kontainer terakhir di jalur. Misalnya, di jalur C:\Test\Logs\Pass1.log, jalur hanya mengembalikan Pass1.log.

Properti parameter

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

Kumpulan parameter

LeafSet

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

-LeafBase

Menunjukkan bahwa cmdlet ini hanya mengembalikan nama dasar daun. Misalnya, di jalur C:\Test\Logs\Pass1.log, jalur hanya mengembalikan Pass1.

Parameter ini diperkenalkan di PowerShell 6.0.

Properti parameter

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

Kumpulan parameter

LeafBaseSet

Position:	Named
Wajib:	True
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, LP

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:	True
Nilai dari alur:	False
Nilai dari alur berdasarkan nama properti:	True
Nilai dari argumen yang tersisa:	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, ia mengembalikan C:\Test\Logs. Parameter Induk adalah parameter lokasi terpisah default.

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

LeafSet

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

LeafBaseSet

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

ExtensionSet

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

NoQualifierSet

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 registri, 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:	True
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

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

System.String, System.Boolean

Split-Path mengembalikan string teks. Saat Anda menentukan parameter Resolve , Split-Path mengembalikan string yang menjelaskan lokasi item; parameter tersebut tidak mengembalikan objek yang mewakili item, seperti objek FileInfo atau RegistryKey .

Saat Anda menentukan parameter IsAbsolut,Split-Path mengembalikan nilai Boolean .

Catatan

• Parameter lokasi terpisah (Kualifikasi, Induk, Ekstensi, Leaf, LeafBase, 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