Write-Warning

Sintaxe

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

Description

O Write-Warning cmdlet grava uma mensagem de aviso no host do PowerShell. A resposta ao aviso depende do valor da variável do $WarningPreference usuário e do uso do parâmetro comum WarningAction .

Exemplos

Exemplo 1: Escrever uma mensagem de aviso

Este comando exibe a mensagem "AVISO: Este é apenas um aviso de teste".

Write-Warning "This is only a test warning."

Exemplo 2: Passar uma cadeia de caracteres para Write-Warning

Esse comando mostra que você pode usar um operador de pipeline (|) para enviar uma cadeia de caracteres para Write-Warning. Você pode salvar a string em uma variável, como mostrado neste comando, ou canalizar a string diretamente para Write-Warning.

$w = "This is only a test warning."
$w | Write-Warning

Exemplo 3: Definir a variável $WarningPreference e escrever um aviso

Este exemplo mostra o efeito do valor da $WarningPreference variável em um 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.

O primeiro comando exibe o valor padrão da $WarningPreference variável, que é Continue. Como resultado, quando você escreve um aviso, a mensagem de aviso será exibida e a execução continuará.

Quando você altera o $WarningPreference valor da variável, o efeito do Write-Warning comando muda novamente. Um valor de SilentlyContinue suprime o aviso. Um valor de Stop exibe o aviso e, em seguida, interrompe a execução do comando.

Para obter mais informações sobre a variável $WarningPreference, consulte about_Preference_Variables.

Exemplo 4: Definir o parâmetro WarningAction e escrever um aviso

Este exemplo mostra o efeito do parâmetro comum WarningAction em um Write-Warning comando. Você pode usar o parâmetro comum WarningAction com qualquer cmdlet para determinar como o PowerShell responde aos avisos resultantes desse comando. O parâmetro comum WarningAction substitui o valor do $WarningPreference only para esse comando específico.

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

Esse comando usa o Write-Warning cmdlet para exibir um aviso. O parâmetro comum WarningAction com um valor de Inquire direciona o sistema para avisar o usuário quando o comando exibe um aviso.

Para obter mais informações sobre o parâmetro comum WarningAction , consulte about_CommonParameters.

Parâmetros

-Message

Entradas

String

Você pode canalizar uma cadeia de caracteres que contém o aviso para esse cmdlet.

Saídas

None

Esse cmdlet não retorna nenhuma saída. Ele grava apenas no fluxo de aviso.

Observações

O valor padrão para a $WarningPreference variável é Continue, que exibe o aviso e continua executando o comando. Para determinar valores válidos para uma variável de preferência, como $WarningPreference, defina-a como uma sequência de caracteres aleatórios, como "abc". A mensagem de erro resultante lista os valores válidos.

Links Relacionados

• about_Output_Streams
• about_Redirection
• Write-Debug
• Write-Error
• Write-Host
• Write-Information
• Write-Output
• Write-Progress
• Write-Verbose