Nomi dei parametri comuni

Articolo
09/27/2021

I parametri descritti in questo argomento sono definiti parametri comuni. Vengono aggiunti ai cmdlet dal runtime Windows PowerShell e non possono essere dichiarati dal cmdlet .

Nota

Questi parametri vengono aggiunti anche ai cmdlet del provider e alle funzioni decorati con CmdletBinding l'attributo .

Parametri comuni generali

I parametri seguenti vengono aggiunti a tutti i cmdlet ed è possibile accedervi ogni volta che viene eseguito il cmdlet. Questi parametri sono definiti dalla classe System.Management.Automation.Internal.Commonparameters.

Confirm (alias: cf)

Tipo di dati: SwitchParameter

Questo parametro specifica se il cmdlet visualizza un prompt che chiede se l'utente è sicuro di voler continuare.

Debug (alias: db)

Tipo di dati: SwitchParameter

Questo parametro specifica se i messaggi di debug a livello di programmatore possono essere visualizzati nella riga di comando. Questi messaggi sono destinati alla risoluzione dei problemi relativi al funzionamento del cmdlet e vengono generati da chiamate al metodo System.Management.Automation.Cmdlet.WriteDebug. Non è necessario localizzare i messaggi di debug.

ErrorAction (alias: ea)

Tipo di dati: enumerazione

Questo parametro specifica quale azione deve essere eseguita quando si verifica un errore. I valori possibili per questo parametro sono definiti dall'enumerazione System.Management.Automation.Actionpreference.

ErrorVariable (alias: ev)

Tipo di dati: stringa

Questo parametro specifica la variabile in cui inserire gli oggetti quando si verifica un errore. Per aggiungere a questa variabile, usare +varname invece di cancellare e impostare la variabile.

OutBuffer (alias: ob)

Tipo di dati: Int32

Questo parametro definisce il numero di oggetti da archiviare nel buffer di output prima che qualsiasi oggetto venga passato alla pipeline. Per impostazione predefinita, gli oggetti vengono passati immediatamente nella pipeline.

OutVariable (alias: ov)

Tipo di dati: stringa

Questo parametro specifica la variabile in cui inserire tutti gli oggetti di output generati dal cmdlet . Per aggiungere a questa variabile, usare +varname invece di cancellare e impostare la variabile.

PipelineVariable (alias: pv)

Tipo di dati: stringa

Questo parametro archivia il valore dell'elemento della pipeline corrente come variabile per qualsiasi comando denominato durante il flusso attraverso la pipeline.

Verbose (alias: vb)

Tipo di dati: SwitchParameter

Questo parametro specifica se il cmdlet scrive messaggi esplicativi che possono essere visualizzati nella riga di comando. Questi messaggi sono destinati a fornire ulteriore assistenza all'utente e vengono generati da chiamate al metodo System.Management.Automation.Cmdlet.WriteVerbose.

WarningAction (alias: wa)

Tipo di dati: enumerazione

Questo parametro specifica l'azione da eseguire quando il cmdlet scrive un messaggio di avviso. I valori possibili per questo parametro sono definiti dall'enumerazione System.Management.Automation.Actionpreference.

WarningVariable (alias: wv)

Tipo di dati: stringa

Questo parametro specifica la variabile in cui è possibile salvare i messaggi di avviso. Per aggiungere a questa variabile, usare +varname invece di cancellare e impostare la variabile.

Risk-Mitigation parametri

I parametri seguenti vengono aggiunti ai cmdlet che richiede la conferma prima di eseguire l'azione. Per altre informazioni sulle richieste di conferma, vedere Richiesta di conferma. Questi parametri sono definiti dalla classe System.Management.Automation.Internal.Shouldprocessparameters.

WhatIf (alias: wi)

Tipo di dati: SwitchParameter

Questo parametro specifica se il cmdlet scrive un messaggio che descrive gli effetti dell'esecuzione del cmdlet senza eseguire effettivamente alcuna azione.

Parametri della transazione

Il parametro seguente viene aggiunto ai cmdlet che supportano le transazioni. Questi parametri sono definiti dalla classe System.Management.Automation.Internal.Transactionparameters. Il supporto delle transazioni è stato introdotto in PowerShell 3.0 ed è stato sospeso in PowerShell 6.0.