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