about_Scopes

  • Artikel

Korte beschrijving

Legt het concept van het bereik in PowerShell uit en laat zien hoe u het bereik van elementen instelt en wijzigt.

Lange beschrijving

PowerShell beschermt de toegang tot variabelen, aliassen, functies en PowerShell-stations (PSDrives) door te beperken waar ze kunnen worden gelezen en gewijzigd. PowerShell maakt gebruik van bereikregels om ervoor te zorgen dat u geen onbedoelde wijzigingen aanbrengt in items in andere bereiken.

Bereikregels

Wanneer u PowerShell start, maakt de host (pwsh.exe) een PowerShell-runspace. Hostprocessen kunnen meerdere runspaces hebben. Elke runspace heeft een eigen sessiestatus en scopecontainers. Sessiestatus en -bereiken kunnen niet worden geopend voor runspace-exemplaren.

Hier volgen de basisregels voor het bereik:

  • Bereiken kunnen nesten. Een buitenste bereik wordt een bovenliggend bereik genoemd. Geneste bereiken zijn onderliggende bereiken van dat bovenliggende bereik.
  • Een item is zichtbaar in het bereik dat is gemaakt en in onderliggende bereiken, tenzij u het expliciet privé maakt.
  • U kunt variabelen, aliassen, functies en PowerShell-stations declareren voor een bereik buiten het huidige bereik.
  • Een item dat u in een bereik hebt gemaakt, kan alleen worden gewijzigd in het bereik waarin het is gemaakt, tenzij u expliciet een ander bereik opgeeft.
  • Wanneer code die wordt uitgevoerd in een runspace verwijst naar een item, zoekt PowerShell naar de bereikhiërarchie, te beginnen met het huidige bereik en doorgaat via elk bovenliggend bereik. Als het item niet wordt gevonden, wordt er een nieuw item gemaakt in het huidige bereik. Als er een overeenkomst wordt gevonden, wordt de waarde van het item opgehaald uit het bereik waar is gevonden. Als u de waarde wijzigt, wordt het item gekopieerd naar het huidige bereik, zodat de wijziging alleen van invloed is op het huidige bereik.
  • Als u expliciet een item maakt dat de naam deelt met een item in een ander bereik, wordt het oorspronkelijke item mogelijk verborgen door het nieuwe item, maar wordt het niet overschreven of gewijzigd.

Bovenliggende en onderliggende bereiken

U kunt een nieuw onderliggend bereik maken door een script of functie aan te roepen. Het aanroepende bereik is het bovenliggende bereik. Het aangeroepen script of de functie is het onderliggende bereik. De functies of scripts die u aanroept, kunnen andere functies aanroepen, waardoor een hiërarchie wordt gemaakt van onderliggende bereiken waarvan het hoofdbereik het globale bereik is.

Notitie

Functies uit een module worden niet uitgevoerd in een onderliggend bereik van het aanroepende bereik. Modules hebben hun eigen sessiestatus die is gekoppeld aan het bereik waarin de module is geïmporteerd. Alle modulecode wordt uitgevoerd in een modulespecifieke hiërarchie van bereiken die een eigen hoofdbereik hebben. Zie de sectie Modules van dit artikel voor meer informatie.

Wanneer een onderliggend bereik wordt gemaakt, bevat het alle aliassen en variabelen met de optie AllScope en enkele automatische variabelen. Deze optie wordt verderop in dit artikel besproken.

Tenzij u de items expliciet privé maakt, zijn de items in het bovenliggende bereik beschikbaar voor het onderliggende bereik. Items die u in een onderliggend bereik maakt of wijzigt, hebben geen invloed op het bovenliggende bereik, tenzij u het bereik expliciet opgeeft wanneer u de items maakt.

Gebruik de parameter Bereik van Get-Variable of Get-Aliasom de items in een bepaald bereik te vinden.

Als u bijvoorbeeld alle variabelen in het lokale bereik wilt ophalen, typt u:

Get-Variable -Scope local

Als u alle variabelen in het globale bereik wilt ophalen, typt u:

Get-Variable -Scope global

Wanneer een verwijzing naar een variabele, alias of functie wordt gemaakt, zoekt PowerShell naar het huidige bereik. Als het item niet wordt gevonden, wordt het bovenliggende bereik doorzocht. Deze zoekopdracht wordt helemaal herhaald tot aan het globale bereik. Als een variabele privé is in een bovenliggend bereik, wordt de zoekopdracht voortgezet via de bereikketen. In voorbeeld 4 ziet u het effect van een privévariabele in een zoekbereik.

Namen van PowerShell-bereiken

PowerShell definieert namen voor sommige bereiken om eenvoudiger toegang tot dat bereik mogelijk te maken. PowerShell definieert de volgende benoemde bereiken:

  • Globaal: het bereik dat van kracht is wanneer PowerShell wordt gestart of wanneer u een nieuwe sessie of runspace maakt. Variabelen en functies die aanwezig zijn wanneer PowerShell wordt gestart, zoals automatische variabelen en voorkeursvariabelen, worden gemaakt in het globale bereik. De variabelen, aliassen en functies in uw PowerShell-profielen worden ook gemaakt in het globale bereik. Het globale bereik is het bovenliggende hoofdbereik in een runspace.
  • Lokaal: Het huidige bereik. Het lokale bereik kan het globale bereik of een ander bereik zijn.
  • Script: Het bereik dat wordt gemaakt terwijl een scriptbestand wordt uitgevoerd. De opdrachten in het script worden uitgevoerd in het scriptbereik. Voor de opdrachten in een script is het scriptbereik het lokale bereik.

Voor cmdlets die bereiken ondersteunen, kunnen bereiken worden verwezen door een getal dat de relatieve positie van het ene bereik naar het andere beschrijft. Scope 0 geeft het huidige (lokale) bereik aan, bereik 1 is het bovenliggende bereik van het huidige bereik, bereik 2 is de grootouder van het huidige bereik. Dit patroon gaat door totdat u het hoofdbereik bereikt.

Bereikaanpassingen

Een variabele, alias of functienaam kan een van de volgende optionele bereikaanpassingen bevatten:

  • global: - Hiermee geeft u op dat de naam bestaat in het globale bereik.

  • local: - Hiermee geeft u op dat de naam bestaat in het lokale bereik. Het huidige bereik is altijd het lokale bereik.

  • private:- Hiermee geeft u op dat de naam Privé is en alleen zichtbaar is voor het huidige bereik.

    Notitie

    private: is geen bereik. Het is een optie die de toegankelijkheid van een item buiten het bereik wijzigt waarin het is gedefinieerd.

  • script: - Hiermee geeft u op dat de naam bestaat in het scriptbereik . Scriptbereik is het bereik van het dichtstbijzijnde bovenliggende scriptbestand of Global als er geen dichtstbijzijnde bovenliggende scriptbestand is.

  • using: - Wordt gebruikt voor toegang tot variabelen die zijn gedefinieerd in een ander bereik tijdens het uitvoeren van scripts via cmdlets zoals Start-Job en Invoke-Command.

  • workflow: - Hiermee geeft u op dat de naam bestaat in een werkstroom. Opmerking: werkstromen worden niet ondersteund in PowerShell v6 en hoger.

  • <variable-namespace> - Een wijzigingsfunctie die is gemaakt door een PowerShell PSDrive-provider . Voorbeeld:

    Naamruimte Beschrijving
    Alias: Aliassen die zijn gedefinieerd in het huidige bereik
    Env: Omgevingsvariabelen gedefinieerd in het huidige bereik
    Function: Functies die zijn gedefinieerd in het huidige bereik
    Variable: Variabelen die zijn gedefinieerd in het huidige bereik

Het standaardbereik voor scripts is het scriptbereik. Het standaardbereik voor functies en aliassen is het lokale bereik, zelfs als ze zijn gedefinieerd in een script.

Bereikaanpassingen gebruiken

Als u het bereik van een nieuwe variabele, alias of functie wilt opgeven, gebruikt u een bereikaanpassingsfunctie.

De syntaxis voor een bereikaanpassing in een variabele is:

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

De syntaxis voor een bereikaanpassing in een functie is:

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

Met de volgende opdracht, die geen bereikaanpassing gebruikt, wordt een variabele gemaakt in het huidige of lokale bereik:

$a = "one"

Als u dezelfde variabele in het globale bereik wilt maken, gebruikt u de bereikaanpassing global: :

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

Let op de eigenschapswaarden Zichtbaarheid en Opties .

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

Vergelijk dit met een privévariabele:

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

Met behulp van de private bereikaanpassing stelt u de eigenschap Opties in op Private.

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

Als u dezelfde variabele in het scriptbereik wilt maken, gebruikt u de script: bereikaanpassing:

$script:a = "one"

U kunt ook een bereikaanpassing met functies gebruiken. Met de volgende functiedefinitie wordt een functie gemaakt in het globale bereik:

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

U kunt ook bereikaanpassingen gebruiken om te verwijzen naar een variabele in een ander bereik. De volgende opdracht verwijst naar de $test variabele, eerst in het lokale bereik en vervolgens in het globale bereik:

$test
$global:test

De using: bereikaanpassing

Het gebruik is een speciale bereikaanpassing die een lokale variabele in een externe opdracht identificeert. Zonder een wijzigingsfunctie verwacht PowerShell dat variabelen in externe opdrachten worden gedefinieerd in de externe sessie.

De using bereikaanpassing wordt geïntroduceerd in PowerShell 3.0.

Voor een script of opdracht die buiten de sessie wordt uitgevoerd, hebt u de using bereikaanpassing nodig om variabele waarden uit het aanroepende sessiebereik in te sluiten, zodat deze toegang hebben tot de sessiecode. De using bereikaanpassing wordt ondersteund in de volgende contexten:

  • Op afstand uitgevoerde opdrachten, gestart met Invoke-Command computernaam, hostnaam, SSH Verbinding maken ion of sessieparameters (externe sessie)
  • Achtergrondtaken, gestart met Start-Job (out-of-process sessie)
  • Threadtaken, gestart via Start-ThreadJob of ForEach-Object -Parallel (afzonderlijke threadsessie)

Afhankelijk van de context zijn ingesloten variabelewaarden onafhankelijke kopieën van de gegevens in het bereik van de beller of verwijzingen ernaar. In externe en niet-processessies zijn ze altijd onafhankelijke kopieën.

Zie about_Remote_Variables voor meer informatie.

In threadsessies worden ze doorgegeven door verwijzing. Dit betekent dat het mogelijk is om variabelen voor onderliggend bereik in een andere thread te wijzigen. Voor het veilig wijzigen van variabelen is threadsynchronisatie vereist.

Zie voor meer informatie:

Serialisatie van variabele waarden

Op afstand uitgevoerde opdrachten en achtergrondtaken zijn verouderd. Out-of-process sessies maken gebruik van op XML gebaseerde serialisatie en deserialisatie om de waarden van variabelen beschikbaar te maken binnen de procesgrenzen. Het serialisatieproces converteert objecten naar een PSObject dat de oorspronkelijke objecteigenschappen bevat, maar niet de bijbehorende methoden.

Voor een beperkte set typen rehydrateeert deserialisatie objecten terug naar het oorspronkelijke type. Het gerehydrateerde object is een kopie van het oorspronkelijke objectexemplaar. Het heeft de typeeigenschappen en -methoden. Voor eenvoudige typen, zoals System.Version, is de kopie exact. Voor complexe typen is de kopie onvolmaakt. Gerehydrateerde certificaatobjecten bevatten bijvoorbeeld niet de persoonlijke sleutel.

Exemplaren van alle andere typen zijn PSObject-exemplaren . De eigenschap PSTypeNames bevat de oorspronkelijke typenaam voorafgegaan door Gedeserialiseerde, bijvoorbeeld Deserialized.System.Data.DataTable

De optie AllScope

Variabelen en aliassen hebben een option-eigenschap die een waarde van AllScope kan aannemen. Items met de eigenschap AllScope worden onderdeel van onderliggende bereiken die u maakt, hoewel ze niet met terugwerkende kracht worden overgenomen door bovenliggende bereiken.

Een item met de eigenschap AllScope is zichtbaar in het onderliggende bereik en maakt deel uit van dat bereik. Wijzigingen in het item in een bereik zijn van invloed op alle bereiken waarin de variabele is gedefinieerd.

Bereik beheren

Verschillende cmdlets hebben een bereikparameter waarmee u items in een bepaald bereik kunt ophalen of instellen (maken en wijzigen). Gebruik de volgende opdracht om alle cmdlets in uw sessie met een bereikparameter te vinden:

Get-Help * -Parameter scope

Als u de variabelen wilt vinden die zichtbaar zijn in een bepaald bereik, gebruikt u de Scope parameter van Get-Variable. De zichtbare variabelen omvatten globale variabelen, variabelen in het bovenliggende bereik en variabelen in het huidige bereik.

Met de volgende opdracht worden bijvoorbeeld de variabelen opgeslagen die zichtbaar zijn in het lokale bereik:

Get-Variable -Scope local

Als u een variabele in een bepaald bereik wilt maken, gebruikt u een bereikaanpassingsfunctie of de parameter Bereik van Set-Variable. Met de volgende opdracht maakt u een variabele in het globale bereik:

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

U kunt ook de bereikparameter van de New-Alias, Set-Aliasof Get-Alias cmdlets gebruiken om het bereik op te geven. Met de volgende opdracht maakt u een alias in het globale bereik:

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

Als u de functies in een bepaald bereik wilt ophalen, gebruikt u de Get-Item cmdlet wanneer u zich in het bereik bevindt. De Get-Item cmdlet heeft geen bereikparameter .

Notitie

Voor de cmdlets die de parameter Bereik gebruiken, kunt u ook verwijzen naar bereiken op getal. Het getal beschrijft de relatieve positie van het ene bereik naar het andere. Bereik 0 vertegenwoordigt het huidige of lokale bereik. Bereik 1 geeft het directe bovenliggende bereik aan. Bereik 2 geeft het bovenliggende bereik aan, enzovoort. Genummerde bereiken zijn handig als u veel recursieve bereiken hebt gemaakt.

Puntbron notatie gebruiken met bereik

Scripts en functies volgen de regels van het bereik. U maakt ze in een bepaald bereik en ze hebben alleen invloed op dat bereik, tenzij u een cmdlet-parameter of een bereikwijziging gebruikt om dat bereik te wijzigen.

U kunt echter de inhoud van een script of functie toevoegen aan het huidige bereik met behulp van puntbron notatie. Wanneer u een script of functie uitvoert met behulp van puntbron notatie, wordt het uitgevoerd in het huidige bereik. Alle functies, aliassen en variabelen in het script of de functie worden toegevoegd aan het huidige bereik.

Als u bijvoorbeeld het Sample.ps1 script wilt uitvoeren vanuit de C:\Scripts map in het scriptbereik (de standaardinstelling voor scripts), hoeft u alleen het volledige pad naar het scriptbestand op de opdrachtregel in te voeren.

c:\scripts\sample.ps1

Een scriptbestand moet een .ps1 bestandsextensie hebben om uitvoerbaar te zijn. Bestanden met spaties in hun pad moeten tussen aanhalingstekens staan. Als u probeert het pad tussen aan citeren uit te voeren, wordt in PowerShell de inhoud van de tekenreeks weergegeven in plaats van het script uit te voeren. Met de aanroepoperator (&) kunt u de inhoud van de tekenreeks met de bestandsnaam uitvoeren.

Met behulp van de aanroepoperator om een functie of script uit te voeren, wordt deze uitgevoerd in het scriptbereik. Het gebruik van de aanroepoperator verschilt niet van het uitvoeren van het script op naam.

& c:\scripts\sample.ps1

Meer informatie over de oproepoperator vindt u in about_Operators.

Als u het Sample.ps1 script in het lokale bereik wilt uitvoeren, typt u een punt en een spatie (. ) vóór het pad naar het script:

. c:\scripts\sample.ps1

Nu worden alle functies, aliassen of variabelen die in het script zijn gedefinieerd, toegevoegd aan het huidige bereik.

Beperken zonder bereik

PowerShell heeft enkele opties en functies die vergelijkbaar zijn met het bereik en die kunnen communiceren met bereiken. Deze functie kan worden verward met het bereik of het gedrag van het bereik.

Sessies, modules en geneste prompts zijn zelfstandige omgevingen, niet onderliggende bereiken van het globale bereik in de sessie.

Sessies

Een sessie is een omgeving waarin PowerShell wordt uitgevoerd. Wanneer u een sessie maakt op een externe computer, brengt PowerShell een permanente verbinding tot stand met de externe computer. Met de permanente verbinding kunt u de sessie gebruiken voor meerdere gerelateerde opdrachten.

Omdat een sessie een ingesloten omgeving is, heeft deze een eigen bereik, maar is een sessie geen onderliggend bereik van de sessie waarin deze is gemaakt. De sessie begint met een eigen globaal bereik. Dit bereik is onafhankelijk van het globale bereik van de sessie. U kunt onderliggende bereiken maken in de sessie. U kunt bijvoorbeeld een script uitvoeren om een onderliggend bereik in een sessie te maken.

Modules

U kunt een PowerShell-module gebruiken om PowerShell-hulpprogramma's te delen en te leveren. Een module is een eenheid die cmdlets, scripts, functies, variabelen, aliassen en andere nuttige items kan bevatten. Tenzij de items in een module expliciet zijn geëxporteerd (met behulp van Export-ModuleMember of het modulemanifest), zijn ze niet toegankelijk buiten de module. Daarom kunt u de module toevoegen aan uw sessie en de openbare items gebruiken zonder dat u zich zorgen hoeft te maken dat de andere items de cmdlets, scripts, functies en andere items in uw sessie kunnen overschrijven.

Modules worden standaard geladen in het bereik op hoofdniveau (globaal) van de runspace. Als u een module importeert, wordt het bereik niet gewijzigd. Binnen de sessie hebben modules hun eigen bereik. Houd rekening met de volgende module C:\temp\mod1.psm1:

$a = "Hello"

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

Nu maken we een globale variabele$a, geven we deze een waarde en roepen we de functie-foo aan.

$a = "Goodbye"
foo

De module declareert de variabele $a in het modulebereik en vervolgens voert de functie foo de waarde van de variabele in beide bereiken uit.

$a = Hello
$global:a = Goodbye

Modules maken parallelle bereikcontainers die zijn gekoppeld aan het bereik waarin ze zijn geïmporteerd. Items die door de module worden geëxporteerd, zijn beschikbaar vanaf het bereikniveau waarin ze worden geïmporteerd. Items die niet uit de module worden geëxporteerd, zijn alleen beschikbaar in de bereikcontainer van de module. Functies in de module hebben toegang tot items in het bereik waarin ze zijn geïmporteerd, evenals items in de bereikcontainer van de module.

Als u Module2 vanuit Module1 laadt, wordt Module2 geladen in de bereikcontainer van Module1. Alle exports van Module2 worden in het huidige modulebereik van Module1 geplaatst. Als u deze gebruikt Import-Module -Scope local, worden de exports in het huidige bereikobject geplaatst in plaats van op het hoogste niveau. Als u zich in een module bevindt en een andere module laadt met ( Import-Module -Scope global of Import-Module -Global), worden die module en de bijbehorende exports in het globale bereik geladen in plaats van het lokale bereik van de module. De functie WindowsCompatibility doet dit om proxymodules te importeren in de globale sessiestatus.

Geneste prompts

Geneste prompts hebben geen eigen bereik. Wanneer u een geneste prompt invoert, is de geneste prompt een subset van de omgeving. Maar u blijft binnen het lokale bereik.

Scripts hebben hun eigen bereik. Als u fouten in een script opspoort en u een onderbrekingspunt in het script bereikt, voert u het scriptbereik in.

Privéoptie

Aliassen en variabelen hebben een optieeigenschap die een waarde kan aannemen van Private. Items met de Private optie kunnen worden bekeken en gewijzigd in het bereik waarin ze worden gemaakt, maar ze kunnen niet buiten dat bereik worden weergegeven of gewijzigd.

Als u bijvoorbeeld een variabele maakt met een privéoptie in het globale bereik en vervolgens een script uitvoert, Get-Variable worden de privévariabele niet weergegeven met opdrachten in het script. Als u de algemene bereikaanpassing in dit exemplaar gebruikt, wordt de privévariabele niet weergegeven.

U kunt de optieparameter van de New-Variable, Set-Variableen New-AliasSet-Alias cmdlets gebruiken om de waarde van de eigenschap Option in te stellen op Privé.

Visibility

De eigenschap Zichtbaarheid van een variabele of alias bepaalt of u het item buiten de container kunt zien waarin het is gemaakt. Een container kan een module, script of module zijn. Zichtbaarheid is ontworpen voor containers op dezelfde manier als de waarde van de Privateeigenschap Option is ontworpen voor bereiken.

De eigenschap Zichtbaarheid neemt de Public en Private waarden. Items met persoonlijke zichtbaarheid kunnen alleen worden bekeken en gewijzigd in de container waarin ze zijn gemaakt. Als de container wordt toegevoegd of geïmporteerd, kunnen de items met persoonlijke zichtbaarheid niet worden weergegeven of gewijzigd.

Omdat zichtbaarheid is ontworpen voor containers, werkt deze anders in een bereik.

  • Als u een item maakt met persoonlijke zichtbaarheid in het globale bereik, kunt u het item in geen enkel bereik weergeven of wijzigen.
  • Als u de waarde van een variabele met persoonlijke zichtbaarheid probeert weer te geven of te wijzigen, retourneert PowerShell een foutbericht.

U kunt de New-Variable en Set-Variable cmdlets gebruiken om een variabele te maken die persoonlijke zichtbaarheid heeft.

Voorbeelden

Voorbeeld 1: Een variabelewaarde alleen wijzigen in een script

Met de volgende opdracht wordt de waarde van de $ConfirmPreference variabele in een script gewijzigd. De wijziging heeft geen invloed op het globale bereik.

Gebruik eerst de volgende opdracht om de waarde van de $ConfirmPreference variabele in het lokale bereik weer te geven:

PS>  $ConfirmPreference
High

Maak een Scope.ps1-script met de volgende opdrachten:

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

Voer het script uit. Het script wijzigt de waarde van de $ConfirmPreference variabele en rapporteert vervolgens de waarde ervan in het scriptbereik. De uitvoer moet er ongeveer uitzien als de volgende uitvoer:

The value of $ConfirmPreference is Low.

Test vervolgens de huidige waarde van de $ConfirmPreference variabele in het huidige bereik.

PS>  $ConfirmPreference
High

In dit voorbeeld ziet u dat wijzigingen in de waarde van een variabele in het scriptbereik niet van invloed zijn op de waarde van de variabele in het bovenliggende bereik.

Voorbeeld 2: Een variabelewaarde in verschillende bereiken weergeven

U kunt bereikaanpassingen gebruiken om de waarde van een variabele in het lokale bereik en in een bovenliggend bereik weer te geven.

Definieer eerst een $test variabele in het globale bereik.

$test = "Global"

Maak vervolgens een Sample.ps1 script waarmee de $test variabele wordt gedefinieerd. Gebruik in het script een bereikaanpassing om te verwijzen naar de globale of lokale versies van de $test variabele.

In Sample.ps1:

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

Wanneer u deze uitvoert Sample.ps1, moet de uitvoer er ongeveer uitzien als de volgende uitvoer:

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

Wanneer het script is voltooid, wordt alleen de globale waarde gedefinieerd $test in de sessie.

PS> $test
Global

Voorbeeld 3: De waarde van een variabele in een bovenliggend bereik wijzigen

Tenzij u een item beveiligt met de optie Privé of een andere methode, kunt u de waarde van een variabele in een bovenliggend bereik weergeven en wijzigen.

Definieer eerst een $test variabele in het globale bereik.

$test = "Global"

Maak vervolgens een Sample.ps1-script waarmee de $test variabele wordt gedefinieerd. Gebruik in het script een bereikaanpassing om te verwijzen naar de globale of lokale versies van de $test variabele.

In Sample.ps1:

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

Wanneer het script is voltooid, wordt de globale waarde gewijzigd $test .

PS> $test
Local

Voorbeeld 4: Een privévariabele maken

Een variabele kan privé worden gemaakt met behulp van de private: bereikaanpassing of door de variabele te maken met de eigenschap Option ingesteld op Private. Privévariabelen kunnen alleen worden weergegeven of gewijzigd in het bereik waarin ze zijn gemaakt.

In dit voorbeeld maakt het ScopeExample.ps1 script vijf functies. Met de eerste functie wordt de volgende functie aangeroepen, waarmee een onderliggend bereik wordt gemaakt. Een van de functies heeft een privévariabele die alleen kan worden weergegeven in het bereik waarin deze is gemaakt.

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

De uitvoer toont de waarde van de variabele in elk bereik. U kunt zien dat de privévariabele alleen zichtbaar is in funcBhet bereik waarin deze is gemaakt.

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'

Zoals wordt weergegeven in de uitvoer van ShowScopes, hebt u toegang tot variabelen uit andere bereiken met behulp van Get-Variable een bereiknummer en geeft u een bereiknummer op.

Voorbeeld 5: Een lokale variabele gebruiken in een externe opdracht

Gebruik de using bereikaanpassing voor variabelen in een externe opdracht die in de lokale sessie is gemaakt. PowerShell gaat ervan uit dat de variabelen in externe opdrachten zijn gemaakt in de externe sessie.

De syntaxis is:

$using:<VariableName>

Met de volgende opdrachten maakt u bijvoorbeeld een $Cred variabele in de lokale sessie en gebruikt u vervolgens de $Cred variabele in een externe opdracht:

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

De using bereikaanpassing is geïntroduceerd in PowerShell 3.0.

Zie ook