Write-Verbose

Writes text to the verbose message stream.

Syntax

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

Description

The Write-Verbose cmdlet writes text to the verbose message stream in Windows PowerShell. Typically, the verbose message stream is used to deliver information about command processing that is used for debugging a command.

By default, the verbose message stream is not displayed, but you can display it by changing the value of the $VerbosePreference variable or using the Verbose common parameter in any command.

Parameters

-Message <string>

Specifies the message to display. This parameter is required. You can also pipe a message string to Verbose-Message.

Required?	true
Position?	1
Default Value	none
Accept Pipeline Input?	true (ByValue)
Accept Wildcard Characters?	false

<CommonParameters>

This cmdlet supports the common parameters: -Verbose, -Debug, -ErrorAction, -ErrorVariable, -OutBuffer, and -OutVariable. For more information, see about_CommonParameters.

Inputs and Outputs

The input type is the type of the objects that you can pipe to the cmdlet. The return type is the type of the objects that the cmdlet returns.

Inputs

System.String

You can pipe a string that contains the message to Write-Verbose.

Outputs

None

Write-Verbose writes only to the verbose message stream.

Example 1

C:\PS>Write-Verbose -message "Searching the Application Event Log."

C:\PS> Write-Verbose -message "Searching the Application Event Log." -verbose




Description
-----------
These commands use the Write-Verbose cmdlet to display a status message. By default, the message is not displayed.

The second command uses the Verbose common parameter, which displays any verbose messages, regardless of the value of the $VerbosePreference variable.

Example 2

C:\PS>$VerbosePreference = "Continue"

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

These commands use the Write-Verbose cmdlet to display a status message. By default, the message is not displayed.

The first command assigns a value of "Continue" to the $VerbosePreference preference variable. The default value, "SilentlyContinue", suppresses verbose messages.

The second command writes a verbose message.