New-Variable

Syntax

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

Description

Cmdleten New-Variable skapar en ny variabel i PowerShell. Du kan tilldela variabeln ett värde när du skapar den eller tilldela eller ändra värdet när den har skapats.

Du kan använda parametrarna New-Variable för för att ange egenskaperna för variabeln, ange omfånget för en variabel och avgöra om variabler är offentliga eller privata.

Vanligtvis skapar du en ny variabel genom att skriva variabelnamnet och dess värde, till exempel $Var = 3, men du kan använda cmdleten New-Variable för att använda dess parametrar.

Exempel

Exempel 1: Skapa en variabel

New-Variable days

Det här kommandot skapar en ny variabel med namnet days. Du behöver inte ange parametern Namn .

Exempel 2: Skapa en variabel och tilldela den ett värde

New-Variable -Name "zipcode" -Value 98033

Det här kommandot skapar en variabel med namnet zipcode och tilldelar den värdet 98033.

Exempel 3: Skapa en variabel med alternativet ReadOnly

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

Det här exemplet visar hur du använder ReadOnly alternativet New-Variable för att skydda en variabel från att skrivas över.

Det första kommandot skapar en ny variabel med namnet Max och anger värdet till 256. Den använder parametern Alternativ med värdet ReadOnly.

Det andra kommandot försöker skapa en andra variabel med samma namn. Det här kommandot returnerar ett fel eftersom det skrivskyddade alternativet har angetts för variabeln.

Det tredje kommandot använder force-parametern för att åsidosätta det skrivskyddade skyddet för variabeln. I det här fallet lyckas kommandot för att skapa en ny variabel med samma namn.

Exempel 4: Tilldela flera alternativ till en variabel

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

Det här exemplet skapar en variabel och tilldelar AllScope alternativen och Constant så att variabeln blir tillgänglig i det aktuella omfånget och eventuella nya omfång som skapas och inte kan ändras eller tas bort.

Exempel 5: Skapa en privat variabel

Det här kommandot visar beteendet för en privat variabel i en modul. Modulen innehåller cmdleten Get-Counter , som har en privat variabel med namnet Counter. Kommandot använder parametern Synlighet med värdet Privat för att skapa variabeln.

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

Exempelutdata visar beteendet för en privat variabel. Användaren som har läst in modulen kan inte visa eller ändra värdet för räknarvariabeln, men variabeln Counter kan läsas och ändras av kommandona i modulen.

Exempel 6: Skapa en variabel med ett blanksteg

Det här exemplet visar att variabler med blanksteg kan skapas. Variablerna kan nås med hjälp av cmdleten Get-Variable eller direkt genom att avgränsa en variabel med klammerparenteser.

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

Parametrar

-Confirm

-Description

-Force

-Name

-Option

-PassThru

-Scope

-Value

-Visibility

-WhatIf

Indata

Object

Du kan skicka valfritt objekt till New-Variable.

Utdata

None

Som standard returnerar den här cmdleten inga utdata.

PSVariable

När du använder parametern PassThru returnerar den här cmdleten ett PSVariable-objekt som representerar den nya variabeln.

Kommentarer

PowerShell innehåller följande alias för New-Variable:

• Alla plattformar:
  • nv

Relaterade länkar

• Clear-Variable
• Get-Variable
• Remove-Variable
• Set-Variable