Write-Warning
Scrive un messaggio di avviso.
Sintassi
Default (Impostazione predefinita)
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 .
Esempio
Esempio 1: Scrivere un messaggio di avviso
PS C:\> Write-Warning "This is only a test warning."
Questo comando visualizza il messaggio "ATTENZIONE: Questo è solo 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 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: 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."
In questo esempio viene illustrato l'effetto del valore della variabile $WarningPreference su 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. Il valore SilentlyContinue elimina l'avviso. Il valore Stop visualizza l'avviso e quindi interrompe l'esecuzione del comando.
Per ulteriori 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"):
In questo esempio viene illustrato l'effetto del parametro comune WarningAction su un comando Write-Warning . È possibile utilizzare 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 sostituisce il valore del $WarningPreference solo per quel particolare comando.
Questo comando utilizza il cmdlet Write-Warning per visualizzare un avviso. Il WarningAction parametro comune con un valore di Inquire indica al sistema di chiedere conferma all'utente quando il comando visualizza un avviso.
Per ulteriori informazioni sul parametro comune WarningAction , vedere about_CommonParameters.
Parametri
-Message
Specifica il messaggio di avviso.
Proprietà dei parametri
| Tipo: | String |
| Valore predefinito: | None |
| Supporta i caratteri jolly: | False |
| DontShow: | False |
| Alias: | Msg |
Set di parametri
(All)
| Posizione: | 0 |
| Obbligatorio: | True |
| Valore dalla pipeline: | True |
| Valore dalla pipeline in base al nome della proprietà: | False |
| Valore dagli argomenti rimanenti: | False |
CommonParameters
Questo cmdlet supporta i parametri comuni: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction e -WarningVariable. Per altre informazioni, vedi about_CommonParameters.
Input
String
È possibile reindirizzare una stringa che contiene l'avviso a Write-Warning.
Output
None
Write-Warning scrive solo nel flusso di avviso. Non genera alcun altro output.
Note
Il valore predefinito per la variabile $WarningPreference è Continue, che visualizza l'avviso e quindi continua l'esecuzione del comando. Per determinare 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 elencherà i valori validi.