Compartir a través de

Write-Verbose

  • Referencia
Módulo:
Microsoft.PowerShell.Utility

Escribe texto en la secuencia de mensajes detallada.

Sintaxis

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

Description

El cmdlet Write-Verbose escribe texto en el flujo de mensajes detallado en PowerShell. Normalmente, la secuencia de mensajes detallada se usa para proporcionar información más detallada sobre el procesamiento de comandos.

De forma predeterminada, no se muestra la secuencia de mensajes detallada, pero puede mostrarla cambiando el valor de la variable $VerbosePreference o usando el verbose parámetro común en cualquier comando.

Ejemplos

Ejemplo 1: Escribir un mensaje de estado

Write-Verbose -Message "Searching the Application Event Log."
Write-Verbose -Message "Searching the Application Event Log." -Verbose

Estos comandos usan el cmdlet Write-Verbose para mostrar un mensaje de estado. De forma predeterminada, no se muestra el mensaje.

El segundo comando usa el parámetro Verbose common, que muestra los mensajes detallados, independientemente del valor de la variable $VerbosePreference.

Ejemplo 2: Establecer $VerbosePreference y escribir un mensaje de estado

$VerbosePreference = "Continue"
Write-Verbose "Copying file $filename"

Estos comandos usan el cmdlet Write-Verbose para mostrar un mensaje de estado. De forma predeterminada, no se muestra el mensaje.

El primer comando asigna un valor de Continue a la variable de preferencia $VerbosePreference. El valor predeterminado, SilentlyContinue, suprime los mensajes detallados. El segundo comando escribe un mensaje detallado.

Parámetros

-Message

Especifica el mensaje que se va a mostrar. Este parámetro es obligatorio. También puede canalizar una cadena de mensaje a Write-Verbose.

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 el mensaje a este cmdlet.

Salidas

None

Este cmdlet no devuelve ninguna salida. Solo escribe en la secuencia de mensajes detallada.

Notas

  • Los mensajes detallados solo se devuelven cuando el comando usa el verbose parámetro común. Para obtener más información, vea about_CommonParameters.
  • En los trabajos en segundo plano de Windows PowerShell y los comandos remotos, la variable $VerbosePreference en la sesión de trabajo y la sesión remota determinan si el mensaje detallado se muestra de forma predeterminada. Para obtener más información sobre la variable de $VerbosePreference, vea about_Preference_Variables.