Bagikan melalui

Push-Location

Modul:
Microsoft.PowerShell.Management Module

Menambahkan lokasi saat ini ke bagian atas tumpukan lokasi.

Sintaks

Path (Default) 

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

LiteralPath 

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

Deskripsi

cmdlet Push-Location menambahkan ("pushes") 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 cmdlet Pop-Location untuk mendapatkan lokasi dari tumpukan lokasi.

Secara default, cmdlet Push-Location 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 membuatnya.

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 lokasi HKLM:\Software\Policies.

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 membuatnya. Perintah kedua menggunakan cmdlet Pop-Location 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 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.

Properti parameter

Jenis:String
Nilai default:None
Mendukung wildcard:False
DontShow:False
Alias:PSPath, LP

Kumpulan parameter

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

-PassThru

Meneruskan objek yang mewakili lokasi ke alur. Secara default, cmdlet ini tidak menghasilkan output apa pun.

Properti parameter

Jenis:SwitchParameter
Nilai default:False
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

-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. Kartu liar diizinkan. Nama parameter bersifat opsional.

Properti parameter

Jenis:String
Nilai default:None
Mendukung wildcard:True
DontShow:False

Kumpulan parameter

Path
Position:1
Wajib:False
Nilai dari alur:True
Nilai dari alur berdasarkan nama properti:True
Nilai dari argumen yang tersisa:False

-StackName

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

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 .

Nota

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

Properti parameter

Jenis:String
Nilai default:Default stack
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

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

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

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

  • Untuk membuat tumpukan lokasi baru, gunakan parameter StackName cmdlet Push-Location. Jika Anda menentukan tumpukan yang tidak ada, Push-Location membuat 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 cmdlet Push-Location atau Pop-Location untuk menambahkan atau mendapatkan item dari tumpukan default atau menggunakan cmdlet Get-Location 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 ("").

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

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