Write-Warning
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-WarningEsempio 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. Il valore 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 su 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 $WarningPreference del valore di 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 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.
| Type: | String |
| Aliases: | Msg |
| Position: | 0 |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
Input
È possibile inviare tramite pipe una stringa contenente l'avviso a Write-Warning.
Output
None
Write-Warning scrive solo nel flusso di avviso. Non genera altro output.
Note
Il valore predefinito per la $WarningPreference variabile è Continue, che visualizza l'avviso e quindi continua a eseguire il comando. Per determinare i 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.