Bagikan melalui

Resolve-Path

Modul:
Microsoft.PowerShell.Management Module

Menyelesaikan karakter kartubebas dalam jalur, dan menampilkan konten jalur.

Sintaks

Path (Default) 

Resolve-Path
    [-Path] <string[]>
    [-Relative]
    [-RelativeBasePath <string>]
    [-Credential <pscredential>]
    [<CommonParameters>]

LiteralPath 

Resolve-Path
    -LiteralPath <string[]>
    [-Relative]
    [-RelativeBasePath <string>]
    [-Credential <pscredential>]
    [<CommonParameters>]

Deskripsi

Cmdlet Resolve-Path menampilkan item dan kontainer yang cocok dengan pola kartubebas di lokasi yang ditentukan. Kecocokan dapat mencakup file, folder, kunci registri, atau objek lain yang dapat diakses dari penyedia PSDrive.

Contoh

Contoh 1: Mengatasi jalur folder utama

Karakter tilde (~) adalah notasi singkat untuk folder utama pengguna saat ini. Contoh ini menunjukkan Resolve-Path mengembalikan nilai jalur yang sepenuhnya memenuhi syarat.

Resolve-Path ~

Path
----
C:\Users\User01

Contoh 2: Mengatasi jalur folder Windows

Resolve-Path -Path "windows"

Path
----
C:\Windows

Saat dijalankan dari akar drive C:, perintah ini mengembalikan jalur folder Windows di drive C:.

Contoh 3: Dapatkan semua jalur di folder Windows

"C:\windows\*" | Resolve-Path

Perintah ini mengembalikan semua file dan folder di folder C:\Windows. Perintah menggunakan operator alur (|) untuk mengirim string jalur ke Resolve-Path.

Contoh 4: Mengatasi jalur UNC

Resolve-Path -Path "\\Server01\public"

Perintah ini menyelesaikan jalur Universal Naming Convention (UNC) dan mengembalikan berbagi di jalur .

Contoh 5: Mendapatkan jalur relatif

Resolve-Path -Path "C:\prog*" -Relative

.\Program Files
.\Program Files (x86)
.\programs.txt

Perintah ini mengembalikan jalur relatif untuk direktori di akar drive C:.

Contoh 6: Mengatasi jalur yang berisi tanda kurung siku

Contoh ini menggunakan parameter LiteralPath untuk menyelesaikan jalur subfolder Test[xml]. Menggunakan LiteralPath menyebabkan tanda kurung diperlakukan sebagai karakter normal daripada ekspresi reguler.

Resolve-Path -LiteralPath 'test[xml]'

Contoh 7: Mengatasi jalur relatif terhadap folder lain

Contoh ini menggunakan parameter RelativeBasePath untuk menyelesaikan jalur pwsh dapat dieksekusi relatif terhadap $Env:TEMP. Saat perintah menyertakan parameter sakelar Relatif, perintah mengembalikan string mewakili jalur relatif dari $Env:TEMP ke pwsh dapat dieksekusi.

$ExecutablePath = Get-Command -Name pwsh | Select-Object -ExpandProperty Source
Resolve-Path -Path $ExecutablePath -RelativeBasePath $Env:TEMP -Relative

..\..\..\..\..\Program Files\PowerShell\7\pwsh.exe

Parameter

-Credential

Menentukan akun pengguna yang memiliki izin untuk melakukan tindakan ini. Defaultnya adalah pengguna saat ini.

Ketik nama pengguna, seperti User01 atau Domain01\User01, atau berikan objek PSCredential. Anda dapat membuat objek PSCredential menggunakan cmdlet . Jika Anda mengetik nama pengguna, cmdlet ini akan meminta kata sandi kepada Anda.

Parameter ini tidak didukung oleh penyedia apa pun yang diinstal dengan PowerShell.

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

-LiteralPath

Menentukan jalur yang akan diselesaikan. Nilai parameter LiteralPath digunakan persis seperti yang ditik. Tidak ada karakter yang ditafsirkan sebagai karakter pengganti. Jika jalur menyertakan karakter escape, letakkan 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

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 untuk diselesaikan. Parameter ini diperlukan. Anda juga dapat menyalurkan string jalur ke Resolve-Path. Karakter pengganti diizinkan.

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

-Relative

Menunjukkan bahwa cmdlet ini mengembalikan jalur relatif.

Properti parameter

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

Kumpulan parameter

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

-RelativeBasePath

Menentukan jalur untuk menyelesaikan jalur relatif. Saat Anda menggunakan parameter ini, cmdlet mengembalikan objek System.Management.Automation.PathInfo untuk jalur yang diselesaikan.

Saat Anda menggunakan parameter ini dengan parameter sakelar Relatif, cmdlet mengembalikan string yang mewakili jalur relatif dari RelativeBasePath ke Jalur .

Parameter ini ditambahkan di PowerShell 7.4.

Properti parameter

Jenis:String
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

PathInfo

Secara default, cmdlet ini mengembalikan objek PathInfo.

String

Jika Anda menentukan parameter Relatif, cmdlet ini mengembalikan nilai string untuk jalur yang diselesaikan.

Catatan

PowerShell menyertakan alias berikut untuk Resolve-Path:

  • Semua platform:
    • rvpa

Cmdlet *-Path berfungsi dengan FileSystem, Registri, dan penyedia Sertifikat.

Resolve-Path dirancang untuk bekerja dengan penyedia apa pun. Untuk mencantumkan penyedia yang tersedia dalam sesi Anda, ketik Get-PSProvider. Untuk informasi selengkapnya, lihat tentang_Penyedia.

Resolve-Path hanya menyelesaikan jalur yang ada. Ini tidak dapat digunakan untuk mengatasi lokasi yang belum ada.