Compartir a través de

Write-Warning

  • Referencia
Módulo:
Microsoft.PowerShell.Utility

Escribe un mensaje de advertencia.

Sintaxis

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

Description

El Write-Warning cmdlet escribe un mensaje de advertencia en el host de PowerShell. La respuesta a la advertencia depende del valor de la variable del $WarningPreference usuario y del uso del parámetro común WarningAction .

Ejemplos

Ejemplo 1: Escribir un mensaje de advertencia

Este comando muestra el mensaje "WARNING: This is only a test warning".

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

Ejemplo 2: Pasar una cadena a Write-Warning

Este comando muestra que puede usar un operador de canalización (|) para enviar una cadena a Write-Warning. Puede guardar la cadena en una variable, como se muestra en este comando, o canalizar la cadena directamente a Write-Warning.

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

Ejemplo 3: Establecer la variable $WarningPreference y escribir una advertencia

En este ejemplo se muestra el efecto del valor de la $WarningPreference variable en 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 : 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."

El primer comando muestra el valor predeterminado de la $WarningPreference variable, que es Continue. Por ello, cuando se escribe una advertencia, se muestra el mensaje de advertencia y la ejecución continúa.

Al cambiar el valor de la $WarningPreference variable, el efecto del Write-Warning comando cambia de nuevo. Un valor de SilentlyContinue suprime la advertencia. Un valor de Stop muestra la advertencia y, a continuación, detiene la ejecución del comando.

Para obtener más información sobre la variable $WarningPreference, vea about_Preference_Variables.

Ejemplo 4: Establecimiento del parámetro WarningAction y escritura de una advertencia

En este ejemplo se muestra el efecto del parámetro común WarningAction en un Write-Warning comando. Puede usar el parámetro común WarningAction con cualquier cmdlet para determinar cómo responde PowerShell a las advertencias resultantes de ese comando. El parámetro común WarningAction invalida el valor del $WarningPreference único para ese comando en particular.

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

Este comando usa el Write-Warning cmdlet para mostrar una advertencia. El parámetro común WarningAction con un valor de Inquire dirige al sistema para preguntar al usuario cuando el comando muestra una advertencia.

Para obtener más información sobre el parámetro común WarningAction , consulte about_CommonParameters.

Parámetros

-Message

Especifica el mensaje de advertencia.

Tipo:String
Alias:Msg
Posición:0
Valor predeterminado:None
Requerido:True
Aceptar entrada de canalización:True
Aceptar caracteres comodín:False

Entradas

String

Puede canalizar una cadena que contenga la advertencia a este cmdlet.

Salidas

None

Este cmdlet no devuelve ningún resultado. Solo escribe en el flujo de advertencia.

Notas

El valor predeterminado de la $WarningPreference variable es Continue, que muestra la advertencia y, a continuación, continúa ejecutando el comando. Para determinar valores válidos para una variable de preferencia como $WarningPreference, establézcalo en una cadena de caracteres aleatorios, como "abc". El mensaje de error resultante muestra los valores válidos.