Get-SCOMMaintenanceMode

获取维护模式条目。

语法

Get-SCOMMaintenanceMode
   [[-Instance] <MonitoringObject[]>]
   [-History]
   [-SCSession <Connection[]>]
   [-ComputerName <String[]>]
   [-Credential <PSCredential>]
   [<CommonParameters>]

说明

Get-SCOMMaintenanceMode cmdlet 获取维护模式条目。 可以使用此 cmdlet 向 Set-SCOMMaintenanceMode cmdlet 提供对象,也可以单独查看有关维护模式条目的详细信息。

当资源处于维护模式时,System Center - Operations Manager 会取消警报、通知、规则、监视器、自动响应、状态更改和新警报。

当单独使用此 cmdlet 时,它会显示本地时间的信息。 如果将其结果通过管道传递给 Format-Table cmdlet,则 cmdlet 在协调世界时 (UTC) 中提供信息。 有关 Format-Table 的详细信息,请键入 Get-Help Format-Table

默认情况下,此 cmdlet 使用与管理组的活动持久连接。 使用 SCSession 参数指定不同的持久连接。 可以使用 ComputerNameCredential 参数创建与管理组的临时连接。 要了解详情,请键入 Get-Help about_OpsMgr_Connections

示例

示例 1:获取所有活动维护模式条目

PS C:\>Get-SCOMMaintenanceMode

此命令获取所有活动维护模式条目。 若要包含非活动条目,请指定 History 参数。

示例 2:获取指定域的所有活动维护模式条目

PS C:\>Get-SCOMMaintenanceMode -Instance (Get-SCOMClassInstance -Name "*.Contoso.com") -ErrorAction SilentlyContinue

此命令获取 Contoso.com 域中类实例的所有活动维护模式条目。 该命令使用 Get-SCOMClassInstance cmdlet 获取包含 Contoso.com 的实例。

如果命令遇到缺少活动维护模式条目的类实例, 则 ErrorAction 参数允许命令继续运行,而不会显示错误。

示例 3:获取指定域的所有维护模式条目

PS C:\>Get-SCOMClassInstance -Name "*.Contoso.com" | Get-SCOMMaintenanceMode -History

此命令获取 Contoso.com 域中的所有类实例,然后使用管道运算符 (|) 将类实例对象传递给 Get-SCOMMaintenanceMode cmdlet。 此示例使用 History 参数;因此, 命令获取所有维护模式条目,包括非活动条目。

参数

-ComputerName

指定计算机的名称数组。 cmdlet 与这些计算机的管理组建立临时连接。 可以使用 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

-History

指示 cmdlet 获取所有维护模式条目,包括非活动条目。 如果没有此参数,cmdlet 将仅获取活动维护模式条目。

Type:SwitchParameter
Position:2
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Instance

指定表示实例的监视对象的数组。 若要获取监视对象,请使用 Get-SCOMClassInstance cmdlet。

此参数还接受组对象。 若要获取组对象,请使用 Get-SCOMGroup cmdlet。

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

-SCSession

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

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