Push-Location

  • Başvuru
Modül:
Microsoft.PowerShell.Management

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

Syntax

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

Description

Cmdlet, Push-Location 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 Pop-Location konumları almak için cmdlet'ini kullanabilirsiniz.

Varsayılan olarak, Push-Location cmdlet 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 bunu 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 olarak C:\Windowsdeğ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 konuma 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 komutta tilde simgesi ()~ ile temsil edilen giriş dizinine $HOMEdeğiştirir. Bu, FileSystem sağlayıcı sürücülerinde kullanıldığında ile eşdeğerdir.

Stack2 oturumda zaten yoksa oluşturur Push-Location . İkinci komut, Stack2 yığınından özgün konumu (C:\) açmak için cmdlet'ini kullanırPop-Location. 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.

Type:String
Aliases:PSPath, LP
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-PassThru

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

Type:SwitchParameter
Position:Named
Default value:False
Required:False
Accept pipeline input:False
Accept wildcard characters: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.

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

-StackName

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

Bu parametre olmadan konumu Push-Location geçerli konum yığınına 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 cmdlet'in StackName parametresini Set-Location kullanın. Konum yığınları hakkında daha fazla bilgi için bkz . Notlar.

Dekont

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

Type:String
Position:Named
Default value:Default stack
Required:False
Accept pipeline input:True
Accept wildcard characters: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 için aşağıdaki diğer adları Push-Locationiç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 dizini vardır. Bu, ile [System.Environment]::CurrentDirectoryaynı 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ı Set-Location değiştirmek için 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 cmdlet'ini Push-Location kullanın.

  • Konum yığınından konum almak için cmdlet'ini Pop-Location kullanın.

  • Geçerli konum yığınındaki konumları görüntülemek için cmdlet'in Stack parametresini Get-Location kullanın.

  • Konumları adlandırılmış bir konum yığınında görüntülemek için cmdlet'in StackName parametresini Get-Location kullanın.

  • Yeni bir konum yığını oluşturmak için cmdlet'in StackName parametresini Push-Location 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 cmdlet'in StackName parametresini Set-Location 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 veya Pop-Location cmdlet'lerini kullanarak Push-Location varsayılan yığından öğe ekleyemez veya alamaz ya da cmdlet'ini kullanarak adsız yığındaki konumları görüntüleyemezsinizGet-Location. Adsız yığını geçerli yığın yapmak için cmdlet'in Set-Location StackName parametresini veya boş bir dize ()"" ile $null kullanın.

Ayrıca, yerleşik diğer adı pushdolan öğesine de başvurabilirsinizPush-Location. Daha fazla bilgi için bkz . about_Aliases.

Push-Location Cmdlet, 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 yazın Get-PSProvider. Daha fazla bilgi için bkz . about_Providers.