New-CMMaintenanceWindow

模块:

ConfigurationManager

为集合创建维护时段。

语法

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 则为默认值。

Type:	MaintenanceWindowApplyTo
Accepted values:	Any, SoftwareUpdatesOnly, TaskSequencesOnly
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-ApplyToSoftwareUpdateOnly

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

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

-ApplyToTaskSequenceOnly

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

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

-CollectionId

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

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

-CollectionName

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

Type:	String
Position:	0
Default value:	None
Required:	True
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

-DisableWildcardHandling

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

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

-ForceWildcardHandling

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

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

-InputObject

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

Type:	IResultObject
Aliases:	Collection, Site
Position:	0
Default value:	None
Required:	True
Accept pipeline input:	True
Accept wildcard characters:	False

-IsEnabled

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

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

-IsUtc

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

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

-Name

指定维护时段的名称。

Type:	String
Aliases:	MaintenanceWindowName
Position:	Named
Default value:	None
Required:	True
Accept pipeline input:	False
Accept wildcard characters:	False

-Schedule

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

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

Type:	IResultObject
Position:	Named
Default value:	None
Required:	True
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

输入

Microsoft.ConfigurationManagement.ManagementProvider.IResultObject

输出

IResultObject

备注

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

相关链接

• Get-CMMaintenanceWindow
• Remove-CMMaintenanceWindow
• Set-CMMaintenanceWindow
• Convert-CMSchedule
• New-CMSchedule
• 如何在 Configuration Manager 中使用维护时段