Write-Verbose
将文本写入详细消息流。
语法
Write-Verbose
[-Message] <String>
[<CommonParameters>]
说明
Write-Verbose
cmdlet 在 PowerShell 中将文本写入详细消息流。 通常,详细消息流用于传递有关命令处理的更深入的信息。
默认情况下不显示详细消息流,但可通过更改 $VerbosePreference
变量的值或在任何命令中使用 Verbose 通用参数显示该流。
示例
示例 1:编写状态消息
Write-Verbose -Message "Searching the Application Event Log."
Write-Verbose -Message "Searching the Application Event Log." -Verbose
这些命令使用 Write-Verbose
cmdlet 显示状态消息。 默认情况下,不显示此消息。
第二个命令使用 Verbose 通用参数,不管 $VerbosePreference
变量的值如何,该参数都将显示所有详细消息。
示例 2:设置 $VerbosePreference 并编写状态消息
$VerbosePreference = "Continue"
Write-Verbose "Copying file $filename"
这些命令使用 Write-Verbose
cmdlet 显示状态消息。 默认情况下,不显示此消息。
第一个命令将 Continue 值赋给 $VerbosePreference
首选项变量。 默认值 SilentlyContinue
将禁止显示详细消息。 第二个命令写入详细消息。
参数
-Message
指定要显示的消息。 此参数是必需的。 还可通过管道将消息字符串传递给 Write-Verbose
。
Type: | String |
Aliases: | Msg |
Position: | 0 |
Default value: | None |
Required: | True |
Accept pipeline input: | True |
Accept wildcard characters: | False |
输入
可通过管道将包含消息的字符串传递给 Write-Verbose
。
输出
None
此 cmdlet 不返回任何输出。 它只写入到详细消息流。
备注
- 仅在该命令使用 Verbose 通用参数时才返回详细消息。 有关详细信息,请参阅 about_CommonParameters。
- 在 Windows PowerShell 后台作业和远程命令中,作业会话和远程会话中的
$VerbosePreference
变量决定了默认情况下是否显示详细消息。 有关$VerbosePreference
变量的详细信息,请参阅 about_Preference_Variables。
相关链接
反馈
https://aka.ms/ContentUserFeedback。
即将发布:在整个 2024 年,我们将逐步淘汰作为内容反馈机制的“GitHub 问题”,并将其取代为新的反馈系统。 有关详细信息,请参阅:提交和查看相关反馈