Write-Verbose
Escribe texto en la secuencia de mensaje detallada.
Sintaxis
Write-Verbose [-Message] <string> [<CommonParameters>]
Descripción
El cmdlet Write-Verbose escribe texto en la secuencia de mensaje detallada de Windows PowerShell. Normalmente, se usa la secuencia de mensaje detallada para entregar información sobre el procesamiento que se utiliza para depurar un comando.
De forma predeterminada, no se muestra la secuencia de mensaje detallada, pero se puede mostrarla cambiando el valor de la variable $VerbosePreference o utilizando el parámetro común Verbose en cualquier comando.
Parámetros
-Message <string>
Especifica el mensaje que se va a mostrar. Este parámetro es obligatorio. También puede canalizar una cadena de mensaje a Verbose-Message.
¿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-Verbose una cadena que contiene el mensaje. |
Salidas |
Ninguno Write-Verbose escribe únicamente en la secuencia de mensaje detallada. |
Ejemplo 1
C:\PS>Write-Verbose -message "Searching the Application Event Log."
C:\PS> Write-Verbose -message "Searching the Application Event Log." -verbose
Descripción
-----------
Estos comandos utilizan 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 común Verbose, que muestra todos los mensajes detallados, independientemente del valor de la variable $VerbosePreference.
Ejemplo 2
C:\PS>$VerbosePreference = "Continue"
C:\PS> Write-Verbose "Copying file $filename"
Descripción
-----------
Estos comandos utilizan el cmdlet Write-Verbose para mostrar un mensaje de estado. De forma predeterminada, no se muestra el mensaje.
El primer comando asigna el valor "Continue" a la variable de preferencia $VerbosePreference. El valor predeterminado, "SilentlyContinue", suprime los mensajes detallados.
El segundo comando escribe un mensaje detallado.