将文本写入详细消息流。

语法

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

说明

Write-Verbose cmdlet 将文本写入 Windows PowerShell 中的详细消息流。通常，详细消息流用来提供有关命令处理的信息，以用于调试某个命令。

默认情况下不显示详细消息流，但是您可以通过更改 $VerbosePreference 变量的值或在任何命令中使用 Verbose 通用参数来显示它。

参数

-Message <string>

指定要显示的消息。此参数是必需的。还可以通过管道将消息字符串传递给 Verbose-Message。

是否为必需？

true

位置？

1

默认值

是否接受管道输入？

true (ByValue)

是否接受通配符？

false

<CommonParameters>

此 cmdlet 支持通用参数：-Verbose、-Debug、-ErrorAction、-ErrorVariable、-OutBuffer 和 -OutVariable。有关详细信息，请参阅 about_Commonparameters.

输入和输出

输入类型是指可通过管道传递给 cmdlet 的对象的类型。返回类型是指 Cmdlet 所返回对象的类型。

输入

System.String

可以通过管道将包含消息的字符串传递给 Write-Verbose。

输出

None

Write-Verbose 只写入详细消息流。

示例 1

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

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

说明
-----------
这些命令使用 Write-Verbose cmdlet 显示一条状态消息。默认情况下不显示该消息。

第二条命令使用 Verbose 通用参数显示任何详细消息，无论 $VerbosePreference 变量的值如何。

示例 2

C:\PS>$VerbosePreference = "Continue"

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

说明
-----------
这些命令使用 Write-Verbose cmdlet 显示一条状态消息。默认情况下不显示该消息。

第一条命令为 $VerbosePreference 首选项变量赋予值“Continue”。默认值“SilentlyContinue”禁止显示详细消息。

第二条命令写入一条详细消息。

另请参阅



目录