New-Variable

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

Met de New-Variable-cmdlet maakt u een nieuwe variabele in PowerShell. U kunt een waarde toewijzen aan de variabele tijdens het maken of de waarde toewijzen of wijzigen nadat deze is gemaakt.

U kunt de parameters van New-Variable gebruiken om de eigenschappen van de variabele in te stellen, het bereik van een variabele in te stellen en te bepalen of variabelen openbaar of privé zijn.

Normaal gesproken maakt u een nieuwe variabele door de naam van de variabele en de bijbehorende waarde te typen, zoals $Var = 3, maar u kunt de cmdlet New-Variable gebruiken om de parameters te gebruiken.

New-Variable days

Met deze opdracht maakt u een nieuwe variabele met de naam dagen. U hoeft de parameter Name niet te typen.

New-Variable -Name "zipcode" -Value 98033

Met deze opdracht maakt u een variabele met de naam postcode en wijst u deze toe aan de waarde 98033.

PS C:\> New-Variable -Name Max -Value 256 -Option ReadOnly
PS C:\> New-Variable -Name max -Value 1024

New-Variable : A variable with name 'max' already exists.
At line:1 char:1
+ New-Variable -Name max -Value 1024
+ ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
    + CategoryInfo          : ResourceExists: (max:String) [New-Variable], SessionStateException
    + FullyQualifiedErrorId : VariableAlreadyExists,Microsoft.PowerShell.Commands.NewVariableCommand

PS C:\> New-Variable -Name max -Value 1024 -Force

In dit voorbeeld ziet u hoe u de ReadOnly optie van New-Variable gebruikt om een variabele te beschermen tegen overschrijven.

Met de eerste opdracht maakt u een nieuwe variabele met de naam Max en stelt u de waarde in op 256. Hierbij wordt de parameter Option gebruikt met een waarde van ReadOnly.

Met de tweede opdracht wordt geprobeerd een tweede variabele met dezelfde naam te maken. Met deze opdracht wordt een fout geretourneerd, omdat de optie alleen-lezen is ingesteld op de variabele.

De derde opdracht maakt gebruik van de parameter Forceren om de alleen-lezenbeveiliging voor de variabele te overschrijven. In dit geval slaagt de opdracht om een nieuwe variabele met dezelfde naam te maken.

New-Variable -Name 'TestVariable' -Value 'Test Value' -Option AllScope,Constant

In dit voorbeeld wordt een variabele gemaakt en worden de opties AllScope en Constant toegewezen, zodat de variabele beschikbaar is in het huidige bereik en nieuwe bereiken die zijn gemaakt en niet kunnen worden gewijzigd of verwijderd.

Met deze opdracht wordt het gedrag van een privévariabele in een module gedemonstreert. De module bevat de Get-Counter cmdlet, met een privévariabele met de naam Counter. De opdracht maakt gebruik van de parameter Visibility met de waarde Private om de variabele te maken.

PS C:\> New-Variable -Name counter -Visibility Private

#Effect of private variable in a module.

PS C:\> Get-Variable c*

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

PS C:\> $counter
"Cannot access the variable '$counter' because it is a private variable"
At line:1 char:1
+ $counter
+ ~~~~~~~~
    + CategoryInfo          : PermissionDenied: (counter:String) [], SessionStateException
    + FullyQualifiedErrorId : VariableIsPrivate

PS C:\> Get-Counter
Name         Value
----         -----
Counter1     3.1415
...

In de voorbeelduitvoer ziet u het gedrag van een privévariabele. De gebruiker die de module heeft geladen, kan de waarde van de tellervariabele niet weergeven of wijzigen, maar de tellervariabele kan worden gelezen en gewijzigd door de opdrachten in de module.

In dit voorbeeld ziet u dat variabelen met spaties kunnen worden gemaakt. De variabelen kunnen worden geopend met behulp van de cmdlet Get-Variable of rechtstreeks door een variabele met accolades te scheiden.

PS C:\> New-Variable -Name 'with space' -Value 'abc123xyz'

PS C:\> Get-Variable -Name 'with space'

Name                           Value
----                           -----
with space                     abc123xyz

PS C:\> ${with space}
abc123xyz

Deze cmdlet ondersteunt de algemene parameters: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction en -WarningVariable. Zie about_CommonParametersvoor meer informatie.

U kunt elk object doorslangen naar New-Variable.

Deze cmdlet retourneert standaard geen uitvoer.

Wanneer u de parameter PassThru gebruikt, retourneert deze cmdlet een PSVariable-object dat de nieuwe variabele vertegenwoordigt.

PowerShell bevat de volgende aliassen voor New-Variable:

• Alle platforms:
  • nv