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 到 200）的警报。

第四个命令将$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 会将该计算机用于当前管理组连接。

Type:	String[]
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-Credential

为管理组连接指定 PSCredential 对象。 若要获取 PSCredential 对象，请使用 Get-Credential cmdlet。 要了解详情，请键入 Get-Help Get-Credential。

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

Type:	PSCredential
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-Criteria

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

Type:	String
Position:	10
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-HealthState

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

Type:	String[]
Position:	7
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-Id

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

Type:	Guid[]
Position:	1
Default value:	None
Required:	True
Accept pipeline input:	True
Accept wildcard characters:	False

-Instance

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

Type:	EnterpriseManagementObject[]
Position:	1
Default value:	None
Required:	False
Accept pipeline input:	True
Accept wildcard characters:	False

-LastModifiedBy

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

Type:	String[]
Position:	2
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	True

-Name

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

Type:	String[]
Position:	3
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	True

-Owner

指定用户名数组。 如果警报的所有者与指定的用户名匹配，则 cmdlet 会收到警报。

Type:	String[]
Position:	4
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	True

-Priority

指定警报原始级别的数组。 有效值为：

• 低
• 中
• 高

Type:	String[]
Position:	8
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-ResolutionState

指定解析状态 ID 的数组。

生成警报时，解决状态为“新的”。 操作人员可以将新警报的解决状态改为“已关闭”，或者改为管理员针对管理组创建的自定义解决状态。 New 的 ID 为 0，Closed 的 ID 为 255。 可以为自定义解析状态分配 2 到 254 的任何值。

Type:	Int32[]
Position:	5
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	True

-ResolvedBy

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

Type:	String[]
Position:	6
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	True

-SCSession

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

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

Type:	Connection[]
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-Severity

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

• 信息
• 警告
• 严重

Type:	String[]
Position:	9
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

相关链接

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