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 Windows PowerShell. Du kan tilldela ett värde till variabeln när du skapar den eller tilldela eller ändra värdet när det har skapats.

Du kan använda parametrarna i New-Variable 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 Ny variabel för att använda dess parametrar.

Exempel

Exempel 1: Skapa en variabel

PS C:\> 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

PS C:\> 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 alternativet ReadOnly i 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: Skapa en privat variabel

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

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.

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 variabeln Counter, men variabeln Counter kan läsas och ändras av kommandona i modulen.

Exempel 5: Skapa en variabel med ett blanksteg

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

Det här kommandot 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.

Parametrar

-Confirm

-Description

-Force

-Name

-Option

-PassThru

-Scope

-Value

-Visibility

-WhatIf

Indata

Object

Du kan skicka ett värde till New-Variable.

Utdata

None or System.Management.Automation.PSVariable

När du använder parametern PassThru genererar New-Variable ett System.Management.Automation.PSVariable-objekt som representerar den nya variabeln. Annars genererar den här cmdleten inga utdata.

Relaterade länkar

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