Condividi tramite


Write-Warning

Scrive un messaggio di avviso.

Sintassi

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

Descrizione

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

Parametri

-Message <string>

Specifica il messaggio di avviso.

Obbligatorio?

true

Posizione?

1

Valore predefinito

Accettare input da pipeline?

true (ByValue)

Accettare caratteri jolly?

false

<CommonParameters>

Questo cmdlet supporta i parametri comuni -Verbose, -Debug, -ErrorAction, -ErrorVariable, -OutBuffer e -OutVariable. Per ulteriori informazioni, vedere about_Commonparameters.

Input e output

Il tipo di input è il tipo degli oggetti che è possibile reindirizzare al cmdlet. Il tipo restituito è il tipo degli oggetti restituiti dal cmdlet.

Input

System.String

È possibile reindirizzare una stringa che contiene l'avviso a Write-Warning.

Output

Nessuno

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

Note

Il valore predefinito per la variabile $WarningPreference è "Continue" che consente di visualizzare l'avviso e continuare l'esecuzione del comando. Per determinare i valori validi per una variabile di preferenza come $WarningPreference, impostarla su una stringa di caratteri casuali, ad esempio "abc". Nel messaggio di errore risultante verranno elencati i valori validi.

Esempio 1

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

Descrizione
-----------
In questo comando viene visualizzato il messaggio "WARNING: si tratta solo di un messaggio di verifica".





Esempio 2

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

C:\PS> $w | write-warning

Descrizione
-----------
In questo esempio viene illustrato che è possibile utilizzare un operatore pipeline (|) per inviare una stringa a Write-Warning. È possibile salvare la stringa in una variabile, come illustrato in questo comando, oppure reindirizzare la stringa direttamente a Write-Warning.





Esempio 3

C:\PS>$warningpreference

Continue

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

C:\PS> $warningpreference = "SilentlyContinue"

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

C:\PS> $warningpreference = "Stop"

C:\PS> 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."

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

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

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

Per ulteriori informazioni sulla variabile $WarningPreference, vedere about_Preference_Variables.





Esempio 4

C:\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"):

Descrizione
-----------
In questo esempio viene illustrato l'effetto del parametro comune WarningAction in un comando Write-Warning. È possibile utilizzare il parametro comune WarningAction con qualsiasi cmdlet per determinare la risposta di Windows PowerShell agli avvisi risultanti da tale comando. Il parametro comune WarningAction esegue l'override del valore di $WarningPreference solo per quel determinato comando.

Questo comando utilizza il cmdlet Write-Warning per visualizzare un avviso. Il parametro comune WarningAction con un valore di "Inquire" indica al sistema di richiedere la conferma dell'utente quando il comando visualizza un avviso.

Per ulteriori informazioni sul parametro comune WarningAction, vedere about_CommonParameters.





Vedere anche

Concetti

about_Preference_Variables
about_Commonparameters
Write-Debug
Write-Error
Write-Host
Write-Output
Write-Progress
Write-Verbose