Share via

Write-Verbose

  • Referencia
Módulo:
Microsoft.PowerShell.Utility

Escribe texto en la secuencia de mensajes detallados.

Syntax

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

Description

El cmdlet Write-Verbose escribe texto en la secuencia de mensajes detallados en Windows PowerShell. Normalmente, la secuencia de mensajes detallados se usa para entregar información sobre el procesamiento de comandos que se usa para depurar un comando.

De forma predeterminada, la secuencia de mensajes detallados no se muestra, pero se puede mostrar si se cambia el valor de la variable $VerbosePreference o se usa el parámetro común Verbose en cualquier comando.

Ejemplos

Ejemplo 1: Escribir un mensaje de estado

PS C:\> Write-Verbose -Message "Searching the Application Event Log."
PS C:\> 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, 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 variable $VerbosePreference .

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

PS C:\> $VerbosePreference = "Continue"
PS C:\> Write-Verbose "Copying file $filename"

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

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 se 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

Se puede canalizar una cadena que contenga el mensaje a Write-Verbose.

Salidas

None

Write-Verbose escribe solo en la secuencia de mensajes detallada.

Notas

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