Condividi tramite

Write-Warning

  • Riferimento
Modulo:
Microsoft.PowerShell.Utility

Scrive un messaggio di avviso.

Sintassi

Write-Warning
     [-Message] <String>
     [<CommonParameters>]

Descrizione

Il cmdlet Write-Warning scrive un messaggio di avviso nell'host di PowerShell. La risposta all'avviso dipende dal valore della variabile dell'utente e dall'uso del parametro comune WarningAction.

Esempio

Esempio 1: Scrivere un messaggio di avviso

Questo comando visualizza il messaggio "WARNING: This is only a test warning".

Write-Warning "This is only a test warning."

Esempio 2: Passare una stringa a Write-Warning

Questo comando mostra che è possibile usare un operatore pipeline (|) per inviare una stringa a Write-Warning. È possibile salvare la stringa in una variabile, come illustrato in questo comando o inviare tramite pipe la stringa direttamente a Write-Warning.

$w = "This is only a test warning."
$w | Write-Warning

Esempio 3: Impostare la variabile $WarningPreference e scrivere un avviso

In questo esempio viene illustrato l'effetto del valore della variabile $WarningPreference in un comando Write-Warning.

PS> $WarningPreference
Continue
PS> Write-Warning "This is only a test warning."
This is only a test warning.
PS> $WarningPreference = "SilentlyContinue"
PS> Write-Warning "This is only a test warning."
PS> $WarningPreference = "Stop"
PS> Write-Warning "This is only a test warning."
WARNING: This is only a test warning.
Write-Warning: The running command stopped because the preference variable "WarningPreference" or common parameter is set to Stop: This is only a test warning.

Il primo comando visualizza il valore predefinito della variabile $WarningPreference, che è Continue. Di conseguenza, quando si scrive un avviso, viene visualizzato il messaggio di avviso e l'esecuzione continua.

Quando si modifica il valore della variabile $WarningPreference, l'effetto del comando Write-Warning cambia di nuovo. Un valore di SilentlyContinue elimina l'avviso. Il valore Stop visualizza l'avviso e quindi arresta l'esecuzione del comando.

Per altre informazioni sulla variabile $WarningPreference, vedere about_Preference_Variables.

Esempio 4: Impostare il parametro WarningAction e scrivere un avviso

In questo esempio viene illustrato l'effetto dell'WarningAction parametro comune in un comando Write-Warning. È possibile usare WarningAction parametro comune con qualsiasi cmdlet per determinare in che modo PowerShell risponde agli avvisi risultanti da tale comando. Il WarningAction parametro comune esegue l'override del valore del $WarningPreference solo per quel particolare comando.

PS> Write-Warning "This is only a test warning." -WarningAction Inquire
WARNING: This is only a test warning.
Confirm
Continue with this operation?
 [Y] Yes  [A] Yes to All  [H] Halt Command  [S] Suspend  [?] Help (default is "Y"):

Questo comando usa il cmdlet Write-Warning per visualizzare un avviso. Il WarningAction parametro comune con un valore Di richiesta indica al sistema di richiedere all'utente quando il comando visualizza un avviso.

Per altre informazioni sul parametro comune WarningAction, vedere about_CommonParameters.

Parametri

-Message

Specifica il messaggio di avviso.

Tipo:String
Alias:Msg
Posizione:0
Valore predefinito:None
Necessario:True
Accettare l'input della pipeline:True
Accettare caratteri jolly:False

Input

String

È possibile inviare tramite pipe una stringa contenente l'avviso a questo cmdlet.

Output

None

Questo cmdlet non restituisce alcun output. Scrive solo nel flusso di avviso.

Note

Il valore predefinito per la variabile $WarningPreference è Continue, che visualizza l'avviso e quindi continua a eseguire il comando. Per determinare valori validi per una variabile di preferenza, ad esempio $WarningPreference, impostarla su una stringa di caratteri casuali, ad esempio "abc". Il messaggio di errore risultante elenca i valori validi.