New-Variable

Syntax

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

Beschreibung

Das New-Variable Cmdlet erstellt eine neue Variable in PowerShell. Sie können der Variablen beim Erstellen einen Wert zuweisen oder den Wert zuweisen bzw. ändern, nachdem die Variable erstellt wurde.

Sie können die Parameter New-Variable verwenden, um die Eigenschaften der Variablen festzulegen, den Bereich einer Variablen festzulegen und zu bestimmen, ob Variablen öffentlich oder privat sind.

In der Regel erstellen Sie eine neue Variable, indem Sie den Variablennamen und den zugehörigen Wert eingeben, z $Var = 3. B. das Cmdlet verwenden, um dessen Parameter zu verwenden New-Variable .

Beispiele

Beispiel 1: Erstellen einer Variablen

New-Variable days

Mit diesem Befehl wird eine neue Variable namens "Days" erstellt. Sie müssen den Parameter Name nicht eingeben.

Beispiel 2: Erstellen einer Variablen und Zuweisen eines Werts

New-Variable -Name "zipcode" -Value 98033

Mit diesem Befehl wird eine Variable namens Zipcode erstellt und dem Wert 98033 zugewiesen.

Beispiel 3: Erstellen einer Variablen mit der Option "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

In diesem Beispiel wird gezeigt, wie Sie die ReadOnly Option New-Variable verwenden, eine Variable vor überschrieben zu werden.

Der erste Befehl erstellt eine neue Variable mit dem Namen "Max" und legt den Wert auf 256 fest. Er verwendet den Parameter Option mit einem Wert von ReadOnly.

Der zweite Befehl versucht, eine zweite Variable mit demselben Namen zu erstellen. Dieser Befehl gibt einen Fehler zurück, da für diese Variable die Option „schreibgeschützt“ festgelegt ist.

Der dritte Befehl verwendet den Parameter Force , um den schreibgeschützten Schutz für die Variable außer Kraft zu setzen. In diesem Fall ist der Befehl zum Erstellen einer neuen Variable mit dem gleichen Namen erfolgreich.

Beispiel 4: Zuweisen mehrerer Optionen zu einer Variablen

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

In diesem Beispiel wird eine Variable erstellt und die AllScope Optionen zugewiesen Constant , sodass die Variable im aktuellen Bereich und allen neuen Bereichen verfügbar ist, die erstellt wurden und nicht geändert oder gelöscht werden können.

Beispiel 5: Erstellen einer privaten Variablen

Mit diesem Befehl wird das Verhalten einer privaten Variable in einem Modul veranschaulicht. Das Modul enthält das Get-Counter Cmdlet, das über eine private Variable mit dem Namen Counter verfügt. Der Befehl verwendet den Visibility-Parameter mit dem Wert "Private", um die Variable zu erstellen.

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

Die Beispielausgabe zeigt das Verhalten einer privaten Variable. Der Benutzer, der das Modul geladen hat, kann den Wert der Counter-Variable nicht anzeigen oder ändern, die Counter-Variable kann jedoch durch die Befehle im Modul gelesen und geändert werden.

Beispiel 6: Erstellen einer Variablen mit einem Leerzeichen

In diesem Beispiel wird veranschaulicht, dass Variablen mit Leerzeichen erstellt werden können. Auf die Variablen kann mithilfe des Get-Variable Cmdlets oder direkt durch Trennzeichen einer Variablen mit geschweiften Klammern zugegriffen werden.

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

Parameter

-Confirm

-Description

-Force

-Name

-Option

-PassThru

-Scope

-Value

-Visibility

-WhatIf

Eingaben

Object

Sie können jedes Objekt an New-Variable.

Ausgaben

None

Standardmäßig gibt dieses Cmdlet keine Ausgabe zurück.

PSVariable

Wenn Sie den PassThru-Parameter verwenden, gibt dieses Cmdlet ein PSVariable-Objekt zurück, das die neue Variable darstellt.

Hinweise

PowerShell enthält die folgenden Aliase für New-Variable:

• Alle Plattformen:
  • nv

Ähnliche Themen

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