Bagikan melalui


Convert-Path

Mengonversi jalur dari jalur PowerShell ke jalur penyedia PowerShell.

Sintaks

Path (Default)

Convert-Path
    [-Path] <String[]>
    [-UseTransaction]
    [<CommonParameters>]

LiteralPath

Convert-Path
    -LiteralPath <String[]>
    [-UseTransaction]
    [<CommonParameters>]

Deskripsi

Cmdlet Convert-Path mengonversi jalur dari jalur PowerShell ke jalur penyedia PowerShell.

Contoh

Contoh 1: Mengonversi direktori kerja ke jalur sistem file standar

Contoh ini mengonversi direktori kerja saat ini, yang diwakili oleh titik (.), ke jalur FileSystem standar.

PS C:\> Convert-Path .
C:\

Contoh 2: Mengonversi jalur penyedia ke jalur registri standar

Contoh ini mengonversi jalur penyedia PowerShell ke jalur registri standar.

PS C:\> Convert-Path HKLM:\Software\Microsoft
HKEY_LOCAL_MACHINE\Software\Microsoft

Contoh 3: Mengonversi jalur ke string

Contoh ini mengonversi jalur ke direktori beranda penyedia saat ini, yang merupakan penyedia FileSystem, menjadi string.

PS C:\> Convert-Path ~
C:\Users\User01

Parameter

-LiteralPath

Menentukan, sebagai array string, jalur yang akan dikonversi. Nilai parameter LiteralPath digunakan persis seperti yang diketik. Tidak ada karakter yang ditafsirkan sebagai wildcard. 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.

Untuk informasi lebih lanjut, lihat about_Quoting_Rules.

Properti parameter

Jenis:

String[]

Nilai default:None
Mendukung wildcard:False
DontShow:False
Alias:PSPath

Kumpulan parameter

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

-Path

Menentukan jalur PowerShell yang akan dikonversi.

Properti parameter

Jenis:

String[]

Nilai default:None
Mendukung wildcard:True
DontShow:False

Kumpulan parameter

Path
Position:0
Wajib:True
Nilai dari alur:True
Nilai dari alur berdasarkan nama properti:True
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 jalur, tetapi bukan jalur literal, ke cmdlet ini.

Output

String

Cmdlet ini mengembalikan string yang berisi jalur yang dikonversi.

Catatan

Windows PowerShell menyertakan alias berikut untuk Convert-Path:

  • cvpa

Cmdlet yang berisi kata benda Jalur memanipulasi nama jalur dan mengembalikannya dalam format ringkas yang dapat ditafsirkan oleh semua penyedia PowerShell. Mereka dirancang untuk digunakan dalam program dan skrip tempat Anda ingin menampilkan semua atau sebagian jalur dalam format tertentu. Gunakan seperti Anda menggunakan Dirname, Normpath, Realpath, Join, atau pengelola jalur lainnya.

Anda dapat menggunakan cmdlet jalur dengan beberapa penyedia, termasuk FileSystem, Registri, dan Sertifikat.

Cmdlet ini 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.

Convert-Path hanya mengonversi jalur yang ada. Ini tidak dapat digunakan untuk mengonversi lokasi yang belum ada.