Start-SCOMMaintenanceMode

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

语法

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

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

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

-Confirm

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

Type:SwitchParameter
Aliases:cf
Position:Named
Default value:False
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-EndTime

指定维护模式结束的时间,作为 DateTime 对象。 资源处于维护模式的时间不能少于 5 分钟。 若要获取 DateTime 对象,请使用 Get-Date cmdlet。 要了解详情,请键入 Get-Help Get-Date

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

-Instance

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

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

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

-PassThru

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

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

-Reason

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

  • PlannedOther
  • UnplannedOther
  • PlannedHardwareMaintenance
  • UnplannedHardwareMaintenance
  • PlannedHardwareInstallation
  • UnplannedHardwareInstallation
  • PlannedOperatingSystemReconfiguration
  • UnplannedOperatingSystemReconfiguration
  • PlannedApplicationMaintenance
  • ApplicationInstallation
  • ApplicationUnresponsive
  • ApplicationUnstable
  • SecurityIssue
  • LossOfNetworkConnectivity
Type:MaintenanceModeReason
Position:4
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-WhatIf

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

Type:SwitchParameter
Aliases:wi
Position:Named
Default value:False
Required:False
Accept pipeline input:False
Accept wildcard characters:False