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