Condividi tramite

Write-Warning

  • Riferimento
Modulo:
Microsoft.PowerShell.Utility

Scrive un messaggio di avviso.

Sintassi

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

Descrizione

Il Write-Warning cmdlet scrive un messaggio di avviso nell'host di PowerShell. La risposta all'avviso dipende dal valore della variabile dell'utente $WarningPreference 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 $WarningPreference variabile in un Write-Warning comando.

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 $WarningPreference variabile, ovvero Continue. Di conseguenza, quando si scrive un avviso, viene visualizzato il messaggio di avviso e l'esecuzione continua.

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

Per altre informazioni sulla $WarningPreference variabile, vedere about_Preference_Variables.

Esempio 4: Impostare il parametro WarningAction e scrivere un avviso

In questo esempio viene illustrato l'effetto del parametro comune WarningAction in un Write-Warning comando. È possibile usare il parametro comune WarningAction con qualsiasi cmdlet per determinare in che modo PowerShell risponde agli avvisi risultanti da tale comando. Il parametro comune WarningAction esegue l'override del valore dell'unico $WarningPreference 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 Write-Warning cmdlet per visualizzare un avviso. Il parametro comune WarningAction con un valore di Inquire 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 output. Scrive solo nel flusso di avviso.

Note

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