ARGOMENTO

about_CommonParameters

DESCRIZIONE BREVE
Descrive i parametri che possono essere utilizzati con qualsiasi
cmdlet.

DESCRIZIONE DETTAGLIATA
I parametri comuni sono un set di parametri dei cmdlet che è possibile
utilizzare con qualsiasi cmdlet. Vengono implementati da Windows
PowerShell, non dallo sviluppatore di cmdlet, e sono automaticamente
disponibili per qualsiasi cmdlet.

È possibile utilizzare i parametri comuni con qualsiasi cmdlet, ma

potrebbero non avere effetti su tutti i cmdlet. Se ad esempio un
cmdlet non genera alcun output dettagliato, l'utilizzo del parametro
comune Verbose non ha alcun effetto.

Diversi parametri comuni eseguono l'override delle impostazioni

predefinite del sistema o delle preferenze impostate tramite le
variabili di preferenza di Windows PowerShell. A differenza delle
variabili di preferenza, i parametri comuni hanno effetto solo
sui comandi in cui vengono utilizzati.

Oltre ai parametri comuni, molti cmdlet offrono i parametri di

attenuazione dei rischi WhatIf e Confirm. Solitamente i cmdlet che
comportano rischi per il sistema o per i dati dell'utente offrono questi
parametri.

I parametri comuni sono i seguenti:

-Verbose
-Debug
-WarningAction
-WarningVariable
-ErrorAction
-ErrorVariable
-OutVariable
-OutBuffer

I parametri di attenuazione dei rischi sono:

-WhatIf
-Confirm

Per ulteriori informazioni sulle variabili di preferenza, digitare:

help about_preference_variables
Descrizioni dei parametri comuni

-Verbose[:{$true | $false}]

Vengono visualizzate le informazioni dettagliate sull'operazione

eseguita dal comando. Queste informazioni sono analoghe alle
informazioni in un'analisi o in un registro delle transazioni. Questo
parametro funziona solo quando il comando genera un messaggio
dettagliato, ad esempio quando un comando contiene il cmdlet
Write-Verbose.

Il parametro Verbose esegue l'override del valore della variabile

$VerbosePreference per il comando corrente. Poiché il valore
predefinito della variabile $VerbosePreference è SilentlyContinue, i
messaggi dettagliati non vengono visualizzati per impostazione
predefinita.

Valori validi:

$true (-Verbose:$true) esercita lo stesso effetto di -Verbose.

$false (-Verbose:$false) elimina la visualizzazione di

messaggi dettagliati. Utilizzare questo parametro quando
il valore di $VerbosePreference non è SilentlyContinue
(impostazione predefinita).

-Debug[:{$true | $false}]

Vengono visualizzate informazioni a livello di programmazione

sull'operazione eseguita dal comando. Questo parametro funziona solo
quando il comando genera un messaggio di debug, ad esempio quando un
comando contiene il cmdlet Write-Debug.

Il parametro Debug esegue l'override del valore della variabile

$DebugPreference per il comando corrente. Poiché il valore
predefinito della variabile $DebugPreference è SilentlyContinue, i
messaggi di debug non vengono visualizzati per impostazione predefinita.

Valori validi:

$true (-Debug:$true). Esercita lo stesso effetto di -Debug.

$false (-Debug:$false). Elimina la visualizzazione di

messaggi di debug quando il valore di $DebugPreference non è
SilentlyContinue (impostazione predefinita).

-WarningAction[:{SilentlyContinue | Continue | Inquire | Stop}]

Determina la risposta del cmdlet a un avviso del comando.

"Continue" è il valore predefinito. Questo parametro funziona solo
quando il comando genera un messaggio di avviso, ad esempio quando un
comando contiene il cmdlet Write-Warning.

Il parametro WarningAction esegue l'override del valore della

 variabile $WarningPreference per il comando corrente. Poiché
il valore predefinito della variabile $WarningPreference è
Continue, vengono visualizzati gli avvisi e l'esecuzione
continua a meno che non si utilizzi il parametro WarningAction.

Valori validi:

SilentlyContinue. Elimina il messaggio di avviso e

l'esecuzione del comando continua.

Continue. Visualizza il messaggio di avviso e l'esecuzione del

comando continua. "Continue" è il valore predefinito.

Inquire. Visualizza il messaggio di avviso e richiede

all'utente la conferma prima di continuare l'esecuzione.
Questo valore viene utilizzato di rado.

Stop. Visualizza il messaggio di avviso e interrompe

l'esecuzione del comando.

-WarningVariable [+]<variable-name>

Archivia gli avvisi relativi al comando nella variabile

specificata.

Per aggiungere gli avvisi al contenuto della variabile, anziché

sostituire qualsiasi avviso che potrebbe essere già presente,
digitare un segno più (+) prima del nome della variabile.

Ad esempio, il comando seguente crea la variabile $a e

archivia in essa gli avvisi:

get-process -id 6 -WarningVariable a

Con il comando seguente vengono aggiunti avvisi alla variabile $a:

get-process -id 2 -WarningVariable +a

Con il comando seguente viene visualizzato il contenuto di $a:

$a

È possibile utilizzare questo parametro per creare una

variabile che contiene solo gli avvisi di comandi specifici.
È possibile utilizzare una notazione di matrice, ad esempio
$a[0] o $warning[1,2], per fare riferimento ad avvisi specifici
archiviati nella variabile.

-ErrorAction[:{SilentlyContinue | Continue | Inquire | Stop)]

Determina la risposta del cmdlet a un errore non fatale del

comando. Questo parametro funziona solo quando il comando
genera un messaggio di debug, ad esempio quando un comando
contiene il cmdlet Write-Error.

Il parametro ErrorAction esegue l'override del valore della

 variabile $ErrorActionPreference per il comando corrente.
Poiché il valore predefinito della variabile $ErrorActionPrefe
rence è Continue, vengono visualizzati i messaggi di errore e
l'esecuzione continua a meno che non si utilizzi il parametro
ErrorAction.

Il parametro ErrorAction non ha effetto sugli errori fatali,

ad esempio dati mancanti, parametri non validi o autorizzazioni
insufficienti, che impediscono il completamento corretto di un comando.

Valori validi:

SilentlyContinue. Elimina il messaggio di errore e

l'esecuzione del comando continua.

Continue. Visualizza il messaggio di errore e l'esecuzione del

comando continua. "Continue" è il valore predefinito.

Inquire. Visualizza il messaggio di errore e richiede

all'utente la conferma prima di continuare l'esecuzione.
Questo valore viene utilizzato di rado.

Stop. Viene visualizzato il messaggio di errore e

l'esecuzione del comando viene arrestata.

-ErrorVariable [+]<nome-variabile>

Archivia i messaggi di errore relativi al comando nella variabile

specificata e nella variabile automatica $Error. Per ulteriori
informazioni, digitare il comando seguente:

get-help about_automatic_variables

Per impostazione predefinita, i nuovi messaggi di errore

sovrascrivono i messaggi di errore già archiviati nella
variabile. Per aggiungere il messaggio di errore al contenuto
della variabile, digitare un segno più (+) prima del nome della
variabile.

Ad esempio, il comando seguente crea la variabile $a e

archivia in essa gli errori:

get-process -id 6 -ErrorVariable a

Con il comando seguente vengono aggiunti messaggi di errore alla

variabile $a:

get-process -id 2 -ErrorVariable +a

Con il comando seguente viene visualizzato il contenuto di $a:

$a

È possibile utilizzare questo parametro per creare una

variabile che contiene solo i messaggi di errore di comandi
specifici. La variabile automatica $Error contiene messaggi
di errore di tutti i comandi della sessione.
 È possibile utilizzare una notazione di matrice, ad esempio
$a[0] o $error[1,2], per fare riferimento a errori specifici
archiviati nelle variabili.

-OutVariable [+]<nome-variabile>

Archivia oggetti di output dal comando nella variabile

specificata e vengono visualizzati sulla riga di comando.

Per aggiungere l'output alla variabile, anziché sostituire

l'output che potrebbe essere già presente, digitare un segno
più (+) prima del nome della variabile.

Ad esempio, il comando seguente crea la variabile $out e

archivia in essa l'oggetto processo:

get-process powershell -OutVariable out

Con il comando seguente viene aggiunto l'oggetto processo

alla variabile $out:

get-process iexplore -OutVariable +out

Nel comando seguente viene visualizzato il contenuto della

variabile $out:

$out

-OutBuffer <Int32>

Determina il numero di oggetti da accumulare in un buffer

prima che venga inviato qualsiasi oggetto attraverso la
pipeline. Se si omette questo parametro, gli oggetti vengono
inviati al momento della generazione.

Questo parametro di gestione delle risorse è progettato per

gli utenti avanzati. Quando si utilizza questo parametro,
Windows PowerShell non chiama il cmdlet successivo nella
pipeline finché il numero di oggetti generati non è uguale
a OutBuffer + 1. Successivamente, invia tutti gli oggetti
al momento della generazione.

Descrizioni del parametro di gestione dei rischi

-WhatIf[:{$true | $false}]
Visualizza un messaggio che descrive l'effetto del comando anziché
eseguirlo.

Il parametro WhatIf esegue l'override del valore della variabile

$WhatIfPreference per il comando corrente. Poiché il valore
predefinito della variabile $WhatIfPreference è 0 (disabilitata), il
comportamento WhatIf non viene eseguito senza il parametro WhatIf.
Per ulteriori informazioni, digitare il comando seguente:

get-help about_preference_variables
 Valori validi:

$true (-WhatIf:$true). Esercita lo stesso effetto di -

WhatIf.
$false (-WhatIf:$false). Elimina il comportamento
automatico WhatIf che si verifica quando il valore della
variabile $WhatIfPreference è 1.

Ad esempio, il comando seguente utilizza il parametro WhatIf in un

comando Remove-Item:

PS> remove-item date.csv -whatif

Anziché rimuovere l'elemento, Windows PowerShell elenca le

operazioni che verrebbero eseguite e gli elementi su cui avrebbero
effetto. Questo comando produce l'output seguente:

What if: Esecuzione dell'operazione "Remove File" sulla

destinazione "C:\ps-test\date.csv".

-Confirm[:{$true | $false}]
Chiede una conferma prima di eseguire il comando.

Il parametro Confirm esegue l'override del valore della variabile

$ConfirmPreference per il comando corrente. Il valore predefinito è
High. Per ulteriori informazioni, digitare il comando seguente:

get-help about_preference_variables
Valori validi:

$true (-WhatIf:$true). Esercita lo stesso effetto di

-Confirm.

$false(-Confirm:$false). Elimina la conferma automatica che si

verifica quando il valore di $ConfirmPreference è minore o uguale al
rischio previsto del cmdlet.

Ad esempio, il comando seguente utilizza il parametro Confirm

con un comando Remove-Item. Prima di rimuovere l'elemento, Windows
PowerShell elenca le operazioni che verrebbero eseguite e gli
elementi su cui avrebbero effetto.

PS C:\ps-test> remove-item tmp*.txt -confirm

Questo comando produce l'output seguente:

Confirm
Eseguire l'operazione?
Esecuzione dell'operazione "Remove File" sulla
destinazione " C:\ps-test\tmp1.txt [Y] Sì [A] Sì a tutti
[N] No [L] No a tutti [S] Sospendi [?] Guida (il valore
predefinito è "S"):

VEDERE ANCHE
about_Preference_Variables
Write-Debug
Write-Warning
Write-Error
Write-Verbose