Compartir a través de

Write-Warning

  • Referencia
Módulo:
Microsoft.PowerShell.Utility

Escribe un mensaje de advertencia.

Syntax

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

Description

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

Ejemplos

Ejemplo 1: Escribir un mensaje de advertencia

PS C:\> Write-Warning "This is only a test warning."

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

Ejemplo 2: Pasar una cadena a Write-Warning

PS C:\> $w = "This is only a test warning."
PS C:\> $w | 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.

Ejemplo 3: Establecimiento de la variable $WarningPreference y escritura de una advertencia

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."

En este ejemplo se muestra el efecto del valor de la variable $WarningPreference en un comando Write-Warning .

El primer comando muestra el valor predeterminado de la variable $WarningPreference, 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 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 $WarningPreference, consulte about_Preference_Variables.

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

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

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

Este comando usa el cmdlet Write-Warning 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.

Type:String
Aliases:Msg
Position:0
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

Entradas

String

Puede canalizar una cadena que contenga la advertencia a Write-Warning.

Salidas

None

Write-Warning escribe solo en el flujo de advertencia. No genera ningún otro resultado.

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 los valores válidos de una variable de preferencia como $WarningPreference, establézcala como una cadena de caracteres aleatorios, como "abc". El mensaje de error resultante mostrará los valores válidos.