Condividi tramite

Get-Variable

  • Riferimento
Modulo:
Microsoft.PowerShell.Utility

Ottiene le variabili nella console corrente.

Sintassi

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

Descrizione

Il Get-Variable cmdlet ottiene le variabili di PowerShell nella console corrente. È possibile recuperare solo i valori delle variabili specificando il parametro ValueOnly e filtrare le variabili restituite in base al nome.

Esempio

Esempio 1: Ottenere le variabili in base alla lettera

Questo comando ottiene variabili con nomi che iniziano con la lettera m. Il comando ottiene anche il valore delle variabili.

Get-Variable m*

Esempio 2: Ottenere valori di variabile in base alla lettera

Questo comando ottiene solo i valori delle variabili con nomi che iniziano con m.

Get-Variable m* -ValueOnly

Esempio 3: Ottenere le variabili in base a due lettere

Questo comando ottiene informazioni sulle variabili che iniziano con la lettera M o la lettera P.

Get-Variable -Include M*,P*

Esempio 4: Ottenere variabili per ambito

Il primo comando ottiene solo le variabili definite nell'ambito locale. Equivale a Get-Variable -Scope Local e può essere abbreviato come gv -s 0.

Il secondo comando usa il Compare-Object cmdlet per trovare le variabili definite nell'ambito padre (Ambito 1), ma sono visibili solo nell'ambito locale (Ambito 0).

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

Parametri

-Exclude

Specifica una matrice di elementi esclusi dal cmdlet dall'operazione. I caratteri jolly sono consentiti.

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

-Include

Specifica una matrice di elementi in base al quale il cmdlet funzionerà, esclusi tutti gli altri. I caratteri jolly sono consentiti.

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

-Name

Specifica il nome della variabile. I caratteri jolly sono consentiti. È anche possibile inviare un nome di variabile a Get-Variable.

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

-Scope

Specifica le variabili nell'ambito. I valori accettabili per questo parametro sono:

  • Global
  • Locale
  • Script
  • Numero relativo all'ambito corrente (0 al numero di ambiti, dove 0 è l'ambito corrente e 1 è il relativo padre)

Local è il valore predefinito. Per altre informazioni, vedere about_Scopes.

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

-ValueOnly

Indica che questo cmdlet ottiene solo il valore della variabile.

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

Input

String

È possibile inviare una pipe a una stringa contenente il nome della variabile a questo cmdlet.

Output

PSVariable

Per impostazione predefinita, questo cmdlet restituisce un oggetto AutomationPSVariable per ogni variabile che ottiene. Il tipo di oggetto dipende dalla variabile.

Object[]

Quando si specifica il parametro ValueOnly e il valore della variabile specificata è una raccolta, questo cmdlet restituisce un [System.Object[]]oggetto . Questo comportamento impedisce alla normale operazione della pipeline di elaborare i valori della variabile uno alla volta. Una soluzione alternativa per forzare l'enumerazione della raccolta consiste nel racchiudere il Get-Variable comando tra parentesi.

Note

PowerShell include gli alias seguenti per Get-Variable:

  • Tutte le piattaforme:

    • gv

  • Questo cmdlet non gestisce le variabili di ambiente. Per gestire le variabili di ambiente, è possibile usare il provider di variabili di ambiente.