Push-Location

  • Referensi
Modul:
Microsoft.PowerShell.Management

Menambahkan lokasi saat ini ke bagian atas tumpukan lokasi.

Sintaks

Push-Location
    [[-Path] <String>]
    [-PassThru]
    [-StackName <String>]
    [<CommonParameters>]
Push-Location
    [-LiteralPath <String>]
    [-PassThru]
    [-StackName <String>]
    [<CommonParameters>]

Deskripsi

Push-Location Cmdlet menambahkan ("mendorong") lokasi saat ini ke tumpukan lokasi. Jika Anda menentukan jalur, Push-Location mendorong lokasi saat ini ke tumpukan lokasi lalu mengubah lokasi saat ini ke lokasi yang ditentukan oleh jalur. Anda dapat menggunakan Pop-Location cmdlet untuk mendapatkan lokasi dari tumpukan lokasi.

Secara default, Push-Location cmdlet mendorong lokasi saat ini ke tumpukan lokasi saat ini, tetapi Anda dapat menggunakan parameter StackName untuk menentukan tumpukan lokasi alternatif. Jika tumpukan tidak ada, Push-Location buatlah.

Untuk informasi selengkapnya tentang tumpukan lokasi, lihat Catatan.

Contoh

Contoh 1

Contoh ini mendorong lokasi saat ini ke tumpukan lokasi default lalu mengubah lokasi menjadi C:\Windows.

PS C:\> Push-Location C:\Windows

Contoh 2

Contoh ini mendorong lokasi saat ini ke tumpukan RegFunction dan mengubah lokasi saat ini ke HKLM:\Software\Policies lokasi.

PS C:\> Push-Location HKLM:\Software\Policies -StackName RegFunction

Anda dapat menggunakan cmdlet Lokasi di drive PowerShell (PSDrive) apa pun.

Contoh 3

Perintah ini mendorong lokasi saat ini ke tumpukan default. Ini tidak mengubah lokasi.

PS C:\> Push-Location

Contoh 4 - Membuat dan menggunakan tumpukan bernama

Perintah ini menunjukkan cara membuat dan menggunakan tumpukan lokasi bernama.

PS C:\> Push-Location ~ -StackName Stack2
PS C:\Users\User01> Pop-Location -StackName Stack2
PS C:\>

Perintah pertama mendorong lokasi saat ini ke tumpukan baru bernama Stack2, lalu mengubah lokasi saat ini ke direktori beranda, yang diwakili dalam perintah oleh simbol tilde (~), yang ketika digunakan pada drive penyedia FileSystem setara dengan $HOME.

Jika Stack2 belum ada dalam sesi, Push-Location buatlah. Perintah kedua menggunakan Pop-Location cmdlet untuk memunculkan lokasi asli (C:\) dari tumpukan Stack2. Tanpa parameter StackName, Pop-Location akan memunculkan lokasi dari tumpukan default yang tidak disebutkan namanya.

Untuk informasi selengkapnya tentang tumpukan lokasi, lihat Catatan.

Parameter

-LiteralPath

Menentukan jalur ke lokasi baru. Tidak seperti parameter Jalur, nilai parameter LiteralPath digunakan persis seperti yang ditik. Tidak ada karakter yang ditafsirkan sebagai 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, LP
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-PassThru

Meneruskan objek yang mewakili lokasi ke alur. 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

Ubah lokasi Anda ke lokasi yang ditentukan oleh jalur ini setelah menambahkan (mendorong) lokasi saat ini ke bagian atas tumpukan. Masukkan jalur ke lokasi mana pun yang penyedianya mendukung cmdlet ini. Kartubebas diizinkan. Nama parameter bersifat opsional.

Type:String
Position:1
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:True

-StackName

Menentukan tumpukan lokasi tempat lokasi saat ini ditambahkan. Masukkan nama tumpukan lokasi. Jika tumpukan tidak ada, Push-Location buatlah.

Tanpa parameter ini, Push-Location menambahkan lokasi ke tumpukan lokasi saat ini. Secara default, tumpukan lokasi saat ini adalah tumpukan lokasi default yang tidak disebutkan namanya yang dibuat PowerShell. Untuk membuat tumpukan lokasi tumpukan lokasi saat ini, gunakan parameter StackName cmdlet Set-Location . Untuk informasi selengkapnya tentang tumpukan lokasi, lihat Catatan.

Catatan

Push-Location tidak dapat menambahkan lokasi ke tumpukan default yang tidak disebutkan namanya kecuali itu adalah tumpukan lokasi saat ini.

Type:String
Position:Named
Default value:Default stack
Required:False
Accept pipeline input:True
Accept wildcard characters:False

Input

String

Anda dapat menyalurkan string yang berisi jalur (tetapi bukan jalur harfiah) ke cmdlet ini.

Output

None

Secara default, cmdlet ini tidak mengembalikan output.

PathInfo

Saat Anda menggunakan parameter PassThru, cmdlet ini mengembalikan objek PathInfo yang mewakili jalur saat ini setelah operasi cmdlet.

Catatan

PowerShell menyertakan alias berikut untuk Push-Location:

  • Semua Platform:
    • pushd

PowerShell mendukung beberapa runspace per proses. Setiap runspace memiliki direktorinya sendiri saat ini. Ini tidak sama [System.Environment]::CurrentDirectorydengan . 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.

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 Set-Location cmdlet untuk mengubah tumpukan lokasi saat ini.

Untuk mengelola tumpukan lokasi, gunakan cmdlet Lokasi PowerShell, 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 cmdlet Get-Location .

  • Untuk membuat tumpukan lokasi baru, gunakan parameter StackName cmdlet Push-Location . Jika Anda menentukan tumpukan yang tidak ada, Push-Location buat 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 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 ("").

Anda juga dapat merujuk Push-Location dengan alias bawaannya, pushd. Untuk informasi selengkapnya, lihat about_Aliases.

Push-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.