Dela via


Get-Variable

Hämtar variablerna i den aktuella konsolen.

Syntax

Default (Standard)

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.

Parameteregenskaper

Typ:

String[]

Standardvärde:None
Stöder jokertecken:True
DontShow:False

Parameteruppsättningar

(All)
Position:Named
Obligatorisk:False
Värde från pipeline:False
Värde från pipeline efter egenskapsnamn:False
Värde från återstående argument:False

-Include

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

Parameteregenskaper

Typ:

String[]

Standardvärde:None
Stöder jokertecken:True
DontShow:False

Parameteruppsättningar

(All)
Position:Named
Obligatorisk:False
Värde från pipeline:False
Värde från pipeline efter egenskapsnamn:False
Värde från återstående argument:False

-Name

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

Parameteregenskaper

Typ:

String[]

Standardvärde:None
Stöder jokertecken:True
DontShow:False

Parameteruppsättningar

(All)
Position:0
Obligatorisk:False
Värde från pipeline:True
Värde från pipeline efter egenskapsnamn:True
Värde från återstående argument:False

-Scope

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

  • Global
  • Lokal
  • Skript
  • Ett tal i förhållande till det aktuella omfånget (från 0 till antalet omfång, där 0 är det aktuella omfånget och 1 är dess förälder)

Lokal är standard. Mer information finns i about_Scopes.

Parameteregenskaper

Typ:String
Standardvärde:None
Stöder jokertecken:False
DontShow:False

Parameteruppsättningar

(All)
Position:Named
Obligatorisk:False
Värde från pipeline:False
Värde från pipeline efter egenskapsnamn:False
Värde från återstående argument:False

-ValueOnly

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

Parameteregenskaper

Typ:SwitchParameter
Standardvärde:None
Stöder jokertecken:False
DontShow:False

Parameteruppsättningar

(All)
Position:Named
Obligatorisk:False
Värde från pipeline:False
Värde från pipeline efter egenskapsnamn:False
Värde från återstående argument:False

CommonParameters

Den här cmdleten stöder vanliga parametrar: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction och -WarningVariable. Mer information finns i about_CommonParameters.

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 kommandot Get-Variable 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öprovidern.