Get-SCOMAlert

模块:

OperationsManager

获取 Operations Manager 警报。

语法

Get-SCOMAlert
   [-SCSession <Connection[]>]
   [-ComputerName <String[]>]
   [-Credential <PSCredential>]
   [<CommonParameters>]

Get-SCOMAlert
   [-Id] <Guid[]>
   [-SCSession <Connection[]>]
   [-ComputerName <String[]>]
   [-Credential <PSCredential>]
   [<CommonParameters>]

Get-SCOMAlert
   [[-Instance] <EnterpriseManagementObject[]>]
   [[-LastModifiedBy] <String[]>]
   [[-Name] <String[]>]
   [[-Owner] <String[]>]
   [[-ResolutionState] <Int32[]>]
   [[-ResolvedBy] <String[]>]
   [[-HealthState] <String[]>]
   [[-Priority] <String[]>]
   [[-Severity] <String[]>]
   [-SCSession <Connection[]>]
   [-ComputerName <String[]>]
   [-Credential <PSCredential>]
   [<CommonParameters>]

Get-SCOMAlert
   [[-Criteria] <String>]
   [-SCSession <Connection[]>]
   [-ComputerName <String[]>]
   [-Credential <PSCredential>]
   [<CommonParameters>]

说明

Get-SCOMAlert cmdlet 获取一个或多个警报。 警报指示需要注意的重要事件。 规则和监视器可以生成警报。

示例

示例 1：获取所有新警报

PS C:\>Get-SCOMAlert -ResolutionState 0

此命令获取所有分辨率为零（新警报）的警报。

示例 2：获取所有非关闭警报

PS C:\>Get-SCOMAlert -Criteria "ResolutionState != 255 and Severity != 0"

此命令获取所有没有解决状态为 255（已关闭警报）且严重性不是信息性的警报。

示例 3：使用自定义字段获取警报

PS C:\>Get-SCOMAlert -Criteria "CustomField1 = 'TestServer'"

此命令获取在 CustomField1 属性中具有 TestServer 值的所有警报。

示例 4：获取过去 30 分钟内修改的警报

PS C:\>Get-SCOMAlert -Criteria "LastModified > '$((Get-Date).AddMinutes(-30))'"

此命令获取在过去 30 分钟内修改的所有警报。 从 LastModified 返回的时间值采用 UTC，而 Get-Date 为本地系统时间。

示例 5：获取警报并禁止显示错误消息

PS C:\>$OriginalErrorAction = $ErrorActionPreference
PS C:\> $ErrorActionPreference = "SilentlyContinue"
PS C:\> Get-SCOMClass -Name "*health*" | Get-SCOMClassInstance | Get-SCOMAlert -ResolutionState (5..200)
PS C:\> $ErrorActionPreference = $OriginalErrorAction

此示例获取警报并禁止显示与命令条件不匹配的类实例的错误消息。

第一个命令将$ErrorActionPreference变量的值存储在$OriginalErrorAction变量中。

第二个命令将$ErrorActionPreference变量的值设置为 SilentlyContinue。 通过将$ErrorActionPreference变量的值设置为 SilentlyContinue，没有匹配任务结果的类实例将继续运行，并且不显示错误。

第三个命令获取名称中具有运行状况的所有类，并使用管道运算符将类对象传递给 Get-SCOMClassInstance cmdlet。 Get-SCOMClassInstance 获取每个类对象的类实例，并将每个类实例对象传递给 Get-SCOMAlert cmdlet。 Get-SCOMAlert cmdlet 返回每个类实例的解析状态为 5 到 200（含 5）的警报。

第四个命令将$ErrorActionPreference变量的值设置回存储在$OriginalErrorAction变量中的值。

示例 6：使用 ID 获取警报

PS C:\>Get-SCOMAlert -Id 7413b06b-a95b-4ae3-98f2-dac9ff76dabd

此命令获取 ID 为 7413b06b-a95b-4ae3-98f2-dac9ff76dabd 的警报。

参数

-ComputerName

指定计算机名称数组。 可以使用 NetBIOS 名称、IP 地址或完全限定的域名（FQDN）。 若要指定本地计算机，请键入计算机名称、localhost 或点（.）。

System Center Data Access 服务必须在计算机上运行。 如果未指定计算机，该 cmdlet 将使用计算机进行当前管理组连接。

类型:	String[]
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

-Credential

为管理组连接指定 PSCredential 对象。 若要获取 PSCredential 对象，请使用 Get-Credential cmdlet。 有关详细信息，请键入 Get-Help Get-Credential。

如果在 ComputerName 参数中指定计算机，请使用有权访问该计算机的帐户。 默认值为当前用户。

类型:	PSCredential
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

-Criteria

指定指示如何筛选警报的条件 XML。 条件可以筛选特定规则或监视器或警报的属性，但不能筛选类或组。 可在此处找到更多详细信息：https://learn.microsoft.com/previous-versions/system-center/developer/bb437603(v=msdn.10)?redirectedfrom=MSDN

类型:	String
Position:	10
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

-HealthState

指定运行状况状态数组。 有效值为：严重（红色）、警告（黄色）、正常（绿色）。

类型:	String[]
Position:	7
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

-Id

指定警报对象的 GUID 数组。 若要获取警报的 ID，请键入“Get-SCOMAlert | Format-Table Name, Id”。

类型:	Guid[]
Position:	1
默认值:	None
必需:	True
接受管道输入:	True
接受通配符:	False

-Instance

指定类实例对象的数组。 此参数还接受组对象。 若要获取类实例对象，请使用 Get-SCOMClassInstance cmdlet。 有关详细信息，请键入 Get-Help Get-SCOMClassInstance。

类型:	EnterpriseManagementObject[]
Position:	1
默认值:	None
必需:	False
接受管道输入:	True
接受通配符:	False

-LastModifiedBy

指定用户名数组。 如果编辑警报的最后一个用户与指定的用户名匹配，则 cmdlet 将获取警报。

类型:	String[]
Position:	2
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	True

-Name

指定警报名称数组。 该 cmdlet 获取与指定的警报名称匹配的警报。

类型:	String[]
Position:	3
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	True

-Owner

指定用户名数组。 如果警报的所有者与指定的用户名匹配，则 cmdlet 将获取警报。

类型:	String[]
Position:	4
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	True

-Priority

指定警报特权级别数组。 有效值为：

• 低
• 中等
• 高

类型:	String[]
Position:	8
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

-ResolutionState

指定解析状态 ID 数组。

生成警报时，其解析状态为“新建”。 操作员可以将新警报的解析状态更改为“已关闭”或更改为管理员为管理组创建的自定义解析状态。 “新建”的 ID 为 0，关闭的 ID 为 255。 可以分配自定义解析状态（从 2 到 254）。

类型:	Int32[]
Position:	5
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	True

-ResolvedBy

指定用户名数组。 如果解析警报的用户与指定的用户名匹配，则 cmdlet 将获取警报。

类型:	String[]
Position:	6
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	True

-SCSession

指定 连接 对象的数组。 若要获取 连接 对象，请使用 Get-SCOMManagementGroupConnection cmdlet。

连接对象表示与管理服务器的连接。 默认值为当前管理组连接。

类型:	Connection[]
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

-Severity

指定警报严重性值的数组。 有效值为：

• 信息
• 警告
• 危急

类型:	String[]
Position:	9
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

相关链接

• Get-SCOMClassInstance
• Set-SCOMAlert
• Resolve-SCOMAlert