Get-Location
Mendapatkan informasi tentang lokasi kerja saat ini atau tumpukan lokasi.
Sintaks
Location (Default)
Get-Location
[-PSProvider <String[]>]
[-PSDrive <String[]>]
[<CommonParameters>]
Stack
Get-Location
[-Stack]
[-StackName <String[]>]
[<CommonParameters>]
Deskripsi
Get-Location Cmdlet mendapatkan objek yang mewakili direktori saat ini, sama seperti perintah print working directory (pwd).
Saat Anda berpindah di antara drive PowerShell, PowerShell mempertahankan lokasi Anda di setiap drive. Anda dapat menggunakan cmdlet ini untuk menemukan lokasi Anda di setiap drive.
Anda dapat menggunakan cmdlet ini untuk mendapatkan direktori saat ini pada waktu proses dan menggunakannya dalam fungsi dan skrip, seperti dalam fungsi yang menampilkan direktori saat ini di prompt PowerShell.
Anda juga dapat menggunakan cmdlet ini untuk menampilkan lokasi dalam tumpukan lokasi. Untuk informasi selengkapnya, lihat Catatan dan deskripsi parameter Stack dan StackName .
Contoh
Contoh 1: Menampilkan lokasi drive Anda saat ini
Perintah ini menampilkan lokasi Anda di drive PowerShell saat ini.
PS C:\Windows> Get-Location
Path
----
C:\Windows
Misalnya, jika Anda berada di Windows direktori C: drive, itu menampilkan jalur ke direktori tersebut.
Contoh 2: Menampilkan lokasi Anda saat ini untuk drive yang berbeda
Contoh ini menunjukkan penggunaan Get-Location untuk menampilkan lokasi Anda saat ini di drive PowerShell yang berbeda.
Set-Location digunakan untuk mengubah lokasi ke beberapa jalur berbeda di PSDrive yang berbeda.
PS C:\> Set-Location C:\Windows
PS C:\Windows> Set-Location HKLM:\Software\Microsoft
PS HKLM:\Software\Microsoft> Set-Location "HKCU:\Control Panel\Input Method"
PS HKCU:\Control Panel\Input Method> Get-Location -PSDrive C
Path
----
C:\Windows
PS HKCU:\Control Panel\Input Method> Get-Location -PSDrive HKLM
Path
----
HKLM:\Software\Microsoft
PS HKCU:\Control Panel\Input Method> Set-Location C:
PS C:\Windows> Get-Location -PSProvider Registry
Path
----
HKCU:\Control Panel\Input Method
Contoh 3: Mendapatkan lokasi menggunakan tumpukan
Contoh ini menunjukkan cara menggunakan parameter Stack dan StackName untuk Get-Location mencantumkan lokasi di tumpukan lokasi saat ini dan tumpukan lokasi alternatif.
Push-Location Cmdlet digunakan untuk mengubah menjadi tiga lokasi yang berbeda. Dorongan ketiga menggunakan nama tumpukan yang berbeda. Parameter Get-LocationTumpukan menampilkan konten tumpukan default. Parameter Get-LocationStackName menampilkan konten tumpukan bernama Stack2.
PS C:\> Push-Location C:\Windows
PS C:\Windows>Push-Location System32
PS C:\Windows\System32>Push-Location WindowsPowerShell -StackName Stack2
C:\Windows\System32\WindowsPowerShell>Get-Location -Stack
Path
----
C:\Windows
C:\
C:\Windows\System32\WindowsPowerShell>Get-Location -StackName Stack2
Path
----
C:\Windows\System32
Contoh 4: Sesuaikan prompt PowerShell
Contoh ini memperlihatkan cara mengkustomisasi perintah PowerShell.
PS C:\>
function prompt { 'PowerShell: ' + (Get-Location) + '> '}
PowerShell: C:\>
Fungsi yang menentukan perintah menyertakan Get-Location perintah, yang dijalankan setiap kali perintah muncul di konsol.
Format perintah PowerShell default ditentukan oleh fungsi khusus bernama prompt. Anda dapat mengubah perintah di konsol dengan membuat fungsi baru bernama prompt.
Untuk melihat fungsi prompt saat ini, ketik perintah berikut: Get-Content Function:\prompt
Parameter
-PSDrive
Mendapatkan lokasi saat ini di drive PowerShell yang ditentukan.
Misalnya, jika Anda berada di Cert: drive, Anda dapat menggunakan parameter ini untuk menemukan lokasi Anda saat ini di C: drive.
Properti parameter
| Jenis: | String[] |
| Nilai default: | None |
| Mendukung wildcard: | False |
| DontShow: | False |
Kumpulan parameter
Location
| Position: | Named |
| Wajib: | False |
| Nilai dari alur: | False |
| Nilai dari alur berdasarkan nama properti: | True |
| Nilai dari argumen yang tersisa: | False |
-PSProvider
Mendapatkan lokasi saat ini di drive yang didukung oleh penyedia PowerShell yang ditentukan. Jika penyedia yang ditentukan mendukung lebih dari satu drive, cmdlet ini mengembalikan lokasi pada drive yang paling baru diakses.
Misalnya, jika Anda berada di C: drive, Anda dapat menggunakan parameter ini untuk menemukan lokasi Anda saat ini di drive penyedia Registri PowerShell.
Properti parameter
| Jenis: | String[] |
| Nilai default: | None |
| Mendukung wildcard: | False |
| DontShow: | False |
Kumpulan parameter
Location
| Position: | Named |
| Wajib: | False |
| Nilai dari alur: | False |
| Nilai dari alur berdasarkan nama properti: | True |
| Nilai dari argumen yang tersisa: | False |
-Stack
Menunjukkan bahwa cmdlet ini menampilkan lokasi yang ditambahkan ke tumpukan lokasi saat ini. Anda dapat menambahkan lokasi ke tumpukan dengan menggunakan Push-Location cmdlet.
Untuk menampilkan lokasi di tumpukan lokasi yang berbeda, gunakan parameter StackName . Untuk informasi tentang tumpukan lokasi, lihat Catatan.
Properti parameter
| Jenis: | SwitchParameter |
| Nilai default: | None |
| Mendukung wildcard: | False |
| DontShow: | False |
Kumpulan parameter
Stack
| Position: | Named |
| Wajib: | False |
| Nilai dari alur: | False |
| Nilai dari alur berdasarkan nama properti: | False |
| Nilai dari argumen yang tersisa: | False |
-StackName
Menentukan, sebagai array string, tumpukan lokasi yang disebutkan. Masukkan satu atau beberapa nama tumpukan lokasi.
Untuk menampilkan lokasi dalam tumpukan lokasi saat ini, gunakan parameter Stack . Untuk membuat tumpukan lokasi tumpukan lokasi saat ini, gunakan Set-Location cmdlet.
Cmdlet ini tidak dapat menampilkan lokasi dalam tumpukan default yang tidak disebutkan namanya kecuali itu adalah tumpukan saat ini.
Properti parameter
| Jenis: | String[] |
| Nilai default: | None |
| Mendukung wildcard: | False |
| DontShow: | False |
Kumpulan parameter
Stack
| Position: | Named |
| Wajib: | False |
| Nilai dari alur: | False |
| Nilai dari alur berdasarkan nama properti: | True |
| 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
None
Anda tidak dapat menyalurkan objek ke cmdlet ini.
Output
PathInfo
Secara default, cmdlet ini mengembalikan objek PathInfo.
PathInfoStack
Saat Anda menggunakan parameter Stack atau StackName , cmdlet ini mengembalikan objek PathInfoStack .
Catatan
PowerShell menyertakan alias berikut untuk Get-Location:
Semua Platform:
glpwd
PowerShell mendukung beberapa runspace per proses. Setiap runspace memiliki direktori saat ini sendiri .
Ini tidak sama dengan [System.Environment]::CurrentDirectory. Perilaku ini dapat menjadi masalah saat memanggil API .NET atau menjalankan aplikasi asli tanpa menyediakan jalur direktori eksplisit.
Get-Location Cmdlet mengembalikan direktori saat ini dari runspace PowerShell saat ini.
Cmdlet ini dirancang untuk bekerja dengan data yang diekspos oleh penyedia mana pun. Untuk mencantumkan penyedia dalam sesi Anda, ketik Get-PSProvider. Untuk informasi selengkapnya, lihat tentang_Penyedia.
Cara parameter PSProvider, PSDrive, Stack, danStackName berinteraksi bergantung pada penyedia. Beberapa kombinasi akan mengakibatkan kesalahan, seperti menentukan drive dan penyedia yang tidak mengekspos drive tersebut. Jika tidak ada parameter yang ditentukan, cmdlet ini mengembalikan objek PathInfo untuk penyedia yang berisi lokasi kerja saat ini.
Tumpukan adalah daftar first-out terakhir di mana hanya item yang terakhir ditambahkan yang dapat diakses. Anda menambahkan item ke tumpukan dalam urutan yang Anda gunakan, lalu mengambilnya untuk digunakan dalam urutan terbalik. PowerShell memungkinkan Anda menyimpan lokasi penyedia di tumpukan lokasi. PowerShell membuat tumpukan lokasi default yang tidak disebutkan namanya dan Anda dapat membuat beberapa tumpukan lokasi bernama. Jika Anda tidak menentukan nama tumpukan, PowerShell menggunakan tumpukan lokasi saat ini. Secara default, lokasi default yang tidak disebutkan namanya adalah tumpukan lokasi saat ini, tetapi Anda dapat menggunakan cmdlet Set-Location untuk mengubah tumpukan lokasi saat ini.
Untuk mengelola tumpukan lokasi, gunakan cmdlet PowerShell *-Location , sebagai berikut.
Untuk menambahkan lokasi ke tumpukan lokasi, gunakan cmdlet
Push-Location.Untuk mendapatkan lokasi dari tumpukan lokasi, gunakan cmdlet
Pop-Location.Untuk menampilkan lokasi di tumpukan lokasi saat ini, gunakan parameter Stack cmdlet
Get-Location. Untuk menampilkan lokasi dalam tumpukan lokasi bernama, gunakan parameter StackName cmdletGet-Location.Untuk membuat tumpukan lokasi baru, gunakan parameter StackName cmdlet
Push-Location. Jika Anda menentukan tumpukan yang tidak ada,Push-Locationmembuat tumpukan.Untuk membuat tumpukan lokasi tumpukan lokasi saat ini, gunakan parameter StackName cmdlet
Set-Location.
Tumpukan lokasi default yang tidak disebutkan namanya hanya dapat diakses sepenuhnya ketika tumpukan lokasi saat ini.
Jika Anda membuat tumpukan lokasi bernama tumpukan lokasi saat ini, Anda tidak dapat lagi menggunakan Push-Location cmdlet atau Pop-Location untuk menambahkan atau mendapatkan item dari tumpukan default atau menggunakan cmdlet ini untuk menampilkan lokasi di tumpukan yang tidak disebutkan namanya. Untuk membuat tumpukan yang tidak disebutkan namanya sebagai tumpukan saat ini, gunakan parameter StackName cmdlet Set-Location dengan nilai $null atau string kosong ("").
