Aracılığıyla paylaş

Set-Location

Modül:
Microsoft.PowerShell.Management Module

Geçerli çalışma konumunu belirtilen bir konuma ayarlar.

Syntax

Path (Varsayılan) 

Set-Location
    [[-Path] <String>]
    [-PassThru]
    [<CommonParameters>]

LiteralPath 

Set-Location
    -LiteralPath <String>
    [-PassThru]
    [<CommonParameters>]

Stack 

Set-Location
    [-PassThru]
    [-StackName <String>]
    [<CommonParameters>]

Description

Set-Location cmdlet'i çalışma konumunu belirtilen bir konuma ayarlar. Bu konum bir dizin, alt dizin, kayıt defteri konumu veya herhangi bir sağlayıcı yolu olabilir.

PowerShell 6.2, - parametresi için değer olarak + ve desteği ekledi. PowerShell, - ve +ile erişilebilen son 20 konumun geçmişini tutar. Bu liste, StackName parametresi kullanılarak erişilen konum yığınından bağımsızdır.

Örnekler

Örnek 1: Geçerli konumu ayarlama

PS C:\> Set-Location -Path "HKLM:\"
PS HKLM:\>

Bu komut geçerli konumu HKLM: sürücüsünün köküne ayarlar.

Örnek 2: Geçerli konumu ayarlama ve bu konumu görüntüleme

PS C:\> Set-Location -Path "Env:\" -PassThru

Path
----
Env:\

PS Env:\>

Bu komut geçerli konumu Env: sürücüsünün köküne ayarlar. PowerShell'i konumu temsil eden bir PathInfo nesnesi döndürmeye yönlendirmek için Env:\ parametresini kullanır.

Örnek 3: Konumu C: sürücüsündeki geçerli konuma ayarlama

PS C:\Windows\> Set-Location HKLM:\
PS HKLM:\> Set-Location C:
PS C:\Windows\>

İlk komut, konumu Kayıt Defteri sağlayıcısındaki HKLM: sürücüsünün köküne ayarlar. İkinci komut, konumu FileSystem sağlayıcısındaki C: sürücüsünün geçerli konumuna ayarlar. Sürücü adı <DriveName>: (ters eğik çizgi olmadan) biçiminde belirtildiğinde, cmdlet konumu PSDrive'daki geçerli konuma ayarlar. PSDrive'da geçerli konumu almak için Get-Location -PSDrive <DriveName> komutunu kullanın.

Örnek 4: Geçerli konumu adlandırılmış yığın olarak ayarlama

PS C:\> Push-Location -Path 'C:\Program Files\PowerShell\' -StackName "Paths"
PS C:\Program Files\PowerShell\> Set-Location -StackName "Paths"
PS C:\Program Files\PowerShell\> Get-Location -Stack

Path
----
C:\

İlk komut geçerli konumu Yollar yığınına ekler. İkinci komut, Yollar konum yığınını geçerli konum yığını yapar. Üçüncü komut geçerli konum yığınındaki konumları görüntüler.

*-Location cmdlet'leri, komutta farklı bir konum yığını belirtilmediği sürece geçerli konum yığınını kullanır. Konum yığınları hakkında bilgi için bkz. Notlar.

Örnek 5: '+' veya '-' kullanarak konum geçmişinde gezinme

PS C:\> Set-Location -Path $Env:SystemRoot
PS C:\Windows> Set-Location -Path Cert:\
PS Cert:\> Set-Location -Path HKLM:\
PS HKLM:\>

# Navigate back through the history using "-"
PS HKLM:\> Set-Location -Path -
PS Cert:\> Set-Location -Path -
PS C:\Windows>

# Navigate using the Set-Location alias "cd" and the implicit positional Path parameter
PS C:\Windows> cd -
PS C:\> cd +
PS C:\Windows> cd +
PS Cert:\>

Diğer ad, cd - veya cd + kullanmak, terminalinizde konum geçmişinizde gezinmenin kolay bir yoludur. - / +ile gezinme hakkında daha fazla bilgi için Yol parametresine bakın.

Parametreler

-LiteralPath

Konumun yolunu belirtir. 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, LP

Parametre kümeleri

LiteralPath
Position:Named
Zorunlu:True
İş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 PathInfo nesnesi döndürür. 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

Yeni bir çalışma konumunun yolunu belirtin. Yol sağlanmazsa, Set-Location varsayılan olarak geçerli kullanıcının giriş dizinine ayarlanır. Joker karakterler kullanıldığında, cmdlet joker karakter deseniyle eşleşen kapsayıcıyı (dizin, kayıt defteri anahtarı, sertifika deposu) seçer. Joker karakter deseni birden fazla kapsayıcıyla eşleşiyorsa, cmdlet bir hata döndürür.

PowerShell, ayarladığınız son 20 konumun geçmişini tutar. Yolu parametre değeri - karakterse, yeni çalışma konumu geçmişteki önceki çalışma konumu olur (varsa). Benzer şekilde, değer + karakterse, yeni çalışma konumu (varsa) geçmişteki bir sonraki çalışma konumu olur. Bu, Pop-Location ve Push-Location kullanmaya benzer, ancak geçmişin yığın değil liste olması ve elle denetlenmemesi, örtük olarak izlenmesidir. Geçmiş listesini görüntülemenin hiçbir yolu yoktur.

Parametre özellikleri

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

Parametre kümeleri

Path
Position:0
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

Bu cmdlet'in geçerli konum yığınını yaptığı mevcut bir konum yığını adını belirtir. Konum yığını adı girin. Adsız varsayılan konum yığınını belirtmek için $null veya boş bir dize ("") yazın.

Bu parametrenin kullanılması geçerli konumu değiştirmez. Yalnızca *-Location cmdlet'leri tarafından kullanılan yığını değiştirir. *-Location cmdlet'leri, farklı bir yığın belirtmek için StackName parametresini kullanmadığınız sürece geçerli yığın üzerinde hareket eder. Konum yığınları hakkında daha fazla bilgi için bkz. Notlar.

Parametre özellikleri

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

Parametre kümeleri

Stack
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

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 bir yol içeren ancak kelime anlamıyla bir yol olmayan bir dize aktarabilirsiniz.

Çıkışlar

None

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

PathInfo

Path veya LiteralPathile PassThru parametresini kullandığınızda, bu cmdlet yeni konumu temsil eden bir PathInfo nesnesi döndürür.

PathInfoStack

StackNameile PassThru parametresini kullandığınızda, bu cmdlet yeni yığın bağlamını temsil eden bir PathInfoStack nesnesi döndürür.

Notlar

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

  • Tüm Platformlar:
    • cd
    • chdir
    • sl

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.

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

Yığın, yalnızca en son eklenen öğeye erişilebilen son giriş ve 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. 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 aşağıdaki gibi *-Location cmdlet'lerini 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 Get-Location parametresini kullanın.

  • Yeni bir konum yığını oluşturmak için Push-Location 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 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.