Write-Warning
Grava uma mensagem de aviso.
Syntax
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
Este comando mostra que você pode usar um operador de pipeline (|
) para enviar uma cadeia de caracteres para Write-Warning
.
Você pode salvar a cadeia de caracteres em uma variável, conforme mostrado neste comando, ou canalizá-la 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 : Command execution stopped because the shell variable "WarningPreference" is set to Stop.
At line:1 char:14
+ Write-Warning <<<< "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 Write-Warning
efeito do comando é alterado 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 de only $WarningPreference
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 exibir um aviso.
Para obter mais informações sobre o parâmetro comum WarningAction , consulte about_CommonParameters.
Parâmetros
-Message
Especifica a mensagem de aviso.
Type: | String |
Aliases: | Msg |
Position: | 0 |
Default value: | None |
Required: | True |
Accept pipeline input: | True |
Accept wildcard characters: | False |
Entradas
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, em seguida, continua executando o comando. Para determinar valores válidos para uma variável de preferência, como $WarningPreference
, defina-a como uma cadeia de caracteres aleatórios, como "abc". A mensagem de erro resultante lista os valores válidos.
Links Relacionados
Comentários
https://aka.ms/ContentUserFeedback.
Em breve: Ao longo de 2024, eliminaremos os problemas do GitHub como o mecanismo de comentários para conteúdo e o substituiremos por um novo sistema de comentários. Para obter mais informações, consulteEnviar e exibir comentários de