Start-SCOMMaintenanceMode

将对象置于维护模式,并创建活动维护模式条目。

语法

Default (默认值)

Start-SCOMMaintenanceMode
    [-Instance] <MonitoringObject[]>
    [-EndTime] <DateTime>
    [[-Comment] <String>]
    [[-Reason] <MaintenanceModeReason>]
    [-PassThru]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

说明

Start-SCOMMaintenanceMode cmdlet 将受监视的对象(如计算机或分布式应用程序)放入维护模式,并创建活动维护模式条目。 当资源处于维护模式时,System Center - Operations Manager 将禁止警报、通知、规则、监视器、自动响应、状态更改和新警报。

指定要放入维护模式的类实例和维护时段的结束时间。 还可以包括注释和维护模式的原因。 可以使用 Set-SCOMMaintenanceMode cmdlet 更新活动维护模式条目,并使用 Get-SCOMMaintenanceMode cmdlet 获取活动和非活动条目。

示例

示例 1:将资源置于维护模式

PS C:\>$Instance = Get-SCOMClassInstance -Name "Server01.Contoso.com"
PS C:\> $Time = ((Get-Date).AddMinutes(10))
PS C:\> Start-SCOMMaintenanceMode -Instance $Instance -EndTime $Time -Comment "Applying software update." -Reason "SecurityIssue"

本示例将资源置于维护模式 10 分钟。 第一个命令使用 Get-SCOMClassInstance cmdlet 获取名为 Server01.Contoso.com 的类实例。

第二个命令在将来创建一个 DateTime 对象 10 分钟,然后将其存储在$Time变量中。

第三个命令将存储在$Instance变量中的对象定义的资源置于维护模式。 维护模式在存储在$Time变量中时结束。 该命令包括维护模式的原因和注释。

参数

-Comment

指定维护模式条目的注释。

参数属性

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

参数集

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

-Confirm

在运行 cmdlet 之前,提示你进行确认。

参数属性

类型:SwitchParameter
默认值:False
支持通配符:False
不显示:False
别名:cf

参数集

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

-EndTime

指定维护模式何时结束,作为 DateTime 对象。 资源在维护模式下不能超过 5 分钟。 若要获取 DateTime 对象,请使用 Get-Date cmdlet。 有关详细信息,请键入 Get-Help Get-Date

参数属性

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

参数集

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

-Instance

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

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

参数属性

类型:

MonitoringObject[]

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

参数集

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

-PassThru

指示 cmdlet 创建或修改命令可以在管道中使用的对象。 默认情况下,此 cmdlet 不生成任何输出。

参数属性

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

参数集

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

-Reason

指定维护模式的原因。 此参数的可接受值为:

  • PlannedOther
  • 计划外
  • PlannedHardwareMaintenance
  • UnplannedHardwareMaintenance
  • PlannedHardwareInstallation
  • UnplannedHardwareInstallation
  • PlannedOperatingSystemReconfiguration
  • UnplannedOperatingSystemReconfiguration
  • PlannedApplicationMaintenance
  • ApplicationInstallation
  • ApplicationUnresponsive
  • ApplicationUnstable
  • SecurityIssue
  • LossOfNetworkConnectivity

参数属性

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

参数集

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

-WhatIf

显示 cmdlet 运行时会发生什么情况。 cmdlet 未运行。

参数属性

类型:SwitchParameter
默认值:False
支持通配符:False
不显示:False
别名:无线

参数集

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

CommonParameters

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