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：使用其名称编辑计划的 System Center 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。

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

-ActiveStartTime

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

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

-Comments

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

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

-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

-Confirm

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

Type:	SwitchParameter
Aliases:	cf
Position:	Named
Default value:	False
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

-Duration

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

Type:	Int32
Position:	7
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-Enabled

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

Type:	Boolean
Position:	3
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	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 = 第---- 9 日 = 工作日---- 10 = 周末

Type:	Int32
Position:	11
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-FreqRecurrenceFactor

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

Type:	Int32
Position:	12
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-FreqRelativeInterval

指定 将 FreqType 参数设置为 32 (每月相对) 的计划。此参数可能是以下值之一：

1 (第一个)
2 (Second)
4 (第三)
8 (第四)
16 (上次)

Type:	Int32
Position:	13
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-FreqType

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

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

Type:	Int32
Position:	10
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-MonitoringObjects

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

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

Type:	Guid[]
Position:	4
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-Name

指定计划的名称。

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

-ReasonCode

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

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

-Recursive

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

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

-ScheduleId

指定此 cmdlet 编辑的计划 GUID。

Type:	Guid
Position:	0
Default value:	None
Required:	True
Accept pipeline input:	False
Accept wildcard characters:	False

-SCSession

指定 Connection 对象的数组。

Type:	Connection[]
Position:	Named
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

通过

Edit-SCOMMaintenanceSchedule

语法

说明

示例

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

2：使用其名称编辑计划的 System Center Operations Manager 维护模式

参数

-ActiveEndDate

-ActiveStartTime

-Comments

-ComputerName

-Confirm

-Credential

-Duration

-Enabled

-FreqInterval

-FreqRecurrenceFactor

-FreqRelativeInterval

-FreqType

-MonitoringObjects

-Name

-ReasonCode

-Recursive

-ScheduleId

-SCSession

-WhatIf

其他资源

通过

Edit-SCOMMaintenanceSchedule

语法

说明

示例

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

2：使用其名称编辑计划的 System Center Operations Manager 维护模式

参数

-ActiveEndDate

-ActiveStartTime

-Comments

-ComputerName

-Confirm

-Credential

-Duration

-Enabled

-FreqInterval

-FreqRecurrenceFactor

-FreqRelativeInterval

-FreqType

-MonitoringObjects

-Name

-ReasonCode

-Recursive

-ScheduleId

-SCSession

-WhatIf

相关链接

其他资源