Set-Variable

Syntaxis

Default (Standaard)

Set-Variable
    [-Name] <String[]>
    [[-Value] <Object>]
    [-Include <String[]>]
    [-Exclude <String[]>]
    [-Description <String>]
    [-Option <ScopedItemOptions>]
    [-Force]
    [-Visibility <SessionStateEntryVisibility>]
    [-PassThru]
    [-Scope <String>]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

Description

Voorbeelden

Voorbeeld 1: Een variabele instellen en de waarde ervan ophalen

Set-Variable -Name "desc" -Value "A description"
Get-Variable -Name "desc"

Name                           Value
----                           -----
desc                           A description

Voorbeeld 2: Een globale variabele met het kenmerk Alleen-lezen instellen

Set-Variable -Name "processes" -Value (Get-Process) -Option Constant -Scope Global -Description "All processes" -PassThru |
    Format-List -Property *

Voorbeeld 3: Openbare versus privévariabelen begrijpen

New-Variable -Name "counter" -Visibility Public -Value 26
$Counter

26

Get-Variable c*

Name                  Value
----                  -----
Culture               en-US
ConsoleFileName
ConfirmPreference     High
CommandLineParameters {}
Counter               26

Set-Variable -Name "counter" -Visibility Private
Get-Variable c*

Name                  Value
----                  -----
Culture               en-US
ConsoleFileName
ConfirmPreference     High
CommandLineParameters {}

$counter

"Cannot access the variable '$counter' because it is a private variable"

.\use-counter.ps1
#Commands completed successfully.

Parameters

-Confirm

Voordat u de cmdlet uitvoert, vraagt het systeem om bevestiging.

Parametereigenschappen

Parametersets

-Description

Hiermee geeft u de beschrijving van de variabele.

Parametereigenschappen

Parametersets

-Exclude

Hiermee geeft u een matrix van items op die door deze cmdlet worden uitgesloten van de bewerking. De waarde van deze parameter komt in aanmerking voor de parameter Path. Voer een padelement of patroon in, zoals *.txt. Wildcards zijn toegestaan.

Parametereigenschappen

Parametersets

-Force

Hiermee kunt u een variabele maken met dezelfde naam als een bestaande alleen-lezenvariabele of de waarde van een alleen-lezenvariabele wijzigen.

Standaard kunt u een variabele overschrijven, tenzij de variabele een optiewaarde van ReadOnly of Constantheeft. Zie de parameter Option voor meer informatie.

Parametereigenschappen

Parametersets

-Include

Hiermee geeft u een matrix van items op die deze cmdlet in de bewerking bevat. De waarde van deze parameter komt in aanmerking voor de parameter Name. Voer een naam- of naampatroon in, zoals c*. Wildcards zijn toegestaan.

Parametereigenschappen

Parametersets

-Name

Hiermee geeft u de naam van de variabele.

Parametereigenschappen

Parametersets

-Option

Hiermee geeft u de waarde van de eigenschap Options van de variabele.

Geldige waarden zijn:

• None: hiermee stelt u geen opties in. (None is de standaardinstelling.)
• ReadOnly: kan worden verwijderd. Kan niet worden gewijzigd, behalve met behulp van de parameter Force.
• Constant: kan niet worden verwijderd of gewijzigd. Constant is alleen geldig wanneer u een variabele maakt. U kunt de opties van een bestaande variabele niet wijzigen in Constant.
• Private: de variabele is alleen beschikbaar in het huidige bereik.
• AllScope: de variabele wordt gekopieerd naar nieuwe bereiken die worden gemaakt.

Deze waarden worden gedefinieerd als een opsomming op basis van vlaggen. U kunt meerdere waarden combineren om meerdere vlaggen in te stellen met behulp van deze parameter. De waarden kunnen worden doorgegeven aan de parameter Option als een matrix met waarden of als een door komma's gescheiden tekenreeks van deze waarden. De cmdlet combineert de waarden met behulp van een binaire OF-bewerking. Het doorgeven van waarden als een matrix is de eenvoudigste optie en u kunt ook tabvoltooiing gebruiken voor de waarden.

Parametereigenschappen

Parametersets

-PassThru

Retourneert een object dat de nieuwe variabele vertegenwoordigt. Deze cmdlet genereert standaard geen uitvoer.

Parametereigenschappen

Parametersets

-Scope

Hiermee geeft u het bereik van de variabele. De acceptabele waarden voor deze parameter zijn:

• Global
• Local
• Script
• Private
• Een getal ten opzichte van het huidige bereik (0 tot het aantal bereiken, waarbij 0 het huidige bereik is en 1 het bovenliggende bereik is).

Local is de standaardwaarde.

Zie about_Scopesvoor meer informatie.

Parametereigenschappen

Parametersets

-Value

Hiermee geeft u de waarde van de variabele.

Parametereigenschappen

Parametersets

-Visibility

Bepaalt of de variabele zichtbaar is buiten de sessie waarin deze is gemaakt. Deze parameter is ontworpen voor gebruik in scripts en opdrachten die aan andere gebruikers worden geleverd.

Geldige waarden zijn:

• Public: de variabele is zichtbaar. (Public is de standaardinstelling.)
• Private: de variabele is niet zichtbaar.

Wanneer een variabele privé is, wordt deze niet weergegeven in lijsten met variabelen, zoals variabelen die worden geretourneerd door Get-Variable, of in weergaven van de Variabele: station. Opdrachten voor het lezen of wijzigen van de waarde van een privévariabele retourneren een fout. De gebruiker kan echter opdrachten uitvoeren die gebruikmaken van een privévariabele als de opdrachten zijn geschreven in de sessie waarin de variabele is gedefinieerd.

Parametereigenschappen

Parametersets

-WhatIf

Toont wat er zou gebeuren wanneer de cmdlet wordt uitgevoerd. De cmdlet wordt niet uitgevoerd.

Parametereigenschappen

Parametersets

CommonParameters

Invoerwaarden

Object

Uitvoerwaarden

None

PSVariable

Notities

Verwante koppelingen

• Clear-Variable
• Get-Variable
• Nieuwe Variabele
• Remove-Variable