Push-Location

Başvuru

Modül:: Microsoft.PowerShell.Management

Geçerli konumu bir konum yığınının en üstüne ekler.

Sözdizimi

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

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

Description

Push-Location cmdlet'i geçerli konumu bir konum yığınına ekler ("gönderimler"). Bir yol belirtirseniz, Push-Location geçerli konumu bir konum yığınına iter ve geçerli konumu yol tarafından belirtilen konuma değiştirir. Konum yığınından konumları almak için Pop-Location cmdlet'ini kullanabilirsiniz.

Varsayılan olarak, Push-Location cmdlet'i geçerli konumu geçerli konum yığınına iter, ancak alternatif bir konum yığını belirtmek için StackName parametresini kullanabilirsiniz. Yığın yoksa Push-Location oluşturur.

Konum yığınları hakkında daha fazla bilgi için bkz. Notlar.

Örnekler

Örnek 1

Bu örnek, geçerli konumu varsayılan konum yığınına iletir ve ardından konumu C:\Windowsolarak değiştirir.

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

Örnek 2

Bu örnek geçerli konumu RegFunction yığınına iletir ve geçerli konumu HKLM:\Software\Policies konumuna değiştirir.

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

Konum cmdlet'lerini herhangi bir PowerShell sürücüsünde (PSDrive) kullanabilirsiniz.

Örnek 3

Bu komut geçerli konumu varsayılan yığına iletir. Konumu değiştirmez.

PS C:\> Push-Location

Örnek 4 - Adlandırılmış yığın oluşturma ve kullanma

Bu komutlar, adlandırılmış konum yığını oluşturma ve kullanma hakkında bilgi sağlar.

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

İlk komut geçerli konumu Stack2 adlı yeni bir yığına iletir ve ardından geçerli konumu, bir FileSystem sağlayıcı sürücülerinde kullanıldığında $HOMEeşdeğer olan tilde simgesiyle (~) komutta temsil edilen giriş dizinine değiştirir.

Stack2 oturumda zaten yoksa Push-Location oluşturur. İkinci komut, Stack2 yığınından özgün konumu (C:\) açmak için Pop-Location cmdlet'ini kullanır. StackName parametresi olmadan, Pop-Location adsız varsayılan yığından konumu açar.

Konum yığınları hakkında daha fazla bilgi için bkz. Notlar.

Parametreler

-LiteralPath

Yeni konumun yolunu belirtir. Path parametresinden farklı olarak, LiteralPath parametresinin değeri tam olarak yazıldığı gibi kullanılır. Hiçbir karakter joker karakter olarak yorumlanmamıştır. Yol kaçış karakterleri içeriyorsa, tek tırnak içine alın. Tek tırnak işaretleri PowerShell'e hiçbir karakteri kaçış dizisi olarak yorumlamaması gerektiğini söyler.

Tür:	String
Diğer adlar:	PSPath, LP
Position:	Named
Default value:	None
Gerekli:	False
İşlem hattı girişini kabul et:	True
Joker karakterleri kabul et:	False

-PassThru

Konumu temsil eden bir nesneyi işlem hattına geçirir. Varsayılan olarak, bu cmdlet herhangi bir çıkış oluşturmaz.

Tür:	SwitchParameter
Position:	Named
Default value:	False
Gerekli:	False
İşlem hattı girişini kabul et:	False
Joker karakterleri kabul et:	False

-Path

Geçerli konumu yığının üstüne ekledikten (gönderdikten) sonra konumunuzu bu yol tarafından belirtilen konuma değiştirir. Sağlayıcısı bu cmdlet'i destekleyen herhangi bir konumun yolunu girin. Joker karakterlere izin verilir. Parametre adı isteğe bağlıdır.

Tür:	String
Position:	1
Default value:	None
Gerekli:	False
İşlem hattı girişini kabul et:	True
Joker karakterleri kabul et:	True

-StackName

Geçerli konumun eklendiği konum yığınını belirtir. Konum yığını adı girin. Yığın yoksa Push-Location oluşturur.

Bu parametre olmadan Push-Location geçerli konum yığınına konumu ekler. Varsayılan olarak, geçerli konum yığını PowerShell'in oluşturduğu adsız varsayılan konum yığınıdır. Konum yığınını geçerli konum yığını yapmak için Set-Location cmdlet'in StackName parametresini kullanın. Konum yığınları hakkında daha fazla bilgi için bkz. Notlar.

Not

Push-Location, geçerli konum yığını olmadığı sürece adsız varsayılan yığına konum ekleyemez.

Tür:	String
Position:	Named
Default value:	Default stack
Gerekli:	False
İşlem hattı girişini kabul et:	True
Joker karakterleri kabul et:	False

Girişler

String

Bu cmdlet'e yol içeren bir dizeyi (değişmez değer yolu değil) yöneltebilirsiniz.

Çıkışlar

None

Varsayılan olarak, bu cmdlet çıkış döndürmez.

PathInfo

PassThru parametresini kullandığınızda, bu cmdlet cmdlet'in işleminden sonraki geçerli yolu temsil eden bir PathInfo nesnesi döndürür.

Notlar

PowerShell, Push-Locationiçin aşağıdaki diğer adları içerir:

Tüm Platformlar:
- pushd

PowerShell, işlem başına birden çok çalışma alanı destekler. Her çalışma alanının kendi geçerli dizinivardır. Bu, [System.Environment]::CurrentDirectoryile aynı değildir. Bu davranış, açık dizin yolları sağlamadan .NET API'lerini çağırırken veya yerel uygulamalar çalıştırırken sorun olabilir.

Konum cmdlet'leri işlem genelinde geçerli dizini ayarlamış olsa bile, başka bir çalışma alanı bunu istediği zaman değiştirebileceğinden buna bağımlı olamazsınız. Geçerli çalışma alanına özgü geçerli çalışma dizinini kullanarak yol tabanlı işlemler gerçekleştirmek için konum cmdlet'lerini kullanmalısınız.

Yığın, yalnızca en son eklenen öğenin erişilebildiği, son eklenen ilk çıkış listesidir. Öğeleri kullandığınız sırayla bir yığına ekler ve sonra bunları ters sırada kullanmak üzere alırsınız. PowerShell, sağlayıcı konumlarını konum yığınlarında depolamanıza olanak tanır.

PowerShell adlandırılmamış bir varsayılan konum yığını oluşturur ve birden çok adlandırılmış konum yığını oluşturabilirsiniz. Bir yığın adı belirtmezseniz PowerShell geçerli konum yığınını kullanır. Varsayılan olarak, adsız varsayılan konum geçerli konum yığınıdır, ancak geçerli konum yığınını değiştirmek için Set-Location cmdlet'ini kullanabilirsiniz.

Konum yığınlarını yönetmek için PowerShell Konumu cmdlet'lerini aşağıdaki gibi kullanın.

Konum yığınına konum eklemek için Push-Location cmdlet'ini kullanın.
Konum yığınından konum almak için Pop-Location cmdlet'ini kullanın.
Geçerli konum yığınındaki konumları görüntülemek için Get-Location cmdlet'in Stack parametresini kullanın.
Konumları adlandırılmış bir konum yığınında görüntülemek için Get-Location cmdlet'in StackName parametresini kullanın.
Yeni bir konum yığını oluşturmak için Push-Location cmdlet'in StackName parametresini kullanın. Mevcut olmayan bir yığın belirtirseniz, Push-Location yığını oluşturur.
Konum yığınını geçerli konum yığını yapmak için Set-Location cmdlet'in StackName parametresini kullanın.

Adsız varsayılan konum yığınına yalnızca geçerli konum yığını olduğunda tam olarak erişilebilir. Adlandırılmış bir konum yığınını geçerli konum yığını yaparsanız, artık Push-Location veya Pop-Location cmdlet'lerini kullanarak varsayılan yığından öğe ekleyemez veya alamaz ya da adsız yığındaki konumları görüntülemek için Get-Location cmdlet'ini kullanamazsınız. Adsız yığını geçerli yığın yapmak için, Set-Location cmdlet'in StackName parametresini $null veya boş bir dize ("") değeriyle kullanın.

ayrıca Push-Location yerleşik diğer adı olan pushdile de başvurabilirsiniz. Daha fazla bilgi için bkz. about_Aliases.

Push-Location cmdlet'i herhangi bir sağlayıcı tarafından kullanıma sunulan verilerle çalışacak şekilde tasarlanmıştır. Oturumunuzda kullanılabilen sağlayıcıları listelemek için Get-PSProvideryazın. Daha fazla bilgi için bkz. about_Providers.