关键字： PowerShell 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.".