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 object

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.






Siehe auch




Inhaltsverzeichnis