Set-Location
Mengatur lokasi kerja saat ini ke lokasi tertentu.
Sintaks
Set-Location
[[-Path] <String>]
[-PassThru]
[-UseTransaction]
[<CommonParameters>]
Set-Location
-LiteralPath <String>
[-PassThru]
[-UseTransaction]
[<CommonParameters>]
Set-Location
[-PassThru]
[-StackName <String>]
[-UseTransaction]
[<CommonParameters>]
Deskripsi
Set-Location
Cmdlet mengatur lokasi kerja ke lokasi tertentu. Lokasi tersebut bisa berupa direktori, subdirektori, lokasi registri, atau jalur penyedia apa pun.
Anda juga dapat menggunakan parameter StackName untuk membuat tumpukan lokasi bernama tumpukan lokasi saat ini. Untuk informasi selengkapnya tentang tumpukan lokasi, lihat Catatan.
Contoh
Contoh 1: Atur lokasi saat ini
PS C:\> Set-Location -Path "HKLM:\"
PS HKLM:\>
Perintah ini mengatur lokasi saat ini ke akar HKLM:
drive.
Contoh 2: Atur lokasi saat ini dan tampilkan lokasi tersebut
PS C:\> Set-Location -Path "Env:\" -PassThru
Path
----
Env:\
PS Env:\>
Perintah ini mengatur lokasi saat ini ke akar Env:
drive. Ini menggunakan parameter PassThru untuk mengarahkan PowerShell untuk mengembalikan objek PathInfo yang mewakili Env:\
lokasi.
Contoh 3: Atur lokasi ke lokasi saat ini di drive C:
PS C:\Windows\> Set-Location HKLM:\
PS HKLM:\> Set-Location C:
PS C:\Windows\>
Perintah pertama mengatur lokasi ke akar HKLM:
drive di penyedia Registri.
Perintah kedua mengatur lokasi ke lokasi C:
drive saat ini di penyedia FileSystem.
Ketika nama drive ditentukan dalam formulir <DriveName>:
(tanpa garis miring terbelakang), cmdlet mengatur lokasi ke lokasi saat ini di PSDrive.
Untuk mendapatkan lokasi saat ini di perintah penggunaan Get-Location -PSDrive <DriveName>
PSDrive.
Contoh 4: Atur lokasi saat ini ke tumpukan bernama
PS C:\> Push-Location -Path 'C:\Program Files\PowerShell\' -StackName "Paths"
PS C:\Program Files\PowerShell\> Set-Location -StackName "Paths"
PS C:\Program Files\PowerShell\> Get-Location -Stack
Path
----
C:\
Perintah pertama menambahkan lokasi saat ini ke tumpukan Jalur. Perintah kedua membuat lokasi Jalur menumpuk tumpukan lokasi saat ini. Perintah ketiga menampilkan lokasi di tumpukan lokasi saat ini.
*-Location
Cmdlet menggunakan tumpukan lokasi saat ini kecuali tumpukan lokasi yang berbeda ditentukan dalam perintah. Untuk informasi tentang tumpukan lokasi, lihat Catatan.
Parameter
-LiteralPath
Menentukan jalur lokasi. Nilai parameter LiteralPath digunakan persis seperti yang ditik. Tidak ada karakter yang ditafsirkan sebagai karakter kartubebas. Jika jalur menyertakan karakter escape, sertakan dalam tanda kutip tunggal. Tanda kutip tunggal memberi tahu PowerShell untuk tidak menginterpretasikan karakter apa pun sebagai urutan escape.
Type: | String |
Aliases: | PSPath |
Position: | Named |
Default value: | None |
Required: | True |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-PassThru
Mengembalikan objek PathInfo yang mewakili lokasi. Secara default, cmdlet ini tidak menghasilkan output apa pun.
Type: | SwitchParameter |
Position: | Named |
Default value: | False |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Path
Tentukan jalur lokasi kerja baru. Jika tidak ada jalur yang disediakan, Set-Location
default ke direktori beranda pengguna saat ini. Ketika kartubebas digunakan, cmdlet memilih kontainer (direktori, kunci registri, penyimpanan sertifikat) yang cocok dengan pola wildcard. Jika pola kartubebas cocok dengan lebih dari satu kontainer, cmdlet mengembalikan kesalahan.
Type: | String |
Position: | 0 |
Default value: | None |
Required: | False |
Accept pipeline input: | True |
Accept wildcard characters: | True |
-StackName
Menentukan nama tumpukan lokasi yang ada bahwa cmdlet ini membuat tumpukan lokasi saat ini. Masukkan nama tumpukan lokasi. Untuk menunjukkan tumpukan lokasi default yang tidak disebutkan namanya, ketik $null
atau string kosong (""
).
Menggunakan parameter ini tidak mengubah lokasi saat ini. Ini hanya mengubah tumpukan yang *-Location
digunakan oleh cmdlet. *-Location
Cmdlet bertindak pada tumpukan saat ini kecuali Anda menggunakan parameter StackName untuk menentukan tumpukan yang berbeda. Untuk informasi selengkapnya tentang tumpukan lokasi, lihat Catatan.
Type: | String |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-UseTransaction
Menyertakan perintah dalam transaksi aktif. Parameter ini hanya valid ketika transaksi sedang berlangsung. Untuk informasi selengkapnya, lihat about_Transactions.
Type: | SwitchParameter |
Aliases: | usetx |
Position: | Named |
Default value: | False |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Input
Anda dapat menyalurkan string yang berisi jalur, tetapi bukan jalur harfiah, ke cmdlet ini.
Output
None
Secara default, cmdlet ini tidak mengembalikan output.
Saat Anda menggunakan parameter PassThru dengan Path atau LiteralPath, cmdlet ini mengembalikan objek PathInfo yang mewakili lokasi baru.
Saat Anda menggunakan parameter PassThru dengan StackName, cmdlet ini mengembalikan objek PathInfoStack yang mewakili konteks tumpukan baru.
Catatan
Windows PowerShell menyertakan alias berikut untuk Set-Location
:
cd
chdir
sl
PowerShell mendukung beberapa runspace per proses. Setiap runspace memiliki direktorinya sendiri saat ini.
Ini tidak sama [System.Environment]::CurrentDirectory
dengan . Perilaku ini dapat menjadi masalah saat memanggil API .NET atau menjalankan aplikasi asli tanpa menyediakan jalur direktori eksplisit.
Bahkan jika cmdlet lokasi memang mengatur direktori saat ini di seluruh proses, Anda tidak dapat bergantung padanya karena runspace lain mungkin mengubahnya kapan saja. Anda harus menggunakan cmdlet lokasi untuk melakukan operasi berbasis jalur menggunakan direktori kerja saat ini khusus untuk runspace saat ini.
Set-Location
Cmdlet dirancang untuk bekerja dengan data yang diekspos oleh penyedia mana pun. Untuk mencantumkan penyedia yang tersedia di sesi Anda, ketik Get-PSProvider
. Untuk informasi selengkapnya, lihat about_Providers.
Tumpukan adalah daftar terakhir masuk dan keluar pertama 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. 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 Set-Location
cmdlet untuk mengubah tumpukan lokasi saat ini.
Untuk mengelola tumpukan lokasi, gunakan *-Location
cmdlet, sebagai berikut:
Untuk menambahkan lokasi ke tumpukan lokasi, gunakan
Push-Location
cmdlet.Untuk mendapatkan lokasi dari tumpukan lokasi, gunakan
Pop-Location
cmdlet.Untuk menampilkan lokasi di tumpukan lokasi saat ini, gunakan parameter
Get-Location
Tumpukan cmdlet. Untuk menampilkan lokasi dalam tumpukan lokasi bernama, gunakan parameter StackName dariGet-Location
.Untuk membuat tumpukan lokasi baru, gunakan parameter StackName dari
Push-Location
. Jika Anda menentukan tumpukan yang tidak ada,Push-Location
buat tumpukan.Untuk membuat tumpukan lokasi tumpukan lokasi saat ini, gunakan parameter StackName dari
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 Get-Location
cmdlet untuk menampilkan lokasi di tumpukan yang tidak disebutkan namanya. Untuk membuat tumpukan yang tidak disebutkan namanya menjadi tumpukan saat ini, gunakan parameter StackName cmdlet Set-Location
dengan nilai $null
atau string kosong (""
).
Link Terkait
Saran dan Komentar
https://aka.ms/ContentUserFeedback.
Segera hadir: Sepanjang tahun 2024 kami akan menghentikan penggunaan GitHub Issues sebagai mekanisme umpan balik untuk konten dan menggantinya dengan sistem umpan balik baru. Untuk mengetahui informasi selengkapnya, lihat:Kirim dan lihat umpan balik untuk