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 ed è possibile filtrare le variabili restituite in base al nome.

Esempio

Esempio 1: Ottenere variabili per 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 i valori delle variabili 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 variabili per 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 in base all'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 che questo cmdlet esclude dall'operazione. I caratteri jolly sono consentiti.

Tipo:String[]
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:True

-Include

Specifica una matrice di elementi su cui il cmdlet agisce, escludendo tutti gli altri. I caratteri jolly sono consentiti.

Tipo:String[]
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:True

-Name

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

Tipo:String[]
Posizione:0
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:True
Accettare caratteri jolly:True

-Scope

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

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

Local è l'impostazione predefinita. Per altre informazioni, vedere about_Scopes.

Tipo:String
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-ValueOnly

Indica che questo cmdlet ottiene solo il valore della variabile.

Tipo:SwitchParameter
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

Input

String

È possibile inviare tramite pipe 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 oggetto [System.Object[]]. Questo comportamento impedisce al normale funzionamento della pipeline di elaborare i valori della variabile uno alla volta. Una soluzione alternativa per forzare l'enumerazione della raccolta consiste nell'racchiudere il Get-Variable comando tra parentesi.

Note

Windows PowerShell include gli alias seguenti per Get-Variable:

  • gv

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