Get-Variable
Ruft die Variablen in der aktuellen Konsole ab.
Syntax
Get-Variable [[-Name] <string[]>] [-Exclude <string[]>] [-Include <string[]>] [-Scope <string>] [-ValueOnly] [<CommonParameters>]
Beschreibung
Mit dem Cmdlet "Get-Variable" werden die Windows PowerShell-Variablen in der aktuellen Konsole abgerufen. Sie können nur die Werte der Variablen abrufen, indem Sie den ValueOnly-Parameter angeben, und Sie können die zurückgegebenen Variablen nach Name filtern.
Parameter
-Exclude <string[]>
Lässt die angegebenen Elemente aus. Platzhalter sind zulässig.
Erforderlich? |
false |
Position? |
named |
Standardwert |
|
Pipelineeingaben akzeptieren? |
false |
Platzhalterzeichen akzeptieren? |
false |
-Include <string[]>
Gibt nur die Elemente an, auf die das Cmdlet angewendet wird, und schließt alle anderen aus. Platzhalter sind zulässig.
Erforderlich? |
false |
Position? |
named |
Standardwert |
|
Pipelineeingaben akzeptieren? |
false |
Platzhalterzeichen akzeptieren? |
false |
-Name <string[]>
Gibt den Namen der Variablen an.
Erforderlich? |
false |
Position? |
1 |
Standardwert |
|
Pipelineeingaben akzeptieren? |
true (ByValue, ByPropertyName) |
Platzhalterzeichen akzeptieren? |
false |
-Scope <string>
Ruft nur die Variablen im angegebenen Bereich ab. Gültige Werte sind "global", "local", "script", oder eine Zahl in Bezug auf den aktuellen Bereich (0 bis zur Anzahl der Bereiche, wobei 0 der aktuelle Bereich und 1 der übergeordnete Bereich ist). Der Standardwert ist "local". Weitere Informationen finden Sie unter "about_Scopes".
Erforderlich? |
false |
Position? |
named |
Standardwert |
|
Pipelineeingaben akzeptieren? |
false |
Platzhalterzeichen akzeptieren? |
false |
-ValueOnly
Ruft nur den Wert der Variablen ab.
Erforderlich? |
false |
Position? |
named |
Standardwert |
|
Pipelineeingaben akzeptieren? |
false |
Platzhalterzeichen akzeptieren? |
false |
<CommonParameters>
Dieses Cmdlet unterstützt die folgenden allgemeinen Parameter: -Verbose, -Debug, -ErrorAction, -ErrorVariable, -OutBuffer und -OutVariable. Weitere Informationen finden Sie unter about_Commonparameters.
Eingaben und Ausgaben
Der Eingabetyp ist der Typ der Objekte, die über die Pipeline an das Cmdlet übergeben werden können. Der Rückgabetyp ist der Typ der Objekte, die das Cmdlet zurückgibt.
Eingaben |
System.String Sie können eine Zeichenfolge, die den Variablennamen enthält, über die Pipeline an Get-Variable übergeben. |
Ausgaben |
Variable-Objekt Get-Variable gibt ein System.Management.Automation-Variablenobjekt für jede abgerufene Variable zurück. Der Objekttyp hängt von der Variablen ab. |
Hinweise
Mit diesem Cmdlet werden keine Umgebungsvariablen verwaltet. Zum Verwalten von Umgebungsvariablen können Sie den Umgebungsvariablenanbieter verwenden.
Beispiel 1
C:\PS>get-variable m*
Beschreibung
-----------
Mit diesem Befehl werden Variablen angezeigt, deren Name mit dem Buchstaben "m" beginnt. Die Werte der Variablen werden ebenfalls angezeigt.
Beispiel 2
C:\PS>get-variable m* -valueonly
Beschreibung
-----------
Mit diesem Befehl werden nur die Werte der Variablen angezeigt, deren Name mit dem Buchstaben "m" beginnt.
Beispiel 3
C:\PS>get-variable -include M*,P* | sort-object name
Beschreibung
-----------
Mit diesem Befehl werden Informationen über die Variablen abgerufen, die mit dem Buchstaben "M" oder "P" beginnen. Die Ergebnisse werden über die Pipeline an das Cmdlet "Sort-Object" übergeben, nach Namen sortiert und angezeigt.
Beispiel 4
C:\PS>get-variable -scope 0
C:\PS> compare-object (get-variable -scope 0) (get-variable -scope 1)
Beschreibung
-----------
Im ersten Befehl werden nur die im lokalen Bereich definierten Variablen abgerufen. Er entspricht "get-variable -scope local" und kann mit "gv -s 0" abgekürzt werden.
Im zweiten Befehl wird das Cmdlet "Compare-Object" verwendet, um die Variablen zu suchen, die im übergeordneten Bereich (Scope 1) definiert sind, jedoch nur im lokalen Bereich (Scope 0) sichtbar sind.