Ottiene le variabili disponibili nella console corrente.
Sintassi
Get-Variable [[-Name] <string[]>] [-Exclude <string[]>] [-Include <string[]>] [-Scope <string>] [-ValueOnly] [<CommonParameters>]
Descrizione
Il cmdlet Get-Variable ottiene le variabili di Windows PowerShell disponibili nella console corrente. È possibile recuperare solo i valori delle variabili specificando il parametro ValueOnly e filtrare le variabili restituite in base al nome.
Parametri
-Exclude <string[]>
Omette gli elementi specificati. È consentito l'utilizzo di caratteri jolly.
|
Obbligatorio? |
false |
|
Posizione? |
named |
|
Valore predefinito |
|
|
Accettare input da pipeline? |
false |
|
Accettare caratteri jolly? |
false |
-Include <string[]>
Specifica solo gli elementi sui quali il cmdlet può eseguire operazioni, escludendo tutti gli altri. È consentito l'utilizzo di caratteri jolly.
|
Obbligatorio? |
false |
|
Posizione? |
named |
|
Valore predefinito |
|
|
Accettare input da pipeline? |
false |
|
Accettare caratteri jolly? |
false |
-Name <string[]>
Specifica il nome della variabile.
|
Obbligatorio? |
false |
|
Posizione? |
1 |
|
Valore predefinito |
|
|
Accettare input da pipeline? |
true (ByValue, ByPropertyName) |
|
Accettare caratteri jolly? |
false |
-Scope <string>
Ottiene solo le variabili nell'ambito specificato. I valori validi sono "Global", "Local", "Script" oppure un numero relativo all'ambito corrente, ovvero da 0 al numero di ambiti, dove 0 corrisponde all'ambito corrente e 1 al relativo padre. Il valore predefinito è "Local". Per ulteriori informazioni, vedere about_Scopes.
|
Obbligatorio? |
false |
|
Posizione? |
named |
|
Valore predefinito |
|
|
Accettare input da pipeline? |
false |
|
Accettare caratteri jolly? |
false |
-ValueOnly
Ottiene solo il valore della variabile.
|
Obbligatorio? |
false |
|
Posizione? |
named |
|
Valore predefinito |
|
|
Accettare input da pipeline? |
false |
|
Accettare caratteri jolly? |
false |
<CommonParameters>
Questo cmdlet supporta i parametri comuni -Verbose, -Debug, -ErrorAction, -ErrorVariable, -OutBuffer e -OutVariable. Per ulteriori informazioni, vedere about_Commonparameters.
Input e output
Il tipo di input è il tipo degli oggetti che è possibile reindirizzare al cmdlet. Il tipo restituito è il tipo degli oggetti restituiti dal cmdlet.
|
Input |
System.String È possibile reindirizzare una stringa che contiene il nome della variabile a Get-Variable. |
|
Output |
Oggetto variabile Get-Variable restituisce un oggetto variabile System.Management.Automation per ogni variabile ottenuta. Il tipo di oggetto dipende dalla variabile. |
Note
Questo cmdlet non consente di gestire le variabili di ambiente. Per gestire le variabili di ambiente, è possibile utilizzare il provider delle variabili di ambiente.
Esempio 1
C:\PS>get-variable m* Descrizione ----------- Tramite questo comando verranno visualizzate le variabili il cui nome inizia con la lettera "m". Verrà inoltre visualizzato il valore delle variabili.
Esempio 2
C:\PS>get-variable m* -valueonly Descrizione ----------- Tramite questo comando verranno visualizzati soli i valori delle variabili il cui nome inizia con la lettera "m".
Esempio 3
C:\PS>get-variable -include M*,P* | sort-object name Descrizione ----------- Tramite questo comando vengono ottenute informazioni sulle variabili il cui nome inizia con la lettera "M" o "P". I risultati verranno reindirizzati al cmdlet Sort-Object, ordinati in base al nome e visualizzati.
Esempio 4
C:\PS>get-variable -scope 0 C:\PS> compare-object (get-variable -scope 0) (get-variable -scope 1) Descrizione ----------- Il primo comando consente di ottenere solo le variabili definite nell'ambito locale. Equivale a "get-variable -scope local" e può essere abbreviato in "gv -s 0". Nel secondo comando viene utilizzato il cmdlet Compare-Object per trovare le variabili definite nell'ambito padre (Ambito 1), ma visibili solo nell'ambito locale (Ambito 0).
Vedere anche