Compartir a través de

Write-Warning

  • Artículo

Escribe un mensaje de advertencia.

Sintaxis

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

Descripción

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.

Parámetros

-Message <string>

Especifica el mensaje de advertencia.

¿Requerido?

true

¿Posición?

1

Valor predeterminado

¿Aceptar canalización?

true (ByValue)

¿Aceptar caracteres comodín?

false

<CommonParameters>

Este cmdlet admite los parámetros comunes: -Verbose, -Debug, -ErrorAction, -ErrorVariable, -OutBuffer y -OutVariable. Para obtener más información, vea about_Commonparameters.

Entradas y salidas

El tipo de entrada es el tipo de los objetos que se pueden canalizar al cmdlet. El tipo devuelto es el tipo de los objetos que el cmdlet devuelve.

Entradas

System.String

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

Salidas

Ninguno

Write-Warning escribe únicamente en la secuencia de advertencia. No genera ningún otro resultado.

Notas

El valor predeterminado de la variable $WarningPreference es "Continue", el cual muestra la advertencia y, a continuación, sigue ejecutando el comando. Para determinar los valores válidos de una variable de preferencia como $WarningPreference, defínala como una cadena de caracteres aleatorios, como "abc". El mensaje de error resultante mostrará los valores válidos.

Ejemplo 1

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

Descripción
-----------
Este comando muestra el mensaje "WARNING: This is only a test warning" (ADVERTENCIA: esta es solo una advertencia de prueba).

Ejemplo 2

C:\PS>$w = "This is only a test warning."

C:\PS> $w | write-warning

Descripción
-----------
En este ejemplo se muestra que se puede utilizar un operador de canalización (|) para enviar una cadena a Write-Warning. La cadena se puede guardar en una variable, tal y como se muestra en este comando, o canalizar directamente a Write-Warning.

Ejemplo 3

C:\PS>$warningpreference

Continue

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

C:\PS> $warningpreference = "SilentlyContinue"

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

C:\PS> $warningpreference = "Stop"

C:\PS> 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."

Descripción
-----------
En este ejemplo se muestra el efecto que tiene el valor de la variable $WarningPreference en un comando Write-Warning.

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

Cuando cambia el valor de la variable $WarningPreference, el comando Write-Warning tiene otro efecto. El valor "SilentlyContinue" suprime la advertencia. El valor "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

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

Descripción
-----------
En este ejemplo se muestra el efecto del parámetro común WarningAction en un comando Write-Warning. El parámetro común WarningAction puede usarse con cualquier cmdlet para determinar cómo Windows PowerShell va a responder a las advertencias generadas por dicho comando. El parámetro común WarningAction invalida el valor de $WarningPreference únicamente para ese comando en cuestión.

Este comando usa el cmdlet Write-Warning para mostrar una advertencia. El parámetro común WarningAction con el valor "Inquire" indica al sistema que avise al usuario cuando el comando muestre una advertencia.

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

Vea también

Conceptos

about_Preference_Variables
about_Commonparameters
Write-Debug
Write-Error
Write-Host
Write-Output
Write-Progress
Write-Verbose