Edit-SCOMMaintenanceSchedule

模块:

OperationsManager

编辑现有的维护计划。

语法

Edit-SCOMMaintenanceSchedule
    [-ScheduleId] <Guid>
    [[-Name] <String>]
    [[-Recursive] <Boolean>]
    [[-Enabled] <Boolean>]
    [[-MonitoringObjects] <Guid[]>]
    [[-ActiveStartTime] <DateTime>]
    [[-ActiveEndDate] <DateTime>]
    [[-Duration] <Int32>]
    [[-ReasonCode] <MaintenanceModeReason>]
    [[-Comments] <String>]
    [[-FreqType] <Int32>]
    [[-FreqInterval] <Int32>]
    [[-FreqRecurrenceFactor] <Int32>]
    [[-FreqRelativeInterval] <Int32>]
    [-SCSession <Connection[]>]
    [-ComputerName <String[]>]
    [-Credential <PSCredential>]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

说明

Edit-SCOMMaintenanceSchedule cmdlet 编辑现有的维护计划。 但是，无法编辑当前处于活动状态的计划。

当资源处于维护模式时，Operations Manager 将取消警报、通知、规则、监视器、自动响应、状态更改和新警报。 维护计划可用于计划一组要进入维护模式的资源。

可以使用此 cmdlet 编辑计划，以在特定日期或一周中的某一天运行一次、每日、每周或每月一次。 必须传递要编辑的现有计划的 ScheduleId。 所有其他参数都是可选的;将覆盖指定的参数。

默认情况下，此 cmdlet 使用与管理组的活动持久连接。 使用 SCSession 参数指定不同的持久连接。 可以使用 ComputerName 和 Credential 参数创建与管理组的临时连接。 有关详细信息，请键入 Get-Help about_OpsMgr_Connections。

示例

1：编辑使用 ID 计划的 System Center Operations Manager 维护模式

PS C:\>Edit-SCOMMaintenanceSchedule -ScheduleId "32AAB279-3670-ED11-9626-00155D012405" -Enabled 1

使用 ID 32AAB279-3670-ED11-9626-00155D012405编辑维护模式计划。

2：使用系统中心 Operations Manager 维护模式的名称编辑计划

PS C:\>Edit-SCOMMaintenanceSchedule -Name "Test" -Enabled 1

使用名称编辑维护模式计划。

参数

-ActiveEndDate

指定计划停止时的结束日期和结束时间。 如果未指定此参数，则计划将继续运行，直到它被删除或禁用。

例如，如果要创建应在 2016 年 5 月 1 日上午 9：00 结束的计划，则必须将“01-05-2016 09：00：00”指定为 ActiveEndDate。 可以传递指定本地时间所需的时间的字符串。 但是，如果要指定 UTC 时间，则需要指定一个 DateTime 对象，并将 DateTimeKind 设置为 UTC。

类型:	DateTime
Position:	6
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

-ActiveStartTime

指定计划必须处于活动状态的开始日期和时间。 例如，如果希望计划从 2016 年 5 月 1 日开始，并且必须在上午 9：00 运行，则必须将“01-05-2016 09：00：00”指定为 ActiveStartTime。 可以传递指定本地时间所需的时间的字符串。 但是，如果要指定 UTC 时间，则需要使用 DateTimeKind 指定 DateTime 对象。

类型:	DateTime
Position:	5
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

-Comments

指定维护计划的任何人工可读注释。

类型:	String
Position:	9
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

-ComputerName

指定计算机名称数组。 该 cmdlet 与这些计算机的管理组建立临时连接。 可以使用 NetBIOS 名称、IP 地址或完全限定的域名（FQDN）。 若要指定本地计算机，请键入计算机名称、localhost 或点（.）。System Center Data Access 服务必须在计算机上处于活动状态。 如果未指定计算机，该 cmdlet 将使用计算机进行当前管理组连接。

类型:	String[]
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

-Confirm

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

类型:	SwitchParameter
别名:	cf
Position:	Named
默认值:	False
必需:	False
接受管道输入:	False
接受通配符:	False

-Credential

为管理组连接指定 PSCredential 对象。 若要获取 PSCredential 对象，请使用 Get-Credential cmdlet。 有关详细信息，请键入 Get-Help Get-Credential。如果在 ComputerName 参数中指定计算机，请使用有权访问该计算机的帐户。 默认值为当前用户。

类型:	PSCredential
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

-Duration

指定维护计划的持续时间。 维护计划的持续时间是维护计划每次将持续的时间。

类型:	Int32
Position:	7
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

-Enabled

指示在编辑时是启用或禁用计划。 如果将其设置为 false，将禁用计划。 还可以使用 Enable-SCOMMaintenanceSchedule 和 Disable-SCOMMaintenanceSchedule 执行此操作。

类型:	Boolean
Position:	3
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

-FreqInterval

指定运行作业的日期。 如果计划不是 OnceRecurrence 计划，则这是强制性的。 该值取决于 FreqType 的值，如以下列表所示：

• 1 （一次）。 未使用频率间隔。
• 4 （每日）。 每个频率间隔天数。
• 8 （每周）。 FreqInterval 参数是以下一个或多个参数（与 OR 逻辑运算符结合使用）：

---- 1 = 星期日 ---- 2 = 星期一 ---- 4 = 星期二 ---- 8 = 星期三 ---- 16 = 星期四 ---- 32 = 星期五 ---- 64 = 星期六

• 16 （每月）。 在月份的频率间隔日。
• 32 （每月相对）。 FreqInterval 参数是以下值之一：

---- 1 = 星期日 ---- 2 = 星期一 ---- 3 = 星期二 ---- 4 = 星期三 ---- 5 = 星期四 ---- 6 = 星期五 ---- 7 = 星期六 ---- 8 = Day ---- 9 = Weekday ---- 10 = 周末

类型:	Int32
Position:	11
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

-FreqRecurrenceFactor

作业的计划运行之间的周数或月数。 仅当 FreqType 参数设置为 8、16 或 32 时，才使用 FreqRecurrenceFactor。 FreqRecurrenceFactor 参数是一个整数，默认值为 0。

类型:	Int32
Position:	12
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

-FreqRelativeInterval

指定 FreqType 参数设置为 32（每月相对）。 此参数可以是以下值之一：

• 1 （第一）
• 2 （第二）
• 4 （第三）
• 8 （第四）
• 16 （最后）

类型:	Int32
Position:	13
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

-FreqType

指定何时执行作业。 此参数可以是以下值之一：

• 1 （一次）
• 4 （每日）
• 8 （每周）
• 16 （每月）
• 32 （每月，相对于参数 FreqInterval）。

类型:	Int32
Position:	10
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

-MonitoringObjects

指定表示此 cmdlet 置于维护模式的监视对象的 GUID 数组。 指定置于维护模式的监视对象 GUIDS 数组。 若要指定计划进入维护模式的监视对象，必须传递监视对象的 ID 属性。 如果要保留某些现有成员，还必须指定这些成员。

可以为计划指定一个或多个监视对象。 但是，不能编辑没有任何监视对象的计划。

类型:	Guid[]
Position:	4
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

-Name

指定计划的名称。

类型:	String
Position:	1
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

-ReasonCode

指定维护计划的原因代码，该代码指定维护时段的原因。

类型:	MaintenanceModeReason
接受的值:	PlannedOther, UnplannedOther, PlannedHardwareMaintenance, UnplannedHardwareMaintenance, PlannedHardwareInstallation, UnplannedHardwareInstallation, PlannedOperatingSystemReconfiguration, UnplannedOperatingSystemReconfiguration, PlannedApplicationMaintenance, UnplannedApplicationMaintenance, ApplicationInstallation, ApplicationUnresponsive, ApplicationUnstable, SecurityIssue, LossOfNetworkConnectivity
Position:	8
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

-Recursive

指示计划也适用于顶级资源或所有包含的资源。 如果将此参数设置为 false，则运行计划时，只有指定的资源才会进入维护模式。 如果设置为 true，则指定的资源和与此资源具有包含关系的所有资源也将进入维护模式。

类型:	Boolean
Position:	2
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

-ScheduleId

指定此 cmdlet 编辑的计划 GUID。

类型:	Guid
Position:	0
默认值:	None
必需:	True
接受管道输入:	False
接受通配符:	False

-SCSession

指定 连接 对象的数组。

类型:	Connection[]
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

-WhatIf

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

类型:	SwitchParameter
别名:	wi
Position:	Named
默认值:	False
必需:	False
接受管道输入:	False
接受通配符:	False

相关链接

• Disable-SCOMMaintenanceSchedule
• Enable-SCOMMaintenanceSchedule
• Get-SCOMMaintenanceSchedule
• New-SCOMMaintenanceSchedule
• Remove-SCOMMaintenanceSchedule
• Stop-SCOMMaintenanceSchedule
• Update-SCOMMaintenanceSchedule