New-CMMaintenanceWindow

为集合创建维护时段。

语法

New-CMMaintenanceWindow
   [-ApplyTo <MaintenanceWindowApplyTo>]
   [-ApplyToSoftwareUpdateOnly]
   [-ApplyToTaskSequenceOnly]
   [-InputObject] <IResultObject>
   [-IsEnabled <Boolean>]
   [-IsUtc <Boolean>]
   -Name <String>
   -Schedule <IResultObject>
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]
New-CMMaintenanceWindow
   [-ApplyTo <MaintenanceWindowApplyTo>]
   [-ApplyToSoftwareUpdateOnly]
   [-ApplyToTaskSequenceOnly]
   [-CollectionId] <String>
   [-IsEnabled <Boolean>]
   [-IsUtc <Boolean>]
   -Name <String>
   -Schedule <IResultObject>
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]
New-CMMaintenanceWindow
   [-ApplyTo <MaintenanceWindowApplyTo>]
   [-ApplyToSoftwareUpdateOnly]
   [-ApplyToTaskSequenceOnly]
   [-CollectionName] <String>
   [-IsEnabled <Boolean>]
   [-IsUtc <Boolean>]
   -Name <String>
   -Schedule <IResultObject>
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

说明

使用此 cmdlet 为集合创建维护时段。 维护时段是 Configuration Manager 客户端可以运行任务的定期时间段。 例如,应用软件更新或安装软件。 此窗口可确保仅在不影响工作效率和运行时间的时间发生重大系统更改。

有关维护时段的详细信息,请参阅 如何在 Configuration Manager 中使用维护时段

注意

从 Configuration Manager 站点驱动器运行 Configuration Manager cmdlet,例如 PS XYZ:\>。 有关详细信息,请参阅 入门

示例

示例 1:创建维护时段

第一个命令使用 New-CMSchedule cmdlet 创建计划对象,然后将其存储在 变量中 $MWSchedule

第二个命令为指定的集合创建名为 MonthlySchedule 的维护时段。 维护时段使用变量中 $MWSchedule 存储的计划。

$MWSchedule = New-CMSchedule -DayOfWeek Friday -DurationCount 1 -DurationInterval Hours -RecurCount 1 -Start "10/12/2013 21:00:00"
New-CMMaintenanceWindow -CollectionId "XYZ0005D" -Name "MonthlySchedule" -Schedule $MWSchedule

示例 2:在集合之间复制维护时段

第一个命令从 ID 为 XYZ0003F 的集合获取维护时段。 然后,它会在集合上创建一个维护时段,其 ID XYZ0005D 具有相同的名称、相同的计划,并且仅适用于软件更新。

$mw1 = Get-CMMaintenanceWindow -CollectionId "XYZ0003F" -MaintenanceWindowName "nightly SUM window"
New-CMMaintenanceWindow -CollectionId "XYZ0005D" -Name $mw1.Name -Schedule (Convert-CMSchedule -ScheduleString $mw1.ServiceWindowSchedules) -ApplyTo SoftwareUpdatesOnly

参数

-ApplyTo

指定要创建的维护时段的类型:

  • Any:维护时段适用于所有部署。
  • SoftwareUpdatesOnly:维护时段仅适用于软件更新部署。
  • TaskSequencesOnly:维护时段仅适用于任务序列部署。

如果未指定此参数, Any 则为默认值。

类型:MaintenanceWindowApplyTo
接受的值:Any, SoftwareUpdatesOnly, TaskSequencesOnly
Position:Named
默认值:None
必需:False
接受管道输入:False
接受通配符:False

-ApplyToSoftwareUpdateOnly

此参数已弃用。 将 ApplyTo 参数与 SoftwareUpdatesOnly 值一起使用。

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

-ApplyToTaskSequenceOnly

此参数已弃用。 将 ApplyTo 参数与 TaskSequencesOnly 值一起使用。

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

-CollectionId

指定要添加维护时段的集合的 ID。 此 ID 是标准集合 ID,例如 XYZ0003F

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

-CollectionName

指定要添加维护时段的集合的名称。

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

-Confirm

添加此参数以在运行 cmdlet 之前提示确认。

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

-DisableWildcardHandling

此参数将通配符视为文本字符值。 不能将其与 ForceWildcardHandling 组合使用。

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

-ForceWildcardHandling

此参数处理通配符,并可能导致意外行为, (不建议) 。 不能将其与 DisableWildcardHandling 组合使用。

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

-InputObject

为集合指定对象以添加维护时段。 若要获取此对象,请使用 Get-CMCollection cmdlet。

类型:IResultObject
别名:Collection, Site
Position:0
默认值:None
必需:True
接受管道输入:True
接受通配符:False

-IsEnabled

若要在集合上创建维护时段,但不使其处于活动状态,请将此参数设置为 $false。 如果未包含此参数,则此 cmdlet 将启用维护时段。

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

-IsUtc

若要将维护时段计划配置为使用协调世界时 (UTC) ,请将此参数设置为 $true。 如果未包含此参数,则计划将使用本地时间。

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

-Name

指定维护时段的名称。

类型:String
别名:MaintenanceWindowName
Position:Named
默认值:None
必需:True
接受管道输入:False
接受通配符:False

-Schedule

指定用于何时发生维护时段的计划对象。 若要获取此对象,请使用 New-CMSchedule cmdlet。

维护时段对象将计划存储为令牌字符串。 若要从另一个对象复制计划,请使用 Convert-CMSchedule cmdlet。 例如,Convert-CMSchedule -ScheduleString $mw1.ServiceWindowSchedules

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

-WhatIf

显示在 cmdlet 运行时发生的情况。 cmdlet 不会运行。

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

输入

Microsoft.ConfigurationManagement.ManagementProvider.IResultObject

输出

IResultObject

备注

有关此返回对象及其属性的详细信息,请参阅 SMS_ServiceWindow服务器 WMI 类