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