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 Get-Variable Cmdlet 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 Name 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

Mit diesem Befehl werden nur die Werte der Variablen abgerufen, deren Namen mit m beginnen.

Get-Variable m* -ValueOnly

Beispiel 3: Abrufen von Variablen um zwei Buchstaben

Dieser Befehl ruft Informationen zu den Variablen ab, die entweder 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 0abgekürzt werden.

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, das dieses Cmdlet aus dem 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 das das Cmdlet reagiert, wobei alle anderen ausgenommen sind. 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 übergeben 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 durch die Anzahl der Bereiche, wobei 0 der aktuelle Bereich und 1 sein übergeordneter Bereich ist)

Local 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, die den Variablennamen enthält, an dieses Cmdlet weiterleiten.

Ausgaben

PSVariable

Standardmäßig gibt dieses Cmdlet ein AutomationPSVariable-Objekt für jede Variable zurück, die es erhält. 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 einen [System.Object[]]zurück. Dieses Verhalten verhindert, dass der normale Pipelinebetrieb die Werte der Variablen einzeln verarbeitet. Eine Problemumgehung zum Erzwingen der Auflistungsaufzählung besteht darin, den Get-Variable Befehl in Klammern einzufügen.

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.