New-CMSoftwareUpdateDeployment

创建软件更新部署。

语法

New-CMSoftwareUpdateDeployment
   [-AcceptEula]
   [-AllowRestart <Boolean>]
   [-DeploymentName <String>]
   [-DeploymentType <DeploymentType>]
   [-Comment <String>]
   [-DisableOperationsManagerAlert <Boolean>]
   [-DownloadFromMicrosoftUpdate <Boolean>]
   [-GenerateOperationsManagerAlert <Boolean>]
   [-GenerateSuccessAlert <Boolean>]
   -InputObject <IResultObject>
   [-PercentSuccess <Int32>]
   [-ProtectedType <ProtectedType>]
   [-DeployWithNoPackage <Boolean>]
   [-RequirePostRebootFullScan <Boolean>]
   [-RestartServer <Boolean>]
   [-RestartWorkstation <Boolean>]
   [-SavedPackageId <String>]
   [-SoftDeadlineEnabled <Boolean>]
   [-SoftwareInstallation <Boolean>]
   [-TimeBasedOn <TimeType>]
   [-TimeUnit <TimeUnitType>]
   [-TimeValue <Int32>]
   [-UnprotectedType <UnprotectedType>]
   [-UseBranchCache <Boolean>]
   [-UserNotification <UserNotificationType>]
   [-VerbosityLevel <VerbosityLevelType>]
   [-DistributeCollectionName <String>]
   [-DistributeContent]
   [-DistributionPointGroupName <String>]
   [-DistributionPointName <String>]
   [-AvailableDateTime <DateTime>]
   [-DeadlineDateTime <DateTime>]
   [-PersistOnWriteFilterDevice <Boolean>]
   [-SendWakeupPacket <Boolean>]
   [-UseMeteredNetwork <Boolean>]
   [-Collection <IResultObject>]
   [-CollectionId <String>]
   [-CollectionName <String>]
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]
New-CMSoftwareUpdateDeployment
   [-AcceptEula]
   [-AllowRestart <Boolean>]
   [-DeploymentName <String>]
   [-DeploymentType <DeploymentType>]
   [-Comment <String>]
   [-DisableOperationsManagerAlert <Boolean>]
   [-DownloadFromMicrosoftUpdate <Boolean>]
   [-GenerateOperationsManagerAlert <Boolean>]
   [-GenerateSuccessAlert <Boolean>]
   [-PercentSuccess <Int32>]
   [-ProtectedType <ProtectedType>]
   [-DeployWithNoPackage <Boolean>]
   [-RequirePostRebootFullScan <Boolean>]
   [-RestartServer <Boolean>]
   [-RestartWorkstation <Boolean>]
   [-SavedPackageId <String>]
   [-SoftDeadlineEnabled <Boolean>]
   [-SoftwareInstallation <Boolean>]
   -SoftwareUpdateGroupId <String>
   [-TimeBasedOn <TimeType>]
   [-TimeUnit <TimeUnitType>]
   [-TimeValue <Int32>]
   [-UnprotectedType <UnprotectedType>]
   [-UseBranchCache <Boolean>]
   [-UserNotification <UserNotificationType>]
   [-VerbosityLevel <VerbosityLevelType>]
   [-DistributeCollectionName <String>]
   [-DistributeContent]
   [-DistributionPointGroupName <String>]
   [-DistributionPointName <String>]
   [-AvailableDateTime <DateTime>]
   [-DeadlineDateTime <DateTime>]
   [-PersistOnWriteFilterDevice <Boolean>]
   [-SendWakeupPacket <Boolean>]
   [-UseMeteredNetwork <Boolean>]
   [-Collection <IResultObject>]
   [-CollectionId <String>]
   [-CollectionName <String>]
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]
New-CMSoftwareUpdateDeployment
   [-AcceptEula]
   [-AllowRestart <Boolean>]
   [-DeploymentName <String>]
   [-DeploymentType <DeploymentType>]
   [-Comment <String>]
   [-DisableOperationsManagerAlert <Boolean>]
   [-DownloadFromMicrosoftUpdate <Boolean>]
   [-GenerateOperationsManagerAlert <Boolean>]
   [-GenerateSuccessAlert <Boolean>]
   [-PercentSuccess <Int32>]
   [-ProtectedType <ProtectedType>]
   [-DeployWithNoPackage <Boolean>]
   [-RequirePostRebootFullScan <Boolean>]
   [-RestartServer <Boolean>]
   [-RestartWorkstation <Boolean>]
   [-SavedPackageId <String>]
   [-SoftDeadlineEnabled <Boolean>]
   [-SoftwareInstallation <Boolean>]
   -SoftwareUpdateGroupName <String>
   [-TimeBasedOn <TimeType>]
   [-TimeUnit <TimeUnitType>]
   [-TimeValue <Int32>]
   [-UnprotectedType <UnprotectedType>]
   [-UseBranchCache <Boolean>]
   [-UserNotification <UserNotificationType>]
   [-VerbosityLevel <VerbosityLevelType>]
   [-DistributeCollectionName <String>]
   [-DistributeContent]
   [-DistributionPointGroupName <String>]
   [-DistributionPointName <String>]
   [-AvailableDateTime <DateTime>]
   [-DeadlineDateTime <DateTime>]
   [-PersistOnWriteFilterDevice <Boolean>]
   [-SendWakeupPacket <Boolean>]
   [-UseMeteredNetwork <Boolean>]
   [-Collection <IResultObject>]
   [-CollectionId <String>]
   [-CollectionName <String>]
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]
New-CMSoftwareUpdateDeployment
   [-AcceptEula]
   [-AllowRestart <Boolean>]
   [-DeploymentName <String>]
   [-DeploymentType <DeploymentType>]
   [-Comment <String>]
   [-DisableOperationsManagerAlert <Boolean>]
   [-DownloadFromMicrosoftUpdate <Boolean>]
   [-GenerateOperationsManagerAlert <Boolean>]
   [-GenerateSuccessAlert <Boolean>]
   [-PercentSuccess <Int32>]
   [-ProtectedType <ProtectedType>]
   [-DeployWithNoPackage <Boolean>]
   [-RequirePostRebootFullScan <Boolean>]
   [-RestartServer <Boolean>]
   [-RestartWorkstation <Boolean>]
   [-SavedPackageId <String>]
   [-SoftDeadlineEnabled <Boolean>]
   [-SoftwareInstallation <Boolean>]
   -SoftwareUpdateId <String>
   [-TimeBasedOn <TimeType>]
   [-TimeUnit <TimeUnitType>]
   [-TimeValue <Int32>]
   [-UnprotectedType <UnprotectedType>]
   [-UseBranchCache <Boolean>]
   [-UserNotification <UserNotificationType>]
   [-VerbosityLevel <VerbosityLevelType>]
   [-DistributeCollectionName <String>]
   [-DistributeContent]
   [-DistributionPointGroupName <String>]
   [-DistributionPointName <String>]
   [-AvailableDateTime <DateTime>]
   [-DeadlineDateTime <DateTime>]
   [-PersistOnWriteFilterDevice <Boolean>]
   [-SendWakeupPacket <Boolean>]
   [-UseMeteredNetwork <Boolean>]
   [-Collection <IResultObject>]
   [-CollectionId <String>]
   [-CollectionName <String>]
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]
New-CMSoftwareUpdateDeployment
   [-AcceptEula]
   [-AllowRestart <Boolean>]
   [-DeploymentName <String>]
   [-DeploymentType <DeploymentType>]
   [-Comment <String>]
   [-DisableOperationsManagerAlert <Boolean>]
   [-DownloadFromMicrosoftUpdate <Boolean>]
   [-GenerateOperationsManagerAlert <Boolean>]
   [-GenerateSuccessAlert <Boolean>]
   [-PercentSuccess <Int32>]
   [-ProtectedType <ProtectedType>]
   [-DeployWithNoPackage <Boolean>]
   [-RequirePostRebootFullScan <Boolean>]
   [-RestartServer <Boolean>]
   [-RestartWorkstation <Boolean>]
   [-SavedPackageId <String>]
   [-SoftDeadlineEnabled <Boolean>]
   [-SoftwareInstallation <Boolean>]
   -SoftwareUpdateName <String>
   [-TimeBasedOn <TimeType>]
   [-TimeUnit <TimeUnitType>]
   [-TimeValue <Int32>]
   [-UnprotectedType <UnprotectedType>]
   [-UseBranchCache <Boolean>]
   [-UserNotification <UserNotificationType>]
   [-VerbosityLevel <VerbosityLevelType>]
   [-DistributeCollectionName <String>]
   [-DistributeContent]
   [-DistributionPointGroupName <String>]
   [-DistributionPointName <String>]
   [-AvailableDateTime <DateTime>]
   [-DeadlineDateTime <DateTime>]
   [-PersistOnWriteFilterDevice <Boolean>]
   [-SendWakeupPacket <Boolean>]
   [-UseMeteredNetwork <Boolean>]
   [-Collection <IResultObject>]
   [-CollectionId <String>]
   [-CollectionName <String>]
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

说明

使用此 cmdlet 将软件更新部署到目标集合。

注意

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

示例

示例 1

New-CMSoftwareUpdateDeployment -DeploymentName "updates deployment" -SoftwareUpdateGroupName "software update group" -CollectionName "Desktop clients for SUM" -Description "a more detailed description of this deployment" -DeploymentType Required -VerbosityLevel AllMessages -AvailableDateTime "2020/08/25 02:00AM" -DeadlineDateTime "2020/08/26 02:00AM" -UserNotification DisplaySoftwareCenterOnly -SoftwareInstallation $True  -AllowRestart $True  -RestartServer $False -RestartWorkstation $False -PersistOnWriteFilterDevice $True -RequirePostRebootFullScan $True -ProtectedType RemoteDistributionPoint

参数

-AcceptEula

某些软件更新包括许可条款。 部署软件更新时,不会显示许可条款。 添加此参数可自动部署所有软件更新,而不考虑关联的许可期限。

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

-AllowRestart

达到安装截止时间时,将此参数设置为 以 $true 允许系统在维护时段外重新启动(如有必要)。

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

-AvailableDateTime

指定软件更新何时可用。

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

-Collection

在 Configuration Manager 中指定部署将面向的集合对象。 使用 Get-CMCollection cmdlet 获取此对象。

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

-CollectionId

指定集合 ID 作为此软件更新部署的目标。

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

-CollectionName

指定集合名称作为此软件更新部署的目标。

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

-Comment

为软件更新部署指定可选说明。

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

-Confirm

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

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

-DeadlineDateTime

指定所需软件更新的安装截止时间。 达到截止时间后,客户端会在设备上安装所需的软件更新,并在必要时重启设备。

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

-DeploymentName

指定软件更新部署的名称。

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

-DeploymentType

指定此部署是否可供用户安装,或者是否是指定截止时间计划所需的安装。

类型:DeploymentType
接受的值:Required, Available
Position:Named
默认值:None
必需:False
接受管道输入:False
接受通配符:False

-DeployWithNoPackage

将此参数设置为 $true 以不使用部署包。 客户端从对等方或Microsoft云下载软件更新内容。

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

-DisableOperationsManagerAlert

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

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

-DisableWildcardHandling

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

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

-DistributeCollectionName

站点将内容分发到与此集合名称关联的分发点组。

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

-DistributeContent

添加此参数以在创建此部署时分发软件更新内容。 在将内容分发到客户端可以访问的分发点之前,客户端无法安装软件更新。

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

-DistributionPointGroupName

站点将内容分发到此分发点组。

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

-DistributionPointName

站点将内容分发到此分发点。

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

-DownloadFromMicrosoftUpdate

如果软件更新内容在当前、邻居或站点边界组中的分发点上不可用,请从Microsoft更新下载内容。

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

-ForceWildcardHandling

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

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

-GenerateOperationsManagerAlert

指示在软件安装失败时是否生成 Operations Manager 警报。

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

-GenerateSuccessAlert

如果部署符合性低于指定的阈值,则部署会在 Configuration Manager 控制台中生成警报。 默认阈值为 95%。 若要更改阈值,请使用 PercentSuccess 参数。

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

-InputObject

指定要部署的软件更新对象。

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

-PercentSuccess

如果将 -GenerateSuccessAlert 设置为 $true,请使用此参数指定站点生成 Configuration Manager 控制台警报的百分比符合性阈值。 如果未指定,则如果部署未在指定截止时间之前达到 95% 的符合性,则站点将生成警报。

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

-PersistOnWriteFilterDevice

指示是在临时覆盖上安装软件更新并稍后提交更改,还是在安装截止时间或维护时段提交更改。

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

-ProtectedType

指定客户端是否可以使用来自相邻边界组或默认站点边界组的分发点。

类型:ProtectedType
接受的值:NoInstall, RemoteDistributionPoint
Position:Named
默认值:None
必需:False
接受管道输入:False
接受通配符:False

-RequirePostRebootFullScan

此参数控制以下控制台选项: 重启时的软件更新部署重新评估行为。 如果将此选项设置为 $true,则在客户端从此部署安装更新时重启后,它们将运行完整的更新部署评估周期。

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

-RestartServer

指示是否允许服务器在软件更新后重启。

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

-RestartWorkstation

指示是否允许工作站在软件更新后重启。

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

-SavedPackageId

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

-SendWakeupPacket

指示是否在部署开始前将唤醒数据包发送到计算机。

  • $True:Configuration Manager 将计算机从睡眠状态唤醒。
  • $False:它不会将计算机从睡眠状态唤醒。

对于要唤醒的计算机,请先配置 LAN 唤醒。

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

-SoftDeadlineEnabled

使用此参数可在 ADR 部署设置的“ 部署计划 ”页上设置以下选项: 根据用户首选项延迟此部署的强制,最长为客户端设置中定义的宽限期

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

-SoftwareInstallation

达到安装截止时间时,将此参数设置为 $true 以允许在维护时段外安装软件更新。

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

-SoftwareUpdateGroupId

指定要部署的软件更新组的 ID。

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

-SoftwareUpdateGroupName

指定要部署的软件更新组的名称。

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

-SoftwareUpdateId

指定要部署的软件更新的 ID。

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

-SoftwareUpdateName

指定要部署的软件更新的名称。

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

-TimeBasedOn

指定客户端使用本地时间或 UTC 时间来确定部署的可用性。 UTC 时间使软件更新同时可供所有计算机使用。

类型:TimeType
接受的值:LocalTime, Utc
Position:Named
默认值:None
必需:False
接受管道输入:False
接受通配符:False

-TimeUnit

指定 -TimeValue 参数的值类型。

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

-TimeValue

指定时间的整数值。 使用 -TimeUnit 参数确定此值的时间类型。

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

-UnprotectedType

如果软件更新在当前或相邻边界组中的任何分发点上不可用,请指定客户端是否可以从站点默认边界组中的分发点下载和安装软件更新。

类型:UnprotectedType
接受的值:NoInstall, UnprotectedDistributionPoint
Position:Named
默认值:None
必需:False
接受管道输入:False
接受通配符:False

-UseBranchCache

指示是否使用 Windows BranchCache 下载软件更新内容。

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

-UseMeteredNetwork

指示是否允许客户端使用按流量计费的网络下载更新。

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

-UserNotification

指定用户通知体验。

  • DisplayAll:在软件中心显示并显示所有通知
  • DisplaySoftwareCenterOnly:在软件中心显示,并且仅显示计算机重启通知
  • HideAll:在软件中心和所有通知中隐藏
类型:UserNotificationType
接受的值:DisplayAll, DisplaySoftwareCenterOnly, HideAll
Position:Named
默认值:None
必需:False
接受管道输入:False
接受通配符:False

-VerbosityLevel

指定客户端为此软件更新部署返回的状态消息详细信息级别。

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

-WhatIf

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

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

输入

Microsoft.ConfigurationManagement.ManagementProvider.IResultObject

输出

System.Object