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 类。