Write-Warning 帮助信息

 

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

译者: Edengundam(马涛)

 

Write-Warning

 

大纲

输出警告信息.

 

语法

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

 

详细描述

输出警告信息. 错误信息被直接发往宿主(host). 根据$WarningPreference 变量的值, 决定该警告信息是否被输出. 输入$WarningPreference可以查看该变量的当前值. 为当前会话(session)设置该变量值, 输入$WarningPreference = "<value>". 合法取值为: SilentlyContinue, Stop, Continue 和 Inquire. 如果设置为SilentlyContinue, Write-Warning 将不会向控制台输出警告信息. 如果警告消息被显示,则会被高亮显示.

 

参数

 

-message <string>

指定警告信息.

 

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

 

<公共参数>

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

 

输入类型

字符串(String)

 

返回类型

无(None)

 

注意

 

确定像$WarningPreference变量的合法值, 可以尝试赋值一些奇怪的字符串. 这将会导致错误信息中打印出该参数的合法变量值.

 

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

 

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

 

例 1

 

C:/PS>write-warning "This is only a test warning."

 

如果$WarningPreference设置不是SilentlyContinue, 此命令将会输出 "WARNING: This is only a test warning.".

 

相关链接

Write-Debug

Write-Error

Write-Host

Write-Output

Write-Progress

Write-Verbose