about_Scopes

Makale
07/22/2024

Kısa açıklama

PowerShell'de kapsam kavramını açıklar ve öğelerin kapsamını ayarlamayı ve değiştirmeyi gösterir.

Uzun açıklama

PowerShell, okunabilecekleri ve değiştirilebileceği yerleri sınırlayarak değişkenlere, diğer adlara, işlevlere ve PowerShell sürücülerine (PSDrive) erişimi korur. PowerShell, diğer kapsamlardaki öğelerde yanlışlıkla değişiklik yapmadığınızdan emin olmak için kapsam kurallarını kullanır.

Kapsam kuralları

PowerShell'i başlattığınızda, konak (pwsh.exe) bir PowerShell çalışma alanı oluşturur. Konak işlemlerinin birden çok çalışma alanı olabilir. Her çalışma alanının kendi oturum durumu ve kapsam kapsayıcıları vardır. Oturum durumu ve kapsamlara runspace örnekleri arasında erişilemiyor.

Temel kapsam kuralları şunlardır:

Kapsamlar iç içe geçebilir. Dış kapsam, üst kapsam olarak adlandırılır. İç içe yerleştirilmiş kapsamlar, bu üst öğeye ait alt kapsamlardır.
Açıkça özel hale getirmediğiniz sürece, öğe oluşturulduğu kapsamda ve alt kapsamlarda görünür.
Geçerli kapsamın dışındaki bir kapsam için değişkenleri, diğer adları, işlevleri ve PowerShell sürücülerini bildirebilirsiniz.
Kapsam içinde oluşturduğunuz bir öğe, açıkça farklı bir kapsam belirtmediğiniz sürece yalnızca oluşturulduğu kapsamda değiştirilebilir.
Bir çalışma alanında çalışan kod bir öğeye başvurduğunda PowerShell, geçerli kapsamla başlayıp her üst kapsamda ilerleyerek kapsam hiyerarşisinde arama gerçekleştirir.
- Öğe bulunamazsa, geçerli kapsamda yeni bir öğe oluşturulur.
- Eşleşme bulursa, öğenin değeri bulunduğu kapsamdan alınır.
- Değeri değiştirirseniz, değişiklik yalnızca geçerli kapsamı etkileyecek şekilde öğe geçerli kapsama kopyalanır.
Adını farklı bir kapsamdaki bir öğeyle paylaşan bir öğeyi açıkça oluşturursanız, özgün öğe yeni öğe tarafından gizlenmiş olabilir, ancak geçersiz kılınmamış veya değiştirilmemiştir.

Üst ve alt kapsamlar

Betik veya işlev çağırarak yeni bir alt kapsam oluşturabilirsiniz. Çağrı kapsamı üst kapsamdır. Betik veya işlev olarak adlandırılan alt kapsamdır. Çağırdığınız işlevler veya betikler, kök kapsamı genel kapsam olan alt kapsamların hiyerarşisini oluşturarak diğer işlevleri çağırabilir.

Not

Bir modüldeki işlevler, çağrı kapsamının alt kapsamında çalışmaz. Modüllerin, modülün içeri aktarıldığı kapsama bağlı kendi oturum durumları vardır. Tüm modül kodu, kendi kök kapsamına sahip olan modüle özgü bir kapsam hiyerarşisinde çalışır. Daha fazla bilgi için bu makalenin Modüller bölümüne bakın.

Bir alt kapsam oluşturulduğunda, AllScope seçeneğine sahip tüm diğer adları ve değişkenleri ve bazı otomatik değişkenleri içerir. Bu seçenek bu makalenin devamında ele alınmalıdır.

Öğeleri açıkça özel hale getirmediğiniz sürece, üst kapsamdaki öğeler alt kapsamda kullanılabilir. Bir alt kapsamda oluşturduğunuz veya değiştirdiğiniz öğeler, öğeleri oluştururken kapsamı açıkça belirtmediğiniz sürece üst kapsamı etkilemez.

Belirli bir kapsamdaki öğeleri bulmak için veya Get-Aliaskapsam parametresini Get-Variable kullanın.

Örneğin, yerel kapsamdaki tüm değişkenleri almak için şunu yazın:

Get-Variable -Scope local

Genel kapsamdaki tüm değişkenleri almak için şunu yazın:

Get-Variable -Scope global

Bir değişkene, diğer ada veya işleve başvuru yapıldığında PowerShell geçerli kapsamı arar. Öğe bulunamazsa, üst kapsam aranılır. Bu arama, genel kapsama kadar her zaman yinelenir. Bir değişken üst kapsamda özelse, aracılığıyla arama kapsam zinciri boyunca devam eder. Örnek 4 , kapsam aramasında özel değişkenin etkisini gösterir.

PowerShell kapsam adları

PowerShell, bu kapsama daha kolay erişim sağlamak için bazı kapsamların adlarını tanımlar. PowerShell aşağıdaki adlandırılmış kapsamları tanımlar:

Genel: PowerShell başlatıldığında veya yeni bir oturum veya runspace oluşturduğunuzda geçerli olan kapsam. Otomatik değişkenler ve tercih değişkenleri gibi PowerShell başlatıldığında mevcut olan değişkenler ve işlevler genel kapsamda oluşturulur. PowerShell profillerinizdeki değişkenler, diğer adlar ve işlevler de genel kapsamda oluşturulur. Genel kapsam, bir çalışma alanında kök üst kapsamdır.
Yerel: Geçerli kapsam. Yerel kapsam genel kapsam veya başka bir kapsam olabilir.
Betik: Betik dosyası çalışırken oluşturulan kapsam. Betikteki komutlar betik kapsamında çalıştırılır. Betikteki komutlar için betik kapsamı yerel kapsamdır.

Kapsamları destekleyen cmdlet'ler için kapsamlara, bir kapsamın göreli konumunu başka bir kapsamla açıklayan bir sayı başvurabilir. Kapsam 0 geçerli (yerel) kapsamı belirtir, kapsam 1 geçerli kapsamın üst öğesidir, kapsam 2 geçerli kapsamın üst öğesidir. Bu düzen, kök kapsama ulaşana kadar devam eder.

Kapsam değiştiricileri

Değişken, diğer ad veya işlev adı, aşağıdaki isteğe bağlı kapsam değiştiricilerinden herhangi birini içerebilir:

global:- Adın Genel kapsamda mevcut olduğunu belirtir.
local:- Adın Yerel kapsamda var olduğunu belirtir. Geçerli kapsam her zaman Yerel kapsamdır.
private:- Adın Özel olduğunu ve yalnızca geçerli kapsama görünür olduğunu belirtir.

Not

private: bir kapsam değildir. Bir öğenin erişilebilirliğini tanımlandığı kapsamın dışında değiştiren bir seçenektir .
script:- Adın Betik kapsamında mevcut olduğunu belirtir. Betik kapsamı, en yakın üst betik dosyasının kapsamıdır veya en yakın üst betik dosyası yoksa Genel'dir .
using: - Uzak oturumlarda, arka plan işlerinde veya iş parçacığı işlerinde çalışırken başka bir kapsamda tanımlanan değişkenlere erişmek için kullanılır.
workflow: - Adın bir iş akışı içinde var olduğunu belirtir. Not: İş akışları PowerShell v6 ve üzeri sürümlerde desteklenmez.

<variable-namespace> - PowerShell PSDrive sağlayıcısı tarafından oluşturulan değiştirici. Örneğin:

Ad Alanı	Açıklama
`Alias:`	Geçerli kapsamda tanımlanan diğer adlar
`Env:`	Geçerli kapsamda tanımlanan ortam değişkenleri
`Function:`	Geçerli kapsamda tanımlanan işlevler
`Variable:`	Geçerli kapsamda tanımlanan değişkenler

Betiklerin varsayılan kapsamı betik kapsamıdır. İşlevler ve diğer adlar için varsayılan kapsam, bir betikte tanımlanmış olsalar bile yerel kapsamdır.

Kapsam değiştiricileri kullanma

Yeni bir değişkenin, diğer adın veya işlevin kapsamını belirtmek için kapsam değiştirici kullanın.

Bir değişkendeki kapsam değiştiricinin söz dizimi şöyledir:

$[<scope-modifier>:]<name> = <value>

bir işlevdeki kapsam değiştiricinin söz dizimi şöyledir:

function [<scope-modifier>:]<name> {<function-body>}

Kapsam değiştirici kullanmayan aşağıdaki komut, geçerli veya yerel kapsamda bir değişken oluşturur:

$a = "one"

Genel kapsamda aynı değişkeni oluşturmak için kapsam global: değiştiricisini kullanın:

$global:a = "one"
Get-Variable a | Format-List *

Görünürlük ve Seçenekler özellik değerlerine dikkat edin.

Name        : a
Description :
Value       : one
Visibility  : Public
Module      :
ModuleName  :
Options     : None
Attributes  : {}

Bunu bir özel değişkenle karşılaştırın:

$private:pVar = 'Private variable'
Get-Variable pVar | Format-List *

Kapsam değiştiricisini private kullanarak Options özelliğini olarak Privateayarlar.

Name        : pVar
Description :
Value       : Private variable
Visibility  : Public
Module      :
ModuleName  :
Options     : Private
Attributes  : {}

Betik kapsamında aynı değişkeni oluşturmak için kapsam değiştiricisini script: kullanın:

$script:a = "one"

İşlevlerle bir kapsam değiştirici de kullanabilirsiniz. Aşağıdaki işlev tanımı genel kapsamda bir işlev oluşturur:

function global:Hello {
  Write-Host "Hello, World"
}

Farklı bir kapsamdaki bir değişkene başvurmak için kapsam değiştiricileri de kullanabilirsiniz. Aşağıdaki komut, önce yerel kapsamda ve ardından genel kapsamdaki değişkene başvurur $test :

$test
$global:test

Kapsam `using:` değiştirici

kullanma, uzak bir komuttaki yerel değişkeni tanımlayan özel bir kapsam değiştiricidir. Değiştirici olmadan, PowerShell uzak komutlardaki değişkenlerin uzak oturumda tanımlanmasını bekler.

Kapsam using değiştirici PowerShell 3.0'da kullanıma sunulmuştur.

Oturum dışında yürütülen herhangi bir betik veya komut için, çağıran oturum kapsamından using değişken değerleri eklemek için kapsam değiştiricisine ihtiyacınız vardır; böylece oturum dışı kod bunlara erişebilir. Kapsam using değiştirici aşağıdaki bağlamlarda desteklenir:

ComputerName, HostName, SSHConnection veya Session parametreleri (uzak oturum) kullanılarak başlatılan Invoke-Command uzaktan yürütülen komutlar
Ile başlatılan Start-Job arka plan işleri (işlem dışı oturum)
veya ForEach-Object -Parallel aracılığıyla Start-ThreadJob başlatılan iş parçacığı işleri (ayrı iş parçacığı oturumu)

Bağlama bağlı olarak, katıştırılmış değişken değerleri, çağıranın kapsamındaki verilerin bağımsız kopyaları veya buna yapılan başvurulardır. Uzak ve işlem dışı oturumlarda bunlar her zaman bağımsız kopyalardır.

Daha fazla bilgi için bkz . about_Remote_Variables.

Başvuru $using: yalnızca değişkenin değerine genişletir. Çağıranın kapsamındaki bir değişkenin değerini değiştirmek istiyorsanız, değişkenin kendisine bir başvurunuz olmalıdır. Değişkenin PSVariable örneğini alarak bir değişkene başvuru oluşturabilirsiniz. Aşağıdaki örnekte, bir iş parçacığı işinde başvuru oluşturma ve değişiklik yapma işlemi gösterilmektedir.

$Count = 1
$refOfCount = Get-Variable Count

Start-ThreadJob {
    ($using:refOfCount).Value = 2
} | Receive-Job -Wait -AutoRemoveJob

$Count

Not

Bu iş parçacığı güvenli bir işlem değildir. Değeri aynı anda birden çok iş parçacığından değiştirmeye çalışırsanız veri bozulmasına neden olabilirsiniz. Paylaşılan verileri korumak için iş parçacığı güvenli veri türlerini veya eşitleme temel öğelerini kullanmanız gerekir. Daha fazla bilgi için bkz . İş Parçacığı Güvenli koleksiyonlar.

Değişken değerlerini serileştirme

Uzaktan yürütülen komutlar ve arka plan işleri işlem dışıdır. İşlem dışı oturumlarda, değişkenlerin değerlerini işlem sınırları boyunca kullanılabilir hale getirmek için XML tabanlı serileştirme ve seri durumdan çıkarma kullanılır. Serileştirme işlemi, nesneleri özgün nesne özelliklerini içeren ancak yöntemlerini içermeyen bir PSObject'e dönüştürür.

Sınırlı bir tür kümesi için seri durumdan çıkarma, nesneleri özgün türe geri döndürür. Yeniden doldurulan nesne, özgün nesne örneğinin bir kopyasıdır. Tür özelliklerine ve yöntemlerine sahiptir. System.Version gibi basit türler için kopya tamdır. Karmaşık türler için kopya kusurludur. Örneğin, yeniden doldurulan sertifika nesneleri özel anahtarı içermez.

Diğer tüm türlerin örnekleri PSObject örnekleridir. PSTypeNames özelliği, Seri Durumdan Çıkarılmış ön ekli özgün tür adını içerir; örneğin, Deserialized.System.Data.DataTable

AllScope Seçeneği

Değişkenler ve diğer adlar, AllScope değerini alabilen bir Option özelliğine sahiptir. AllScope özelliğine sahip öğeler, üst kapsamlar tarafından geriye dönük olarak devralınmasa da, oluşturduğunuz alt kapsamların bir parçası haline gelir.

AllScope özelliğine sahip bir öğe alt kapsamda görünür ve bu kapsamın bir parçasıdır. Herhangi bir kapsamdaki öğede yapılan değişiklikler, değişkenin tanımlandığı tüm kapsamları etkiler.

Kapsamı yönetme

Bazı cmdlet'ler, belirli bir kapsamdaki öğeleri almanıza veya ayarlamanıza (oluşturmanıza ve değiştirmenize) olanak tanıyan bir Scope parametresine sahiptir. Oturumunuzda Scope parametresi olan tüm cmdlet'leri bulmak için aşağıdaki komutu kullanın:

Get-Help * -Parameter scope

Belirli bir kapsamda görünen değişkenleri bulmak için parametresini Scope Get-Variablekullanın. Görünür değişkenler genel değişkenleri, üst kapsamdaki değişkenleri ve geçerli kapsamdaki değişkenleri içerir.

Örneğin, aşağıdaki komut yerel kapsamda görünen değişkenleri alır:

Get-Variable -Scope local

Belirli bir kapsamda değişken oluşturmak için kapsam değiştiricisini veya Scope parametresini Set-Variablekullanın. Aşağıdaki komut genel kapsamda bir değişken oluşturur:

New-Variable -Scope global -Name a -Value "One"

Kapsamı belirtmek için , Set-Aliasveya Get-Alias cmdlet'lerinin Scope parametresini New-Aliasde kullanabilirsiniz. Aşağıdaki komut genel kapsamda bir diğer ad oluşturur:

New-Alias -Scope global -Name np -Value Notepad.exe

Belirli bir kapsamdaki işlevleri almak için, kapsamdayken cmdlet'ini kullanın Get-Item . Get-Item Cmdlet'in scope parametresi yok.

Not

Scope parametresini kullanan cmdlet'ler için, sayıya göre kapsamlara da başvurabilirsiniz. Sayı, bir kapsamın diğerinin göreli konumunu açıklar. Kapsam 0 geçerli veya yerel kapsamı temsil eder. Kapsam 1, anlık üst kapsamı gösterir. Kapsam 2, üst kapsamın üst öğesini gösterir ve bu şekilde devam eder. Çok sayıda özyinelemeli kapsam oluşturduysanız, numaralandırılmış kapsamlar kullanışlıdır.

Kapsamla nokta kaynağı gösterimi kullanma

Betikler ve işlevler kapsam kurallarına uyar. Bunları belirli bir kapsamda oluşturursunuz ve bu kapsamı değiştirmek için bir cmdlet parametresi veya kapsam değiştirici kullanmadığınız sürece yalnızca bu kapsamı etkiler.

Ancak, nokta kaynağı gösterimini kullanarak bir betiğin veya işlevin içeriğini geçerli kapsama ekleyebilirsiniz. Noktalı kaynak gösterimini kullanarak bir betik veya işlev çalıştırdığınızda, geçerli kapsamda çalışır. Betik veya işlevdeki tüm işlevler, diğer adlar ve değişkenler geçerli kapsama eklenir.

Örneğin, betik kapsamındaki dizinden C:\Scripts betiği çalıştırmak Sample.ps1 için (betikler için varsayılan), komut satırındaki betik dosyasının tam yolunu girmeniz gerekir.

c:\scripts\sample.ps1

Bir betik dosyasının yürütülebilir olması için bir .ps1 dosya uzantısı olmalıdır. Yollarında boşluk bulunan dosyalar tırnak içine alınmalıdır. Alıntılanan yolu yürütmeye çalışırsanız, PowerShell betiği çalıştırmak yerine tırnak içindekileri görüntüler. Çağrı işleci (&), dosya adını içeren dizenin içeriğini yürütmenize olanak tanır.

Bir işlevi veya betiği çalıştırmak için çağrı işlecini kullanmak, bunu betik kapsamında çalıştırır. Çağrı işlecini kullanmak, betiği ada göre çalıştırmaktan farklı değildir.

& c:\scripts\sample.ps1

arama işleci hakkında daha fazla bilgi için about_Operators.

Betiği yerel kapsamda çalıştırmak Sample.ps1 için, betiğin yolundan önce bir nokta ve boşluk (. ) yazın:

. c:\scripts\sample.ps1

Artık betikte tanımlanan tüm işlevler, diğer adlar veya değişkenler geçerli kapsama eklenir.

Kapsam olmadan kısıtlama

PowerShell, kapsama benzer ve kapsamlarla etkileşime geçebilir bazı seçeneklere ve özelliklere sahiptir. Bu özellik kapsam veya kapsamın davranışıyla karıştırılabilir.

Oturumlar, modüller ve iç içe istemler, oturumdaki genel kapsamın alt kapsamları değil, bağımsız ortamlardır.

Oturumlar

Oturum, PowerShell'in çalıştığı bir ortamdır. Uzak bilgisayarda oturum oluşturduğunuzda, PowerShell uzak bilgisayara kalıcı bir bağlantı kurar. Kalıcı bağlantı, oturumu birden çok ilgili komut için kullanmanıza olanak tanır.

Bir oturum, kapsanan bir ortam olduğundan, kendi kapsamına sahiptir, ancak oturum, oluşturulduğu oturumun alt kapsamı değildir. Oturum kendi genel kapsamıyla başlar. Bu kapsam oturumun genel kapsamından bağımsızdır. Oturumda alt kapsamlar oluşturabilirsiniz. Örneğin, bir oturumda alt kapsam oluşturmak için bir betik çalıştırabilirsiniz.

Modül

PowerShell araçlarını paylaşmak ve teslim etmek için bir PowerShell modülü kullanabilirsiniz. Modül cmdlet'leri, betikleri, işlevleri, değişkenleri, diğer adları ve diğer yararlı öğeleri içerebilen bir birimdir. Açıkça dışarı aktarılmadığı sürece (veya modül bildirimi kullanılarak Export-ModuleMember ), modüldeki öğelere modülün dışından erişilemez. Bu nedenle, modülü oturumunuza ekleyebilir ve diğer öğelerin oturumunuzda cmdlet'leri, betikleri, işlevleri ve diğer öğeleri geçersiz kılabileceği konusunda endişelenmeden genel öğeleri kullanabilirsiniz.

Varsayılan olarak modüller, çalışma alanının kök düzeyi (genel) kapsamına yüklenir. Modülü içeri aktarmak kapsamı değiştirmez. Oturumda modüllerin kendi kapsamı vardır. Aşağıdaki modülü C:\temp\mod1.psm1göz önünde bulundurun:

$a = "Hello"

function foo {
    "`$a = $a"
    "`$global:a = $global:a"
}

Şimdi bir genel değişken $aoluşturuyoruz, buna bir değer veriyoruz ve işlev foo'sunu çağırıyoruz.

$a = "Goodbye"
foo

Modül, modül kapsamında değişkeni $a bildirir, ardından işlev foo her iki kapsamda da değişkenin değerini verir.

$a = Hello
$global:a = Goodbye

Modüller, içeri aktarıldıkları kapsama bağlı paralel kapsam kapsayıcıları oluşturur. Modül tarafından dışarı aktarılan öğeler, içeri aktarıldıkları kapsam düzeyinden itibaren kullanılabilir. Modülden dışarı aktarılmayan öğeler yalnızca modülün kapsam kapsayıcısı içinde kullanılabilir. Modüldeki işlevler, içeri aktarıldıkları kapsamdaki öğelere ve modülün kapsam kapsayıcısında yer alan öğelere erişebilir.

Module2'yi Module1 içinden yüklerseniz Module2, Module1 kapsam kapsayıcısına yüklenir. Module2'den yapılan tüm dışarı aktarmalar Modül1'in geçerli modül kapsamına yerleştirilir. kullanırsanız Import-Module -Scope local, dışarı aktarmalar en üst düzeyde değil geçerli kapsam nesnesine yerleştirilir. Bir modüldeyseniz ve (veya Import-Module -Global) kullanarak Import-Module -Scope global başka bir modül yüklerseniz, bu modül ve dışarı aktarmaları modülün yerel kapsamı yerine genel kapsama yüklenir. Windows Uyumluluğu özelliği, proxy modüllerini genel oturum durumuna aktarmak için bunu yapar.

İç içe istemler

İç içe istemlerin kendi kapsamı yoktur. İç içe bir istem girdiğinizde, iç içe istem ortamın bir alt kümesidir. Ancak, yerel kapsam içinde kalırsınız.

Betiklerin kendi kapsamları vardır. Bir betikte hata ayıklarsanız ve betikte bir kesme noktasına ulaşırsanız, betik kapsamını girersiniz.

Özel seçenek

Diğer adlar ve değişkenler, değerini alabilen bir Option özelliğine Privatesahiptir. Seçeneği olan Private öğeler oluşturuldukları kapsamda görüntülenebilir ve değiştirilebilir, ancak bu kapsamın dışında görüntülenemez veya değiştirilemez.

Örneğin, genel kapsamda özel seçeneği olan bir değişken oluşturur ve ardından bir betik çalıştırırsanız, Get-Variable betikteki komutlar özel değişkeni görüntülemez. Bu örnekte genel kapsam değiştiricisi kullanıldığında özel değişken görüntülenmez.

Option özelliğinin New-Variabledeğerini Özel olarak ayarlamak için , Set-Variable, New-Aliasve Set-Alias cmdlet'lerinin Option parametresini kullanabilirsiniz.

Görünürlük

Değişkenin veya diğer adın Visibility özelliği, öğeyi oluşturulduğu kapsayıcının dışında görüp göremeyeceğiniz belirler. Kapsayıcı bir modül, betik veya ek bileşen olabilir. Görünürlük, Option özelliğinin değerinin kapsamlar için tasarlandığı şekilde Private kapsayıcılar için tasarlanmıştır.

Visibility özelliği ve Private değerlerini alırPublic. Özel görünürlüğe sahip öğeler yalnızca oluşturuldukları kapsayıcıda görüntülenebilir ve değiştirilebilir. Kapsayıcı eklenir veya içeri aktarılırsa, özel görünürlüğe sahip öğeler görüntülenemez veya değiştirilemez.

Görünürlük kapsayıcılar için tasarlandığından, bir kapsamda farklı çalışır.

Genel kapsamda özel görünürlüğe sahip bir öğe oluşturursanız, öğeyi hiçbir kapsamda görüntüleyemez veya değiştiremezsiniz.
Özel görünürlüğü olan bir değişkenin değerini görüntülemeye veya değiştirmeye çalışırsanız PowerShell bir hata iletisi döndürür.

özel görünürlüğe sahip bir değişken oluşturmak için ve Set-Variable cmdlet'lerini kullanabilirsinizNew-Variable.

Örnekler

Örnek 1: Değişken değerini yalnızca betikte değiştirme

Aşağıdaki komut, bir betikteki değişkenin $ConfirmPreference değerini değiştirir. Değişiklik genel kapsamı etkilemez.

İlk olarak, değişkenin değerini $ConfirmPreference yerel kapsamda görüntülemek için aşağıdaki komutu kullanın:

PS>  $ConfirmPreference
High

Aşağıdaki komutları içeren bir Scope.ps1 betiği oluşturun:

$ConfirmPreference = "Low"
"The value of `$ConfirmPreference is $ConfirmPreference."

Betiği çalıştırın. Betik, değişkenin $ConfirmPreference değerini değiştirir ve betik kapsamında değerini bildirir. Çıkış aşağıdaki çıkışa benzemelidir:

The value of $ConfirmPreference is Low.

Ardından, değişkenin geçerli değerini $ConfirmPreference geçerli kapsamda test edin.

PS>  $ConfirmPreference
High

Bu örnek, betik kapsamındaki bir değişkenin değerinde yapılan değişikliklerin, değişkenin üst kapsamdaki değerini etkilemediğini gösterir.

Örnek 2: Farklı kapsamlardaki değişken değerini görüntüleme

Yerel kapsamda ve üst kapsamdaki bir değişkenin değerini görüntülemek için kapsam değiştiricilerini kullanabilirsiniz.

İlk olarak, genel kapsamda bir $test değişken tanımlayın.

$test = "Global"

Ardından, değişkeni tanımlayan $test bir Sample.ps1 betik oluşturun. Betikte, değişkenin genel veya yerel sürümlerine $test başvurmak için bir kapsam değiştirici kullanın.

Sample.ps1 içinde:

$test = "Local"
"The local value of `$test is $test."
"The global value of `$test is $global:test."

komutunu çalıştırdığınızda Sample.ps1, çıkış aşağıdaki çıkışa benzemelidir:

The local value of $test is Local.
The global value of $test is Global.

Betik tamamlandığında, oturumda yalnızca genel değeri $test tanımlanır.

PS> $test
Global

Örnek 3: Üst kapsamdaki bir değişkenin değerini değiştirme

Özel seçeneğini veya başka bir yöntemi kullanarak bir öğeyi korumadığınız sürece, üst kapsamdaki bir değişkenin değerini görüntüleyebilir ve değiştirebilirsiniz.

İlk olarak, genel kapsamda bir $test değişken tanımlayın.

$test = "Global"

Ardından, değişkeni tanımlayan $test bir Sample.ps1 betiği oluşturun. Betikte, değişkenin genel veya yerel sürümlerine $test başvurmak için bir kapsam değiştirici kullanın.

Sample.ps1'de:

$global:test = "Local"
"The global value of `$test is $global:test."

Betik tamamlandığında genel değeri $test değiştirilir.

PS> $test
Local

Örnek 4: Özel değişken oluşturma

Bir değişken, kapsam değiştiricisi private: kullanılarak veya Option özelliği olarak ayarlanmış Privatedeğişken oluşturularak özelleştirilebilir. Özel değişkenler yalnızca oluşturuldukları kapsamda görüntülenebilir veya değiştirilebilir.

Bu örnekte betik ScopeExample.ps1 beş işlev oluşturur. İlk işlev, bir alt kapsam oluşturan sonraki işlevi çağırır. İşlevlerden biri, yalnızca oluşturulduğu kapsamda görülebilen özel bir değişkene sahiptir.

PS> Get-Content ScopeExample.ps1
# Start of ScopeExample.ps1
function funcA {
    "Setting `$funcAVar1 to 'Value set in funcA'"
    $funcAVar1 = "Value set in funcA"
    funcB
}

function funcB {
    "In funcB before set -> '$funcAVar1'"
    $private:funcAVar1 = "Locally overwrite the value - child scopes can't see me!"
    "In funcB after set  -> '$funcAVar1'"
    funcC
}

function funcC {
    "In funcC before set -> '$funcAVar1' - should be the value set in funcA"
    $funcAVar1 = "Value set in funcC - Child scopes can see this change."
    "In funcC after set  -> '$funcAVar1'"
    funcD
}

function funcD {
    "In funcD before set -> '$funcAVar1' - should be the value from funcC."
    $funcAVar1 = "Value set in funcD"
    "In funcD after set  -> '$funcAVar1'"
    '-------------------'
    ShowScopes
}

function ShowScopes {
    $funcAVar1 = "Value set in ShowScopes"
    "Scope [0] (local)  `$funcAVar1 = '$(Get-Variable funcAVar1 -Scope 0 -ValueOnly)'"
    "Scope [1] (parent) `$funcAVar1 = '$(Get-Variable funcAVar1 -Scope 1 -ValueOnly)'"
    "Scope [2] (parent) `$funcAVar1 = '$(Get-Variable funcAVar1 -Scope 2 -ValueOnly)'"
    "Scope [3] (parent) `$funcAVar1 = '$(Get-Variable funcAVar1 -Scope 3 -ValueOnly)'"
    "Scope [4] (parent) `$funcAVar1 = '$(Get-Variable funcAVar1 -Scope 4 -ValueOnly)'"
}
funcA
# End of ScopeExample.ps1
PS> .\ScopeExample.ps1

Çıkış, her kapsamdaki değişkenin değerini gösterir. Özel değişkenin yalnızca oluşturulduğu kapsamda görünür funcBolduğunu görebilirsiniz.

Setting $funcAVar1 to 'Value set in funcA'
In funcB before set -> 'Value set in funcA'
In funcB after set  -> 'Locally overwrite the value - child scopes can't see me!'
In funcC before set -> 'Value set in funcA' - should be the value set in funcA
In funcC after set  -> 'Value set in funcC - Child scopes can see this change.'
In funcD before set -> 'Value set in funcC - Child scopes can see this change.' - should be the value from funcC.
In funcD after set  -> 'Value set in funcD'
-------------------
Scope [0] (local)  $funcAVar1 = 'Value set in ShowScopes'
Scope [1] (parent) $funcAVar1 = 'Value set in funcD'
Scope [2] (parent) $funcAVar1 = 'Value set in funcC - Child scopes can see this change.'
Scope [3] (parent) $funcAVar1 = 'Locally overwrite the value - child scopes can't see me!'
Scope [4] (parent) $funcAVar1 = 'Value set in funcA'

çıktısı ShowScopestarafından gösterildiği gibi, bir kapsam numarası kullanarak Get-Variable ve belirterek diğer kapsamlardan değişkenlere erişebilirsiniz.

Örnek 5: Uzak komutta yerel değişken kullanma

Yerel oturumda oluşturulan uzak komuttaki değişkenler için kapsam değiştiricisini using kullanın. PowerShell, uzak komutlardaki değişkenlerin uzak oturumda oluşturulduğunu varsayar.

Söz dizimi aşağıdaki gibidir:

$using:<VariableName>

Örneğin, aşağıdaki komutlar yerel oturumda bir $Cred değişken oluşturur ve ardından değişkeni uzak komutta kullanır $Cred :

$Cred = Get-Credential
Invoke-Command $s {Remove-Item .\Test*.ps1 -Credential $using:Cred}

Kapsam using değiştirici PowerShell 3.0'da kullanıma sunulmuştur.

Aracılığıyla paylaş

about_Scopes

Kısa açıklama

Uzun açıklama

Kapsam kuralları

Üst ve alt kapsamlar

PowerShell kapsam adları

Kapsam değiştiricileri

Kapsam değiştiricileri kullanma

Kapsam `using:` değiştirici

Değişken değerlerini serileştirme

AllScope Seçeneği

Kapsamı yönetme

Kapsamla nokta kaynağı gösterimi kullanma

Kapsam olmadan kısıtlama

Oturumlar

Modül

İç içe istemler

Özel seçenek

Görünürlük

Örnekler

Örnek 1: Değişken değerini yalnızca betikte değiştirme

Örnek 2: Farklı kapsamlardaki değişken değerini görüntüleme

Örnek 3: Üst kapsamdaki bir değişkenin değerini değiştirme

Örnek 4: Özel değişken oluşturma

Örnek 5: Uzak komutta yerel değişken kullanma

Ayrıca bkz.

Ek kaynaklar

Aracılığıyla paylaş

about_Scopes

Kısa açıklama

Uzun açıklama

Kapsam kuralları

Üst ve alt kapsamlar

PowerShell kapsam adları

Kapsam değiştiricileri

Kapsam değiştiricileri kullanma

Kapsam using: değiştirici

Değişken değerlerini serileştirme

AllScope Seçeneği

Kapsamı yönetme

Kapsamla nokta kaynağı gösterimi kullanma

Kapsam olmadan kısıtlama

Oturumlar

Modül

İç içe istemler

Özel seçenek

Görünürlük

Örnekler

Örnek 1: Değişken değerini yalnızca betikte değiştirme

Örnek 2: Farklı kapsamlardaki değişken değerini görüntüleme

Örnek 3: Üst kapsamdaki bir değişkenin değerini değiştirme

Örnek 4: Özel değişken oluşturma

Örnek 5: Uzak komutta yerel değişken kullanma

Ayrıca bkz.

Ek kaynaklar

Kapsam `using:` değiştirici