Set-SCOMMaintenanceMode
汇报活动维护模式条目。
语法
Set-SCOMMaintenanceMode
[-MaintenanceModeEntry] <MaintenanceWindow[]>
[-PassThru]
[-EndTime] <DateTime>
[[-Comment] <String>]
[[-Reason] <MaintenanceModeReason>]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
说明
Set-SCOMMaintenanceMode cmdlet 更新活动维护模式条目。 可以使用此 cmdlet 仅更新活动条目。
当资源处于维护模式时,System Center - Operations Manager 会取消警报、通知、规则、监视器、自动响应、状态更改和新警报。
可以更改维护模式的注释或原因。 使用 Get-SCOMMaintenanceMode cmdlet 获取要更新的维护模式条目。 指定维护时段的结束时间。
示例
示例 1:更新域中资源的活动维护模式条目
PS C:\>$NewEndTime = (Get-Date).addDays(1)
PS C:\> Get-SCOMClassInstance -Name "*.Contoso.com" | Get-SCOMMaintenanceMode | Set-SCOMMaintenanceMode -EndTime $NewEndTime -Comment "Updating end time."
此示例更新指定域的所有活动维护模式条目。 第一个命令在将来的某一天创建 DateTime 对象,然后将其存储在 $NewEndTime 变量中。
第二个命令获取 Contoso.com 域中的所有类实例,并使用管道运算符 (|) 将类实例对象传递给 Get-SCOMMaintenanceMode cmdlet,后者获取维护模式条目对象。 命令使用管道运算符将这些对象传递给 Set-SCOMMaintenanceMode cmdlet。 此 cmdlet 将每个对象的结束时间更新为存储在 $NewEndTime 变量中的 DateTime 对象。 命令还包括每个更新的维护模式条目的注释。
示例 2:更新指定资源的维护模式条目
PS C:\>$Instance = Get-SCOMClassInstance -Name "Server01.Contoso.com"
PS C:\> $MMEntry = Get-SCOMMaintenanceMode -Instance $Instance
PS C:\> $NewEndTime = (Get-Date).addMinutes(30)
PS C:\> Set-SCOMMaintenanceMode -MaintenanceModeEntry $MMEntry -EndTime $NewEndTime -Comment "Adding 30 minutes to the end time."
此示例扩展指定服务器的维护模式。 第一个命令获取名为 Server01.Contoso.com 的类实例,然后将其存储在 $Instance 变量中。
第二个命令获取存储在 $Instance 变量中的类实例的维护模式条目,并将该项存储在 $MMEntry 变量中。
第三个命令在将来创建 30 分钟的 DateTime 对象,然后将其存储在 $NewEndTime 变量中。
第四个命令将存储在 $MMEntry 变量中的维护模式项的维护模式会话更新为存储在 $NewEndTime 变量中的 DateTime 对象,并添加注释。
参数
-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 |
-MaintenanceModeEntry
指定 MaintenanceWindow 对象的数组。 若要获取 MaintenanceWindow 对象,请使用 Get-SCOMMaintenanceMode cmdlet。
Type: | MaintenanceWindow[] |
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 |