New-SCOMMaintenanceSchedule

模块:

OperationsManager

创建维护计划。

语法

New-SCOMMaintenanceSchedule
   [-Name] <String>
   [-Recursive]
   [-Enabled]
   [-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>]

说明

New-SCOMMaintenanceSchedule cmdlet 创建维护计划。

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

可以使用此 cmdlet 创建在特定日期或一周中的某一天运行一次、每天、每周或每月运行一次的计划。 此 cmdlet 将返回所创建计划的 GUID。

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

示例

示例 1：将 Windows 计算机对象添加到新的维护计划

PS C:\>$windowsComputer = Get-SCOMClass -DisplayName "Windows Computer" | Get-SCOMClassInstance | Where-Object { $_.DisplayName -eq 'Agent01.contoso.local' }
PS C:\>New-SCOMMaintenanceSchedule -Name 'Test Maintenance Schedule' -MonitoringObjects $windowsComputer.Id -ActiveStartTime $((Get-Date).AddMinutes(2)) -DurationInMinutes 240 -ReasonCode PlannedOther -FreqType 1 -Enabled

显示如何为特定服务器添加 Windows 计算机对象的示例： Agent01.contoso.com 新的维护计划，持续时间为 240 分钟，仅运行 1 次。

示例 2：创建每日维护计划

PS C:\>$monitoringObjects = Get-SCOMClassInstance -Name 'Agent01.contoso.local'
PS C:\># Timezone is UTC (Coordinated Universal Time)
PS C:\>$startDate = [DateTime]::SpecifyKind([DateTime]"2024-03-30T01:00:00", [System.DateTimeKind]::Utc)
PS C:\>$durationInMinutes = 90
PS C:\>
PS C:\>New-SCOMMaintenanceSchedule -Name "Daily Maintenance at 1AM" -MonitoringObjects $monitoringObjects.Id -ActiveStartTime $startDate -Duration $durationInMinutes -ReasonCode PlannedOther -FreqType 4 -FreqInterval 1 -Enabled

显示如何为特定服务器和关联的监视对象设置每日维护计划的示例： Agent01.contoso.local，从凌晨 1：00 开始，持续 90 分钟。

示例 3：创建每周维护计划

PS C:\>$monitoringObjects = Get-SCOMClassInstance -Name 'Agent01.contoso.local'
PS C:\># Timezone is set to local timezone
PS C:\>$startDate = [DateTime]"2024-03-29T02:00:00"
PS C:\>$durationInMinutes = 120
PS C:\>
PS C:\>New-SCOMMaintenanceSchedule -Name "Weekly Wednesday Maintenance" -MonitoringObjects $monitoringObjects.Id -ActiveStartTime $startDate -Duration $durationInMinutes -ReasonCode PlannedOther -FreqType 8 -FreqInterval 8 -FreqRecurrenceFactor 1 -Enabled

显示如何为特定服务器和关联的监视对象（从凌晨 2：00 开始，持续 120 分钟）配置每周维护计划的示例： Agent01.contoso.local。

示例 4：创建每月维护计划

PS C:\>$monitoringObjects = Get-SCOMClassInstance -Name 'Agent01.contoso.local'
PS C:\># Timezone is set to local timezone
PS C:\>$startDate = [DateTime]"2024-04-01T03:00:00"
PS C:\>$durationInMinutes = 180
PS C:\>
PS C:\>New-SCOMMaintenanceSchedule -Name "Monthly Second Tuesday Maintenance" -MonitoringObjects $monitoringObjects.Id -ActiveStartTime $startDate -Duration $durationInMinutes -ReasonCode PlannedOther -FreqType 32 -FreqInterval 2 -FreqRelativeInterval 2 -FreqRecurrenceFactor 1 -Enabled

示例显示如何为每个月的第二个星期二为特定服务器和关联的监视对象（ Agent01.contoso.local）建立每月维护计划，从凌晨 3：00 开始，持续 180 分钟。

参数

-ActiveEndDate

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

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

Type:	DateTime
Position:	5
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 时间，则需要指定 DateTime 对象，并将 DateTimeKind 设置为 UTC。

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

-Comments

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

Type:	String
Position:	8
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
Aliases:	DurationInMinutes
Position:	6
Default value:	None
Required:	True
Accept pipeline input:	False
Accept wildcard characters:	False

-Enabled

指示在创建计划时是启用还是禁用计划。 如果将其设置为 false，则会创建计划，但将被禁用。

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

-FreqInterval

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

• 1 (一次) 。 频率间隔未使用。
• 每天 4 () 。 每个频率间隔天数。
• 每周) 8 (。 FreqInterval 参数是以下一个或多个 (与 OR 逻辑运算符) 组合在一起：
  
  • 1 - 星期日
    
  • “2”- 星期一
    
  • 4 - 星期二
    
  • 8 - 星期三
    
  • 16 - 星期四
    
  • 32 - 星期五
    
  • 64 - 星期六
    
• 16 (每月) 。 在频率间隔月份的第二天。
  
  • 1 - 星期日
    
  • “2”- 星期一
    
  • 3 - 星期二
    
  • “4”- 星期三
    
  • 5 - 星期四
    
  • 6 - 星期五
    
  • 7 - 星期六
    
• 32 (每月相对) 。 FreqInterval 参数是以下值之一：
  
  • 8 - 天
    
  • 9 - 工作日
    
  • 10 - 周末
    

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

-FreqRecurrenceFactor

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

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

-FreqRelativeInterval

执行作业的日期。 如果计划不是 OnceRecurrence 计划，则这是必需的。 该值取决于 FreqType 的值。

此参数可能是以下值之一：

• 1 (第一个)
• 2 (Second)
• 4 (第三)
• 8 (第四)
• 16 (最后)

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

-FreqType

指定何时执行作业。 此参数的可接受值为：

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

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

-MonitoringObjects

指定将置于维护模式的监视对象 GUIDS 的数组。 若要指定创建的计划将置于维护模式的监视对象，必须传递监视对象的 ID 属性。

可以为计划指定一个或多个监视对象。 但是，不能在没有任何监视对象的情况下创建计划。

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

-Name

指定此 cmdlet 创建的计划的名称。

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

-ReasonCode

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

此参数的可接受值为：

• PlannedOther
• UnplannedOther
• PlannedHardwareMaintenance
• UnplannedHardwareMaintenance
• PlannedHardwareInstallation
• UnplannedHardwareInstallation
• PlannedOperatingSystemReconfiguration
• UnplannedOperatingSystemReconfiguration
• PlannedApplicationMaintenance
• UnplannedApplicationMaintenance
• ApplicationInstallation
• ApplicationUnresponsive
• ApplicationUnstable
• SecurityIssue
• LossOfNetworkConnectivity

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

-Recursive

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

Type:	SwitchParameter
Position:	1
Default value:	None
Required:	False
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

相关链接

• Disable-SCOMMaintenanceSchedule
• Edit-SCOMMaintenanceSchedule
• Enable-SCOMMaintenanceSchedule
• Get-SCOMMaintenanceSchedule
• Remove-SCOMMaintenanceSchedule
• Stop-SCOMMaintenanceSchedule
• Update-SCOMMaintenanceSchedule
• Get-SCOMManagementGroup