New-CMWindowsServicingPlan

模块:

ConfigurationManager

创建 Windows 10 维护服务计划。

语法

New-CMWindowsServicingPlan
   -Name <String>
   [-Description <String>]
   -CollectionName <String>
   [-Enable <Boolean>]
   [-SendWakeupPacket <Boolean>]
   [-VerboseLevel <VerboseLevelType>]
   [-Language <String[]>]
   [-Required <String[]>]
   [-Title <String[]>]
   [-RunType <RunType>]
   [-Schedule <IResultObject>]
   [-UseUtc <Boolean>]
   [-AvailableTime <Int32>]
   [-AvailableImmediately <Boolean>]
   [-AvailableTimeUnit <TimeUnitType>]
   [-DeadlineImmediately <Boolean>]
   [-DeadlineTime <Int32>]
   [-DeadlineTimeUnit <TimeUnitType>]
   [-UserNotification <UserNotificationType>]
   [-AllowSoftwareInstallationOutsideMaintenanceWindow <Boolean>]
   [-AllowRestart <Boolean>]
   [-SuppressRestartServer <Boolean>]
   [-SuppressRestartWorkstation <Boolean>]
   [-WriteFilterHandling <Boolean>]
   [-GenerateSuccessAlert <Boolean>]
   [-SuccessPercentage <Int32>]
   [-AlertTime <Int32>]
   [-AlertTimeUnit <TimeUnitType>]
   [-DisableOperationManager <Boolean>]
   [-GenerateOperationManagerAlert <Boolean>]
   [-NoInstallOnRemote <Boolean>]
   [-NoInstallOnUnprotected <Boolean>]
   [-UseBranchCache <Boolean>]
   [-DownloadFromMicrosoftUpdate <Boolean>]
   [-AllowUseMeteredNetwork <Boolean>]
   [-DeploymentPackage <IResultObject>]
   [-DownloadFromInternet <Boolean>]
   [-Location <String>]
   [-DeploymentRing <DeploymentRing>]
   [-UpdateDeploymentWaitDay <Int32>]
   [-LanguageSelection <String[]>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

New-CMWindowsServicingPlan
   -Name <String>
   [-Description <String>]
   -Collection <IResultObject>
   [-Enable <Boolean>]
   [-SendWakeupPacket <Boolean>]
   [-VerboseLevel <VerboseLevelType>]
   [-Language <String[]>]
   [-Required <String[]>]
   [-Title <String[]>]
   [-RunType <RunType>]
   [-Schedule <IResultObject>]
   [-UseUtc <Boolean>]
   [-AvailableTime <Int32>]
   [-AvailableImmediately <Boolean>]
   [-AvailableTimeUnit <TimeUnitType>]
   [-DeadlineImmediately <Boolean>]
   [-DeadlineTime <Int32>]
   [-DeadlineTimeUnit <TimeUnitType>]
   [-UserNotification <UserNotificationType>]
   [-AllowSoftwareInstallationOutsideMaintenanceWindow <Boolean>]
   [-AllowRestart <Boolean>]
   [-SuppressRestartServer <Boolean>]
   [-SuppressRestartWorkstation <Boolean>]
   [-WriteFilterHandling <Boolean>]
   [-GenerateSuccessAlert <Boolean>]
   [-SuccessPercentage <Int32>]
   [-AlertTime <Int32>]
   [-AlertTimeUnit <TimeUnitType>]
   [-DisableOperationManager <Boolean>]
   [-GenerateOperationManagerAlert <Boolean>]
   [-NoInstallOnRemote <Boolean>]
   [-NoInstallOnUnprotected <Boolean>]
   [-UseBranchCache <Boolean>]
   [-DownloadFromMicrosoftUpdate <Boolean>]
   [-AllowUseMeteredNetwork <Boolean>]
   [-DeploymentPackage <IResultObject>]
   [-DownloadFromInternet <Boolean>]
   [-Location <String>]
   [-DeploymentRing <DeploymentRing>]
   [-UpdateDeploymentWaitDay <Int32>]
   [-LanguageSelection <String[]>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

New-CMWindowsServicingPlan
   -Name <String>
   [-Description <String>]
   -CollectionId <String>
   [-Enable <Boolean>]
   [-SendWakeupPacket <Boolean>]
   [-VerboseLevel <VerboseLevelType>]
   [-Language <String[]>]
   [-Required <String[]>]
   [-Title <String[]>]
   [-RunType <RunType>]
   [-Schedule <IResultObject>]
   [-UseUtc <Boolean>]
   [-AvailableTime <Int32>]
   [-AvailableImmediately <Boolean>]
   [-AvailableTimeUnit <TimeUnitType>]
   [-DeadlineImmediately <Boolean>]
   [-DeadlineTime <Int32>]
   [-DeadlineTimeUnit <TimeUnitType>]
   [-UserNotification <UserNotificationType>]
   [-AllowSoftwareInstallationOutsideMaintenanceWindow <Boolean>]
   [-AllowRestart <Boolean>]
   [-SuppressRestartServer <Boolean>]
   [-SuppressRestartWorkstation <Boolean>]
   [-WriteFilterHandling <Boolean>]
   [-GenerateSuccessAlert <Boolean>]
   [-SuccessPercentage <Int32>]
   [-AlertTime <Int32>]
   [-AlertTimeUnit <TimeUnitType>]
   [-DisableOperationManager <Boolean>]
   [-GenerateOperationManagerAlert <Boolean>]
   [-NoInstallOnRemote <Boolean>]
   [-NoInstallOnUnprotected <Boolean>]
   [-UseBranchCache <Boolean>]
   [-DownloadFromMicrosoftUpdate <Boolean>]
   [-AllowUseMeteredNetwork <Boolean>]
   [-DeploymentPackage <IResultObject>]
   [-DownloadFromInternet <Boolean>]
   [-Location <String>]
   [-DeploymentRing <DeploymentRing>]
   [-UpdateDeploymentWaitDay <Int32>]
   [-LanguageSelection <String[]>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

说明

New-CMWindowsServicingPlan cmdlet 创建 Windows 10 维护服务计划。

注意

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

示例

示例 1：按集合 ID 创建服务计划

PS XYZ:\> $Lang = ("Japanese", "English", "French")
PS XYZ:\> $Required = (">=1", "<=100")
PS XYZ:\> $Title = ("Title1", "Title2", "Title3")
PS XYZ:\> New-CMWindowsServicingPlan -Name "Test01" -CollectionId MP40001A -Description "Servicing Plan description01" -SendWakeupPacket $False -VerboseLevel AllMessages -Language $Lang -Required $Required -Title $Title -RunType DoNotRunThisRuleAutomatically -UseUtc $True -AvailableImmediately $True -DeadlineImmediately $False -UserNotification DisplayAll -AllowSoftwareInstallationOutsideMaintenanceWindow $True -AllowRestart $True -SuppressRestartServer $True -SuppressRestartWorkstation $True -DeploymentPackage (Get-CMSoftwareUpdateDeploymentPackage -Name "SUDP01")

第一个命令创建语言列表，并将列表存储在 $Lang 变量中。

第二个命令创建搜索字符串列表，并将列表存储在 $Required 变量中。 此搜索字符串将查找至少一台计算机和最多 100 台计算机上所需的软件更新。

第三个命令创建软件更新标题列表，并将列表存储在 $Title 变量中。

最后一个命令获取名为 SUDP01 的软件更新部署包，然后为目标集合创建名为 Test 的 Windows 服务计划，其 ID MP40001A。 命令添加存储在 $Lang 中的升级筛选器语言、存储在 $Required 中所需的筛选器以及存储在 $Title 中的软件更新标题筛选器。

示例 2：按集合名称创建维护服务计划

PS XYZ:\> $LangSelect = ("Japanese", "English", "French", "German")
PS XYZ:\> New-CMWindowsServicingPlan -Name "Test02" -CollectionName "ColName02" -DeploymentPackage (Get-CMSoftwareUpdateDeploymentPackage -Name "SUP02") -WriteFilterHandling $True -GenerateSuccessAlert $True -SuccessPercentage $True -AlertTime 10 -AlertTimeUnit Days -DisableOperationManager $True -GenerateOperationManagerAlert $True -NoInstallOnRemote $True -NoInstallOnUnprotected $True -UseBranchCache $True -DownloadFromMicrosoftUpdate $True -AllowUseMeteredNetwork $True -DownloadFromInternet $True -Location "\\TestSevr\WSUSTemp" -DeploymentRing Cbb -UpdateDeploymentWaitDay 20 -LanguageSelection $LangSelect

第一个命令创建语言选择语言的列表，并将列表存储在 $LangSelect 变量中。

第二个命令获取名为 SUP02 的软件更新部署包，然后为名为 ColName02 的目标集合创建名为 Test02 的 Windows 服务计划。 命令添加存储在 $LangSelect 中的语言选择语言。

参数

-AlertTime

指定与更新部署截止时间相差的整数偏移量。 规则使用此值来指定规则何时生成警报。 使用 AlertTimeUnit 参数指定时间单位。

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

-AlertTimeUnit

指定 AlertTime 参数的时间单位。 有效值包含:

• 小时
• 天
• 星期
• 月

类型:	TimeUnitType
接受的值:	Hours, Days, Weeks, Months
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

-AllowRestart

指示在达到安装截止时间时，是否允许在任何定义的维护时段外执行系统重启。

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

-AllowSoftwareInstallationOutsideMaintenanceWindow

指示在达到安装截止时间时，是否允许在任何定义的维护时段外执行软件安装。

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

-AllowUseMeteredNetwork

指示是否允许客户端在截止时间后通过按流量计费的 Internet 连接下载内容，这可能会产生额外的费用。

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

-AvailableImmediately

指示在规则运行后是否可以尽快安装软件更新。

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

-AvailableTime

指定软件更新何时可用。

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

-AvailableTimeUnit

指定软件可用时间的时间单位类型。 有效值包含:

• 小时
• 天
• 星期
• 月

类型:	TimeUnitType
接受的值:	Hours, Days, Weeks, Months
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

-Collection

指定要用于维护计划的目标设备集合对象。 若要获取设备集合对象，请使用 Get-CMCollection 或 Get-CMDeviceCollection cmdlet。

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

-CollectionId

指定要用于维护计划的目标设备集合的 ID。

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

-CollectionName

指定要用于维护计划的目标设备集合的名称。

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

-Confirm

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

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

-DeadlineImmediately

指示在到达截止时间时是否尽快安装所需的软件更新。

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

-DeadlineTime

指定截止时间的时间单位数。

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

-DeadlineTimeUnit

指定截止时间的时间单位类型。 有效值包含:

• 小时
• 天
• 星期
• 月

类型:	TimeUnitType
接受的值:	Hours, Days, Weeks, Months
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

-DeploymentPackage

指定软件更新部署包。 若要获取软件更新部署包，请使用 Get-CMSoftwareUpdateDeploymentPackage cmdlet。

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

-DeploymentRing

指定服务计划应应用的 Windows 就绪状态。 有效值包含:

• CB
• 发布
• BusinessMainstream
• Cbb
• Ltsb

类型:	DeploymentRing
接受的值:	CB, Release, BusinessMainstream, Cbb, Ltsb
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

-Description

指定服务计划的说明。

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

-DisableOperationManager

指示是否在软件更新期间禁用 System Center Operations Manager 警报。

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

-DownloadFromInternet

指示是否从 Internet 下载软件更新。

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

-DownloadFromMicrosoftUpdate

指示如果软件更新在首选分发点或远程分发点上不可用，则计算机是否从 Microsoft Update 下载内容。

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

-Enable

指示是否启用维护服务计划。

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

-GenerateOperationManagerAlert

指示是否在软件更新期间生成 Operations Manager 警报。

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

-GenerateSuccessAlert

指示是否生成成功部署的警报。

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

-Language

指定用于筛选将添加到服务计划的软件升级的语言数组。

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

-LanguageSelection

将语言数组指定为字符串。 计算机除了下载非语言特定更新外，还下载指定语言提供的软件更新。

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

-Location

指定下载的更新所在的网络位置。

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

-Name

指定服务计划的名称。 名称必须是唯一的，有助于描述规则的目标，并从 Configuration Manager 站点中的其他人中识别它。

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

-NoInstallOnRemote

指示是否允许在远程系统上安装更新。 如果将值指定为 $True，如果客户端位于慢速或不可靠的网络边界内，或者当客户端对内容使用回退源位置时，Configuration Manager 不会安装软件更新。 如果指定值$False，则安装将继续。

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

-NoInstallOnUnprotected

指示是否允许在未受保护的系统上安装更新。 如果指定值$True，如果软件更新在任何首选分发点上都不可用，则 Configuration Manager 不会下载和安装软件更新。 如果指定值$False，则安装将继续。

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

-Required

指定用于筛选将添加到服务计划的软件升级的搜索字符串数组。

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

-RunType

指定运行更新的模式。 有效值包含:

• DoNotRunThisRuleAutomatically
• RunTheRuleAfterAnySoftwareUpdatePointSynchronization
• RunTheRuleOnSchedule

类型:	RunType
接受的值:	DoNotRunThisRuleAutomatically, RunTheRuleAfterAnySoftwareUpdatePointSynchronization, RunTheRuleOnSchedule
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

-Schedule

指定从部署可用时间) (截止时间。 若要创建计划，请使用 New-CMSchedule cmdlet。

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

-SendWakeupPacket

指示是否在部署开始前将唤醒数据包发送到计算机。 如果此值$True，则 Configuration Manager 会从睡眠状态唤醒计算机。 如果此值$False，则不会将计算机从睡眠状态唤醒。 要唤醒计算机，必须首先配置 LAN 唤醒。

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

-SuccessPercentage

将客户端符合性百分比指定为 0 到 99 的整数。 如果符合性低于此百分比，Configuration Manager 将生成可选警报。

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

-SuppressRestartServer

指示当软件更新需要系统重启才能完成安装过程时，是否在服务器上禁止系统重启。

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

-SuppressRestartWorkstation

指示当软件更新需要系统重启才能完成安装过程时，是否在工作站上禁止系统重启。

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

-Title

指定用于筛选将添加到服务计划的软件更新标题的搜索字符串数组。

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

-UpdateDeploymentWaitDay

指定在Microsoft发布新升级后在环境中部署之前等待的天数。

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

-UseBranchCache

指示是否使用分支缓存。 如果指定值$True，则客户端在同一子网上共享内容。

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

-UserNotification

指定用户视觉体验的通知行为。 有效值包含:

• DisplayAll
• DisplaySoftwareCenterOnly
• HideAll

类型:	UserNotificationType
接受的值:	DisplayAll, DisplaySoftwareCenterOnly, HideAll
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

-UseUtc

指示是否根据世界协调时 (UTC) 评估此部署的计划。

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

-VerboseLevel

指定希望客户端针对此规则创建的部署报告的详细信息级别。 有效值包含:

• AllMessages
• OnlyErrorMessages
• OnlySuccessAndErrorMessages

类型:	VerboseLevelType
接受的值:	OnlyErrorMessages, OnlySuccessAndErrorMessages, AllMessages
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

-WhatIf

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

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

-WriteFilterHandling

指示更改是在截止时间还是维护时段内提交， (需要重启) 。 如果设置为 $False，则会在覆盖层上应用内容，并在以后提交。

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

输入

None

输出

System.Object

相关链接

• Get-CMCollection
• Get-CMDeviceCollection
• Get-CMSoftwareUpdateDeploymentPackage
• Get-CMWindowsServicingPlan