Aracılığıyla paylaş

Push-Location

Modül:
Microsoft.PowerShell.Management Module

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

Syntax

Path (Varsayılan) 

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

LiteralPath 

Push-Location
    [-LiteralPath <String>]
    [-PassThru]
    [-StackName <String>]
    [-UseTransaction]
    [<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 ~eşdeğer olan tilde simgesiyle ($HOME) 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 (Pop-Location) açmak için C:\ 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, yolu tek tırnak işaretleriyle çevreleyin. Tek tırnak işaretleri, PowerShell'in hiçbir karakteri kaçış dizisi olarak yorumlamamasını sağlar.

Parametre özellikleri

Tür:String
Default value:None
Joker karakterleri destekler:False
DontShow:False
Diğer adlar:PSPath

Parametre kümeleri

LiteralPath
Position:Named
Zorunlu:False
İşlem hattından gelen değer:False
Özellik adına göre işlem hattından gelen değer:True
Kalan bağımsız değişkenlerden elde edilen değer:False

-PassThru

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

Parametre özellikleri

Tür:SwitchParameter
Default value:False
Joker karakterleri destekler:False
DontShow:False

Parametre kümeleri

(All)
Position:Named
Zorunlu:False
İşlem hattından gelen değer:False
Özellik adına göre işlem hattından gelen değer:False
Kalan bağımsız değişkenlerden elde edilen değer: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.

Parametre özellikleri

Tür:String
Default value:None
Joker karakterleri destekler:True
DontShow:False

Parametre kümeleri

Path
Position:1
Zorunlu:False
İşlem hattından gelen değer:True
Özellik adına göre işlem hattından gelen değer:True
Kalan bağımsız değişkenlerden elde edilen değer:False

-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 cmdlet'in Set-Location parametresini kullanın. Konum yığınları hakkında daha fazla bilgi için bkz. Notlar.

Uyarı

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

Parametre özellikleri

Tür:String
Default value:Default stack
Joker karakterleri destekler:False
DontShow:False

Parametre kümeleri

(All)
Position:Named
Zorunlu:False
İşlem hattından gelen değer:False
Özellik adına göre işlem hattından gelen değer:True
Kalan bağımsız değişkenlerden elde edilen değer:False

-UseTransaction

Komutunu etkin işleme ekler. Bu parametre yalnızca bir işlem devam ederken geçerlidir. Daha fazla bilgi için bkz. about_Transactions.

Parametre özellikleri

Tür:SwitchParameter
Default value:False
Joker karakterleri destekler:False
DontShow:False
Diğer adlar:usetx

Parametre kümeleri

(All)
Position:Named
Zorunlu:False
İşlem hattından gelen değer:False
Özellik adına göre işlem hattından gelen değer:False
Kalan bağımsız değişkenlerden elde edilen değer:False

CommonParameters

Bu cmdlet yaygın parametreleri destekler: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction ve -WarningVariable. Daha fazla bilgi için bkz. about_CommonParameters.

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

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

  • pushd

PowerShell, işlem başına birden çok çalışma alanı destekler. Her çalışma alanının kendine ait 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 cmdlet'in Get-Location parametresini kullanın.

  • Konumları adlandırılmış bir konum yığınında görüntülemek için cmdlet'in Get-Location 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, cmdlet'in Set-Location 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.