New-CMWindowsServicingPlan

创建 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-CMCollectionGet-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