Get-Variable

  • Referens
Modul:
Microsoft.PowerShell.Utility

Hämtar variablerna i den aktuella konsolen.

Syntax

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

Description

Cmdleten Get-Variable hämtar PowerShell-variablerna i den aktuella konsolen. Du kan hämta bara värdena för variablerna genom att ange parametern ValueOnly och du kan filtrera variablerna som returneras efter namn.

Exempel

Exempel 1: Hämta variabler per bokstav

Det här kommandot hämtar variabler med namn som börjar med bokstaven m. Kommandot hämtar också värdet för variablerna.

Get-Variable m*

Exempel 2: Hämta variabelvärden per bokstav

Det här kommandot hämtar endast värdena för variablerna som har namn som börjar med m.

Get-Variable m* -ValueOnly

Exempel 3: Hämta variabler med två bokstäver

Det här kommandot hämtar information om variablerna som börjar med bokstaven M eller bokstaven P.

Get-Variable -Include M*,P*

Exempel 4: Hämta variabler efter omfång

Det första kommandot hämtar endast de variabler som definieras i det lokala omfånget. Det motsvarar Get-Variable -Scope Local och kan förkortas som gv -s 0.

Det andra kommandot använder cmdleten Compare-Object för att hitta variablerna som definieras i det överordnade omfånget (omfång 1) men som endast visas i det lokala omfånget (omfång 0).

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

Parametrar

-Exclude

Anger en matris med objekt som den här cmdleten undantar från åtgärden. Jokertecken tillåts.

Type:String[]
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:True

-Include

Anger en matris med objekt som cmdleten ska fungera på, exklusive alla andra. Jokertecken tillåts.

Type:String[]
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:True

-Name

Anger namnet på variabeln. Jokertecken tillåts. Du kan också skicka ett variabelnamn till Get-Variable.

Type:String[]
Position:0
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:True

-Scope

Anger variablerna i omfånget. De godtagbara värdena för den här parametern är:

  • Globala
  • Lokala
  • Skript
  • Ett tal i förhållande till det aktuella omfånget (0 genom antalet omfång, där 0 är det aktuella omfånget och 1 är dess överordnade)

Lokal är standardinställningen. Mer information finns i about_Scopes.

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-ValueOnly

Anger att denna cmdlet endast hämtar värdet för variabeln.

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

Indata

String

Du kan skicka en sträng som innehåller variabelnamnet till den här cmdleten.

Utdata

PSVariable

Som standard returnerar den här cmdleten ett AutomationPSVariable-objekt för varje variabel som den får. Objekttypen beror på variabeln.

Object[]

När du anger parametern ValueOnly och den angivna variabelns värde är en samling returnerar den här cmdleten en [System.Object[]]. Det här beteendet förhindrar att normal pipelineåtgärd bearbetar variabelns värden en i taget. En lösning för att framtvinga samlingsuppräkning är att omsluta Get-Variable kommandot inom parenteser.

Kommentarer

PowerShell innehåller följande alias för Get-Variable:

  • Alla plattformar:

    • gv

  • Den här cmdleten hanterar inte miljövariabler. Om du vill hantera miljövariabler kan du använda miljövariabelprovidern.