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