Freigeben über

Get-Variable

  • Referenz
Modul:
Microsoft.PowerShell.Utility

Ruft die Variablen in der aktuellen Konsole ab.

Syntax

Get-Variable
   [[-Name] <String[]>]
   [-ValueOnly]
   [-Include <String[]>]
   [-Exclude <String[]>]
   [-Scope <String>]
   [<CommonParameters>]

Beschreibung

Das Cmdlet Get-Variable ruft die PowerShell-Variablen in der aktuellen Konsole ab. Sie können nur die Werte der Variablen abrufen, indem Sie den ValueOnly Parameter angeben, und Sie können die variablen filtern, die nach Namen zurückgegeben werden.

Beispiele

Beispiel 1: Abrufen von Variablen nach Buchstaben

Dieser Befehl ruft Variablen mit Namen ab, die mit dem Buchstaben m beginnen. Der Befehl ruft auch den Wert der Variablen ab.

Get-Variable m*

Beispiel 2: Abrufen von Variablenwerten nach Buchstaben

Dieser Befehl ruft nur die Werte der Variablen ab, die namen haben, die mit m beginnen.

Get-Variable m* -ValueOnly

Beispiel 3: Abrufen von Variablen nach zwei Buchstaben

Dieser Befehl ruft Informationen zu den Variablen ab, die mit dem Buchstaben M oder dem Buchstaben P beginnen.

Get-Variable -Include M*,P*

Beispiel 4: Abrufen von Variablen nach Bereich

Der erste Befehl ruft nur die Variablen ab, die im lokalen Bereich definiert sind. Es entspricht Get-Variable -Scope Local und kann als gv -s 0gekürzt werden.

Der zweite Befehl verwendet das Cmdlet Compare-Object, um die Variablen zu finden, die im übergeordneten Bereich (Bereich 1) definiert sind, aber nur im lokalen Bereich (Bereich 0) sichtbar sind.

Get-Variable -Scope 0
Compare-Object (Get-Variable -Scope 0) (Get-Variable -Scope 1)

Parameter

-Exclude

Gibt ein Array von Elementen an, die dieses Cmdlet vom Vorgang ausschließt. Wildcards sind zulässig.

Typ:String[]
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:True

-Include

Gibt ein Array von Elementen an, auf denen das Cmdlet fungiert, mit Ausnahme aller anderen Elemente. Wildcards sind zulässig.

Typ:String[]
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:True

-Name

Gibt den Namen der Variablen an. Wildcards sind zulässig. Sie können auch einen Variablennamen an Get-Variablesenden.

Typ:String[]
Position:0
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:True
Platzhalterzeichen akzeptieren:True

-Scope

Gibt die Variablen im Bereich an. Die zulässigen Werte für diesen Parameter sind:

  • Global
  • lokale
  • Skript-
  • Eine Zahl relativ zum aktuellen Bereich (0 bis zur Anzahl der Bereiche, wobei 0 der aktuelle Bereich ist und 1 das übergeordnete Element ist)

lokale ist die Standardeinstellung. Weitere Informationen finden Sie unter about_Scopes.

Typ:String
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-ValueOnly

Gibt an, dass dieses Cmdlet nur den Wert der Variablen abruft.

Typ:SwitchParameter
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

Eingaben

String

Sie können eine Zeichenfolge mit dem Variablennamen an dieses Cmdlet weiterleiten.

Ausgaben

PSVariable

Standardmäßig gibt dieses Cmdlet ein AutomationPSVariable-Objekt für jede variable zurück, die sie abruft. Der Objekttyp hängt von der Variablen ab.

Object[]

Wenn Sie den ValueOnly Parameter angeben und der Wert der angegebenen Variablen eine Auflistung ist, gibt dieses Cmdlet eine [System.Object[]]zurück. Dieses Verhalten verhindert, dass der normale Pipelinevorgang die Werte der Variablen einzeln verarbeitet. Eine Problemumgehung zum Erzwingen der Auflistungsenumeration besteht darin, den Befehl Get-Variable in Klammern einzuschließen.

Hinweise

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

  • Alle Plattformen:

    • gv

  • Dieses Cmdlet verwaltet keine Umgebungsvariablen. Zum Verwalten von Umgebungsvariablen können Sie den Umgebungsvariablenanbieter verwenden.