Write-Warning

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

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 WarningAction parámetro común.

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

Este comando muestra el mensaje "WARNING: This is only a test 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.

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. 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 $WarningPreference, consulte about_Preference_Variables.

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 WarningAction parámetro común en un comando Write-Warning. Puede usar el WarningAction parámetro común con cualquier cmdlet para determinar cómo responde Windows 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.

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.

Este cmdlet admite los parámetros comunes: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction y -WarningVariable. Para obtener más información, vea about_CommonParameters.

Puede canalizar una cadena que contenga la advertencia para De advertencia de escritura.

write-Warning escribe solo en la secuencia de advertencias. No genera ninguna otra salida.

• 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 mostrará los valores válidos.