Get-Variable
Ruft die Variablen in der aktuellen Konsole ab.
Syntax
Default (Standardwert)
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.
Parametereigenschaften
| Typ: | String[] |
| Standardwert: | None |
| Unterstützt Platzhalter: | True |
| Nicht anzeigen: | False |
Parametersätze
(All)
| Position: | Named |
| Obligatorisch.: | False |
| Wert aus Pipeline: | False |
| Wert aus Pipeline nach dem Eigenschaftsnamen: | False |
| Wert aus verbleibenden Argumenten: | False |
-Include
Gibt ein Array von Elementen an, auf denen das Cmdlet fungiert, mit Ausnahme aller anderen Elemente. Wildcards sind zulässig.
Parametereigenschaften
| Typ: | String[] |
| Standardwert: | None |
| Unterstützt Platzhalter: | True |
| Nicht anzeigen: | False |
Parametersätze
(All)
| Position: | Named |
| Obligatorisch.: | False |
| Wert aus Pipeline: | False |
| Wert aus Pipeline nach dem Eigenschaftsnamen: | False |
| Wert aus verbleibenden Argumenten: | False |
-Name
Gibt den Namen der Variablen an.
Wildcards sind zulässig.
Sie können auch einen Variablennamen an Get-Variablesenden.
Parametereigenschaften
| Typ: | String[] |
| Standardwert: | None |
| Unterstützt Platzhalter: | True |
| Nicht anzeigen: | False |
Parametersätze
(All)
| Position: | 0 |
| Obligatorisch.: | False |
| Wert aus Pipeline: | True |
| Wert aus Pipeline nach dem Eigenschaftsnamen: | True |
| Wert aus verbleibenden Argumenten: | False |
-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.
Parametereigenschaften
| Typ: | String |
| Standardwert: | None |
| Unterstützt Platzhalter: | False |
| Nicht anzeigen: | False |
Parametersätze
(All)
| Position: | Named |
| Obligatorisch.: | False |
| Wert aus Pipeline: | False |
| Wert aus Pipeline nach dem Eigenschaftsnamen: | False |
| Wert aus verbleibenden Argumenten: | False |
-ValueOnly
Gibt an, dass dieses Cmdlet nur den Wert der Variablen abruft.
Parametereigenschaften
| Typ: | SwitchParameter |
| Standardwert: | None |
| Unterstützt Platzhalter: | False |
| Nicht anzeigen: | False |
Parametersätze
(All)
| Position: | Named |
| Obligatorisch.: | False |
| Wert aus Pipeline: | False |
| Wert aus Pipeline nach dem Eigenschaftsnamen: | False |
| Wert aus verbleibenden Argumenten: | False |
CommonParameters
Dieses Cmdlet unterstützt die allgemeinen Parameter -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction und -WarningVariable. Weitere Informationen findest du unter about_CommonParameters.
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 Umgebungsanbieter verwenden.
