Condividi tramite

Get-Variable

Modulo:
Microsoft.PowerShell.Utility Module

Ottiene le variabili nella console corrente.

Sintassi

Default (impostazione predefinita). 

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

Descrizione

Il cmdlet Get-Variable 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 cmdlet Compare-Object 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. Sono consentiti i metacaratteri.

Proprietà dei parametri

Tipo:

String[]

Valore predefinito:None
Supporta i caratteri jolly:True
DontShow:False

Set di parametri

(All)
Posizione:Named
Obbligatorio:False
Valore dalla pipeline:False
Valore dalla pipeline in base al nome della proprietà:False
Valore dagli argomenti rimanenti:False

-Include

Specifica una matrice di elementi su cui il cmdlet agisce, escludendo tutti gli altri. Sono consentiti i metacaratteri.

Proprietà dei parametri

Tipo:

String[]

Valore predefinito:None
Supporta i caratteri jolly:True
DontShow:False

Set di parametri

(All)
Posizione:Named
Obbligatorio:False
Valore dalla pipeline:False
Valore dalla pipeline in base al nome della proprietà:False
Valore dagli argomenti rimanenti:False

-Name

Specifica il nome della variabile. Sono consentiti i metacaratteri. È anche possibile inviare tramite pipe un nome di variabile a Get-Variable.

Proprietà dei parametri

Tipo:

String[]

Valore predefinito:None
Supporta i caratteri jolly:True
DontShow:False

Set di parametri

(All)
Posizione:0
Obbligatorio:False
Valore dalla pipeline:True
Valore dalla pipeline in base al nome della proprietà:True
Valore dagli argomenti rimanenti:False

-Scope

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

  • Global
  • Locale
  • Script
  • Numero riferito all'ambito attuale (da 0 al numero di ambiti, dove 0 è l'ambito attuale e 1 è l'ambito padre)

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

Proprietà dei parametri

Tipo:String
Valore predefinito:None
Supporta i caratteri jolly:False
DontShow:False

Set di parametri

(All)
Posizione:Named
Obbligatorio:False
Valore dalla pipeline:False
Valore dalla pipeline in base al nome della proprietà:False
Valore dagli argomenti rimanenti:False

-ValueOnly

Indica che questo cmdlet ottiene solo il valore della variabile.

Proprietà dei parametri

Tipo:SwitchParameter
Valore predefinito:None
Supporta i caratteri jolly:False
DontShow:False

Set di parametri

(All)
Posizione:Named
Obbligatorio:False
Valore dalla pipeline:False
Valore dalla pipeline in base al nome della proprietà:False
Valore dagli argomenti rimanenti:False

CommonParameters

Questo cmdlet supporta i parametri comuni: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction e -WarningVariable. Per altre informazioni, vedi about_CommonParameters.

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 [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 comando Get-Variable 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 ambiente.