Delen via

Get-Variable

  • Referentie
Module:
Microsoft.PowerShell.Utility

Haalt de variabelen op in de huidige console.

Syntaxis

Get-Variable
   [[-Name] <String[]>]
   [-ValueOnly]
   [-Include <String[]>]
   [-Exclude <String[]>]
   [-Scope <String>]
   [<CommonParameters>]

Description

De Get-Variable cmdlet haalt de PowerShell-variabelen op in de huidige console. U kunt alleen de waarden van de variabelen ophalen door de parameter ValueOnly op te geven en u kunt de variabelen filteren die worden geretourneerd op naam.

Voorbeelden

Voorbeeld 1: Variabelen ophalen op letter

Met deze opdracht worden variabelen met namen ophaalt die beginnen met de letter m. Met de opdracht wordt ook de waarde van de variabelen opgehaald.

Get-Variable m*

Voorbeeld 2: Variabele waarden ophalen op letter

Met deze opdracht worden alleen de waarden opgehaald van de variabelen met namen die beginnen met m.

Get-Variable m* -ValueOnly

Voorbeeld 3: Variabelen ophalen met twee letters

Met deze opdracht wordt informatie opgehaald over de variabelen die beginnen met de letter M of de letter P.

Get-Variable -Include M*,P*

Voorbeeld 4: Variabelen ophalen op bereik

De eerste opdracht haalt alleen de variabelen op die zijn gedefinieerd in het lokale bereik. Het is gelijk aan Get-Variable -Scope Local en kan worden afgekort als gv -s 0.

De tweede opdracht gebruikt de Compare-Object cmdlet om de variabelen te vinden die zijn gedefinieerd in het bovenliggende bereik (Bereik 1), maar zijn alleen zichtbaar in het lokale bereik (Bereik 0).

Get-Variable -Scope 0
Compare-Object (Get-Variable -Scope 0) (Get-Variable -Scope 1)

Parameters

-Exclude

Hiermee geeft u een matrix van items op die door deze cmdlet worden uitgesloten van de bewerking. Jokertekens zijn toegestaan.

Type:String[]
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:True

-Include

Hiermee geeft u een matrix van items waarop de cmdlet zal handelen, met uitzondering van alle andere. Jokertekens zijn toegestaan.

Type:String[]
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:True

-Name

Hiermee geeft u de naam van de variabele. Jokertekens zijn toegestaan. U kunt ook de naam van een variabele doorsluisen naar Get-Variable.

Type:String[]
Position:0
Default value:None
Vereist:False
Pijplijninvoer accepteren:True
Jokertekens accepteren:True

-Scope

Hiermee geeft u de variabelen in het bereik. De acceptabele waarden voor deze parameter zijn:

  • Globaal
  • Lokaal
  • Script
  • Een getal ten opzichte van het huidige bereik (0 tot het aantal bereiken, waarbij 0 het huidige bereik is en 1 het bovenliggende bereik is)

Lokaal is de standaardinstelling. Zie about_Scopes voor meer informatie.

Type:String
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-ValueOnly

Geeft aan dat deze cmdlet alleen de waarde van de variabele ophaalt.

Type:SwitchParameter
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

Invoerwaarden

String

U kunt een tekenreeks met de naam van de variabele doorsluisen naar deze cmdlet.

Uitvoerwaarden

PSVariable

Deze cmdlet retourneert standaard een AutomationPSVariable-object voor elke variabele die wordt opgehaald. Het objecttype is afhankelijk van de variabele.

Object[]

Wanneer u de parameter ValueOnly opgeeft en de waarde van de opgegeven variabele een verzameling is, retourneert deze cmdlet een [System.Object[]]. Dit gedrag voorkomt dat normale pijplijnbewerkingen de waarden van de variabele één voor één verwerken. Een tijdelijke oplossing voor het afdwingen van verzamelingsinventarisatie is het plaatsen van de Get-Variable opdracht tussen haakjes.

Notities

PowerShell bevat de volgende aliassen voor Get-Variable:

  • Alle platformen:

    • gv

  • Met deze cmdlet worden omgevingsvariabelen niet beheerd. Als u omgevingsvariabelen wilt beheren, kunt u de provider van de omgevingsvariabele gebruiken.