Share via

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

Dieser Befehl ruft nur die Werte der Variablen ab, deren Namen mit m beginnen.

Get-Variable m* -ValueOnly

Beispiel 3: Abrufen von Variablen mit 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. Sie 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 suchen, 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 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 angewendet wird, 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 bis zur Anzahl der Bereiche, wobei 0 der aktuelle Bereich und 1 sein übergeordnetes 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, die den Variablennamen enthält, an übergeben Get-Variable.

Ausgaben

PSVariable

Dieses Cmdlet gibt ein System.Management.AutomationPSVariable-Objekt für jede Variable zurück, die es 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, Get-Variable wird ein [System.Object[]]zurückgegeben. Dieses Verhalten verhindert, dass der normale Pipelinevorgang die Werte der Variablen einzeln verarbeitet. Eine Problemumgehung zum Erzwingen der Auflistungsaufzählung besteht darin, den Get-Variable Befehl in Klammern einzuschließen.

Hinweise

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