Write-Verbose

  • Referencia
Módulo:
Microsoft.PowerShell.Utility

Escribe texto en la secuencia de mensajes detallados.

Syntax

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

Description

El Write-Verbose cmdlet 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, la secuencia de mensajes detallada no se muestra, pero puede mostrarla cambiando el valor de la $VerbosePreference variable o usando el parámetro común Detallado 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 Write-Verbose cmdlet para mostrar un mensaje de estado. De forma predeterminada, el mensaje no se muestra.

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

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

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

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

El primer comando asigna un valor de Continue a la $VerbosePreference variable de preferencia. 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.

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

Salidas

None

Este cmdlet no devuelve ningún resultado. Solo escribe en la secuencia de mensajes detallada.

Notas

  • Los mensajes detallados solo se devuelven cuando el comando usa el parámetro común Detallado . Para obtener más información, consulta about_CommonParameters.
  • En los trabajos en segundo plano de Windows PowerShell y los comandos remotos, la $VerbosePreference variable de 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 $VerbosePreference, vea about_Preference_Variables.