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 Windows PowerShell. La risposta all'avviso dipende dal valore della variabile $WarningPreference dell'utente e dall'uso del parametro comune WarningAction .

Esempio

Esempio 1: Scrivere un messaggio di avviso

PS C:\> Write-Warning "This is only a test warning."

Questo comando visualizza il messaggio "WARNING: si tratta solo di un avviso di test".

Esempio 2: Passare una stringa a Write-Warning

PS C:\> $w = "This is only a test warning."
PS C:\> $w | Write-Warning

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

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

PS C:\> $warningpreference
Continue PS C:\> Write-Warning "This is only a test warning."
This is only a test warning. PS C:\> $warningpreference = "SilentlyContinue"
PS C:\> Write-Warning "This is only a test warning."
PS C:\>
PS C:\> $warningpreference = "Stop"
PS C:\> Write-Warning "This is only a test warning."
WARNING: This is only a test message.
Write-Warning : Command execution stopped because the shell variable "WarningPreference" is set to Stop.
At line:1 char:14
     + Write-Warning <<<<  "This is only a test message."

Questo esempio mostra l'effetto del valore della variabile $WarningPreference in un comando Write-Warning .

Il primo comando visualizza il valore predefinito della variabile $WarningPreference, ovvero Continua. 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. Un valore di 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

PS C:\> 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 esempio mostra l'effetto del parametro comune WarningAction in un comando Write-Warning . È possibile usare il parametro comune WarningAction con qualsiasi cmdlet per determinare il modo in cui Windows PowerShell risponde agli avvisi risultanti da tale comando. Il parametro comune WarningAction esegue l'override del valore del $WarningPreference solo per tale comando specifico.

Questo comando usa il cmdlet Write-Warning per visualizzare un avviso. Il parametro comune WarningAction con un valore di Inquire indirizza il sistema per 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.

Type:String
Aliases:Msg
Position:0
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

Input

String

È possibile inviare una pipe a una stringa contenente l'avviso per l'avviso di scrittura.

Output

None

Write-Warning scrive solo nel flusso di avviso. Non genera altro output.

Note

  • Il valore predefinito per la variabile $WarningPreference è Continua, che visualizza l'avviso e quindi continua a eseguire il comando. Per determinare i 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.