Write-Verbose 帮助信息

 

如下说明是翻译: help write-verbose 产生的帮助信息.

译者: Edengundam(马涛)

Write-Verbose

 

大纲

输出消息到宿主的冗余(verbose)显示.

 

语法

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

 

详细描述

输出消息到宿主的冗余(verbose)显示. $VerbosePreference变量的取值决定了字符串是否被输出到windows控制台. 查看该变量的取值, 输入 $VerbosePreference. 合法取值为: SilentlyContinue, Stop, Continue 和 Inquire. 设置当前会话该变量的值, 输入 $VerbosePreference = "<value>". 如果 $VerbosePreference 设置为 SilentlyContinue, 执行 Write-Verbose 将不会显示任何信息在控制台. 对于$verbosepreference的其他取值, 该cmdlet 显示信息到控制台并根据该变量值决定是继续, 停止或者询问用户是否继续执行.

 

在脚本中, 使用Write-Verbose cmdlet, 可以允许用户通过设置$VerbosePreference 变量来控制是否产生显示详细描述信息.

 

参数

 

-message <string>

指出需要显示的消息.

 

强制参数?	True
参数位置?	1
默认值
允许从管道绑定输入?	True (传值)
允许通配符扩展?	False

 

<公共参数>

此命令支持公共参数: -Verbose, -Debug, -ErrorAction, -ErrorVariable, and -OutVariable. 更多信息, 输入, "get-help about_commonparameters".

 

输入类型

字符串

 

注意

 

更多信息, 输入"Get-Help Write-Verbose -detailed". 需要技术信息, 输入"Get-Help Write-Verbose -full".

 

如果需要为该命令提供多个参数, 请使用逗号进行分隔. 例如, "<parameter-name> <value1>, <value2>".

 

例1

 

C:/PS>$verbosepreference = "silentlycontinue"

write-verbose "test"

$verbosepreference = "continue"

write-verbose "test"

 

此命令首先设置$verbosepreference为SilentlyContinue. 然后使用Write-Verbose cmdlet 打印消息'test'. 因为$verbosepreference变量原因, 将不会有任何的显示. 当$verbose preference变量值改变为Continue, 再次调用Write-Verbose显示消息'test'将会得到期望效果.

 

相关链接

Write-Host

Write-Error

Write-Output

Write-Debug

Write-Progress

Write-Warning