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

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 variable $WarningPreference en un comando Write-Warning.

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.

El primer comando muestra el valor predeterminado de la variable $WarningPreference, que es Continue. Como resultado, al escribir una advertencia, se muestra el mensaje de advertencia y la ejecución continúa.

Al cambiar el valor de la variable $WarningPreference, el efecto del comando Write-Warning 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 de $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 WarningAction parámetro común en un comando de Write-Warning. Puede usar el WarningAction parámetro común con cualquier cmdlet para determinar cómo Responde PowerShell a las advertencias resultantes de ese comando. El WarningAction parámetro común invalida el valor del $WarningPreference solo 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 cmdlet Write-Warning para mostrar una advertencia. El WarningAction parámetro común 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 ninguna salida. Solo escribe en el flujo de advertencia.

Notas

El valor predeterminado de la variable $WarningPreference 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.