Get-SCOMAlert

获取 Operations Manager 警报。

语法

Empty (默认值)

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

FromAlertId

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

FromAlertDefault

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>]

FromCriteria

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[]

默认值:None
支持通配符:False
不显示:False

参数集

(All)
Position:Named
必需:False
来自管道的值:False
来自管道的值(按属性名称):False
来自剩余参数的值:False

-Credential

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

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

参数属性

类型:PSCredential
默认值:None
支持通配符:False
不显示:False

参数集

(All)
Position:Named
必需:False
来自管道的值:False
来自管道的值(按属性名称):False
来自剩余参数的值:False

-Criteria

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

参数属性

类型:String
默认值:None
支持通配符:False
不显示:False

参数集

FromCriteria
Position:10
必需:False
来自管道的值:False
来自管道的值(按属性名称):False
来自剩余参数的值:False

-HealthState

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

参数属性

类型:

String[]

默认值:None
支持通配符:False
不显示:False

参数集

FromAlertDefault
Position:7
必需:False
来自管道的值:False
来自管道的值(按属性名称):False
来自剩余参数的值:False

-Id

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

参数属性

类型:

Guid[]

默认值:None
支持通配符:False
不显示:False

参数集

FromAlertId
Position:1
必需:True
来自管道的值:True
来自管道的值(按属性名称):False
来自剩余参数的值:False

-Instance

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

参数属性

类型:

EnterpriseManagementObject[]

默认值:None
支持通配符:False
不显示:False

参数集

FromAlertDefault
Position:1
必需:False
来自管道的值:True
来自管道的值(按属性名称):False
来自剩余参数的值:False

-LastModifiedBy

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

参数属性

类型:

String[]

默认值:None
支持通配符:True
不显示:False

参数集

FromAlertDefault
Position:2
必需:False
来自管道的值:False
来自管道的值(按属性名称):False
来自剩余参数的值:False

-Name

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

参数属性

类型:

String[]

默认值:None
支持通配符:True
不显示:False

参数集

FromAlertDefault
Position:3
必需:False
来自管道的值:False
来自管道的值(按属性名称):False
来自剩余参数的值:False

-Owner

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

参数属性

类型:

String[]

默认值:None
支持通配符:True
不显示:False

参数集

FromAlertDefault
Position:4
必需:False
来自管道的值:False
来自管道的值(按属性名称):False
来自剩余参数的值:False

-Priority

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

  • 中等

参数属性

类型:

String[]

默认值:None
支持通配符:False
不显示:False

参数集

FromAlertDefault
Position:8
必需:False
来自管道的值:False
来自管道的值(按属性名称):False
来自剩余参数的值:False

-ResolutionState

指定解析状态 ID 数组。

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

参数属性

类型:

Int32[]

默认值:None
支持通配符:True
不显示:False

参数集

FromAlertDefault
Position:5
必需:False
来自管道的值:False
来自管道的值(按属性名称):False
来自剩余参数的值:False

-ResolvedBy

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

参数属性

类型:

String[]

默认值:None
支持通配符:True
不显示:False

参数集

FromAlertDefault
Position:6
必需:False
来自管道的值:False
来自管道的值(按属性名称):False
来自剩余参数的值:False

-SCSession

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

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

参数属性

类型:

Connection[]

默认值:None
支持通配符:False
不显示:False

参数集

(All)
Position:Named
必需:False
来自管道的值:False
来自管道的值(按属性名称):False
来自剩余参数的值:False

-Severity

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

  • 信息
  • 警告
  • 危急

参数属性

类型:

String[]

默认值:None
支持通配符:False
不显示:False

参数集

FromAlertDefault
Position:9
必需:False
来自管道的值:False
来自管道的值(按属性名称):False
来自剩余参数的值:False

CommonParameters

此 cmdlet 支持通用参数:-Debug、-ErrorAction、-ErrorVariable、-InformationAction、-InformationVariable、-OutBuffer、-OutVariable、-PipelineVariable、-ProgressAction、-Verbose、-WarningAction 和 -WarningVariable。 有关详细信息,请参阅 about_CommonParameters