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 Get-Variable Cmdlet ruft die PowerShell-Variablen in der aktuellen Konsole ab. Sie können nur die Werte der Variablen abrufen, indem Sie den Parameter ValueOnly angeben, und Sie können die zurückgegebenen Variablen nach Namen filtern.

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 abgekürzt werden als gv -s 0.

Der zweite Befehl verwendet das Compare-Object Cmdlet, 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. Platzhalter sind zulässig.

Type:String[]
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:True

-Include

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

Type:String[]
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:True

-Name

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

Type:String[]
Position:0
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:True

-Scope

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

  • Global
  • Lokal
  • 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)

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

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-ValueOnly

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

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters: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 Variable ab.

Object[]

Wenn Sie den ValueOnly-Parameter angeben und der Wert der angegebenen Variablen eine Auflistung ist, gibt dieses Cmdlet ein [System.Object[]]. Dieses Verhalten verhindert, dass der normale Pipelinevorgang die Werte der Variablen einzeln verarbeitet. Eine Problemumgehung zum Erzwingen der Auflistungsenumeration besteht darin, den Get-Variable Befehl 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.