Set-CMSoftwareUpdateDeployment
修改软件更新部署。
语法
Set-CMSoftwareUpdateDeployment
[-AlertDateTime <DateTime>]
[-AllowRestart <Boolean>]
[-AllowUseMeteredNetwork <Boolean>]
[-AvailableDateTime <DateTime>]
[-DeploymentExpireDateTime <DateTime>]
[-DeploymentName <String>]
[-DeploymentType <DeploymentType>]
[-Description <String>]
[-DisableOperationsManagerAlert <Boolean>]
[-DownloadFromMicrosoftUpdate <Boolean>]
[-Enable <Boolean>]
[-GenerateOperationsManagerAlert <Boolean>]
[-GenerateSuccessAlert <Boolean>]
-InputObject <IResultObject>
[-NewDeploymentName <String>]
[-PercentSuccess <Int32>]
[-PersistOnWriteFilterDevice <Boolean>]
[-ProtectedType <ProtectedType>]
[-RequirePostRebootFullScan <Boolean>]
[-RestartServer <Boolean>]
[-RestartWorkstation <Boolean>]
[-SendWakeupPacket <Boolean>]
[-SoftDeadlineEnabled <Boolean>]
[-SoftwareInstallation <Boolean>]
[-TimeBasedOn <TimeType>]
[-UnprotectedType <UnprotectedType>]
[-UseBranchCache <Boolean>]
[-UserNotification <UserNotificationType>]
[-VerbosityLevel <VerbosityLevelType>]
[-PassThru]
[-Collection <IResultObject>]
[-CollectionId <String>]
[-CollectionName <String>]
[-DisableWildcardHandling]
[-ForceWildcardHandling]
[-WhatIf]
[-Confirm]
[<CommonParameters>] Set-CMSoftwareUpdateDeployment
[-AlertDateTime <DateTime>]
[-AllowRestart <Boolean>]
[-AllowUseMeteredNetwork <Boolean>]
[-AvailableDateTime <DateTime>]
[-DeploymentExpireDateTime <DateTime>]
[-DeploymentName <String>]
[-DeploymentType <DeploymentType>]
[-Description <String>]
[-DisableOperationsManagerAlert <Boolean>]
[-DownloadFromMicrosoftUpdate <Boolean>]
[-Enable <Boolean>]
[-GenerateOperationsManagerAlert <Boolean>]
[-GenerateSuccessAlert <Boolean>]
[-NewDeploymentName <String>]
[-PercentSuccess <Int32>]
[-PersistOnWriteFilterDevice <Boolean>]
[-ProtectedType <ProtectedType>]
[-RequirePostRebootFullScan <Boolean>]
[-RestartServer <Boolean>]
[-RestartWorkstation <Boolean>]
[-SendWakeupPacket <Boolean>]
[-SoftDeadlineEnabled <Boolean>]
[-SoftwareInstallation <Boolean>]
-SoftwareUpdateGroupId <String>
[-TimeBasedOn <TimeType>]
[-UnprotectedType <UnprotectedType>]
[-UseBranchCache <Boolean>]
[-UserNotification <UserNotificationType>]
[-VerbosityLevel <VerbosityLevelType>]
[-PassThru]
[-Collection <IResultObject>]
[-CollectionId <String>]
[-CollectionName <String>]
[-DisableWildcardHandling]
[-ForceWildcardHandling]
[-WhatIf]
[-Confirm]
[<CommonParameters>] Set-CMSoftwareUpdateDeployment
[-AlertDateTime <DateTime>]
[-AllowRestart <Boolean>]
[-AllowUseMeteredNetwork <Boolean>]
[-AvailableDateTime <DateTime>]
[-DeploymentExpireDateTime <DateTime>]
[-DeploymentName <String>]
[-DeploymentType <DeploymentType>]
[-Description <String>]
[-DisableOperationsManagerAlert <Boolean>]
[-DownloadFromMicrosoftUpdate <Boolean>]
[-Enable <Boolean>]
[-GenerateOperationsManagerAlert <Boolean>]
[-GenerateSuccessAlert <Boolean>]
[-NewDeploymentName <String>]
[-PercentSuccess <Int32>]
[-PersistOnWriteFilterDevice <Boolean>]
[-ProtectedType <ProtectedType>]
[-RequirePostRebootFullScan <Boolean>]
[-RestartServer <Boolean>]
[-RestartWorkstation <Boolean>]
[-SendWakeupPacket <Boolean>]
[-SoftDeadlineEnabled <Boolean>]
[-SoftwareInstallation <Boolean>]
-SoftwareUpdateGroupName <String>
[-TimeBasedOn <TimeType>]
[-UnprotectedType <UnprotectedType>]
[-UseBranchCache <Boolean>]
[-UserNotification <UserNotificationType>]
[-VerbosityLevel <VerbosityLevelType>]
[-PassThru]
[-Collection <IResultObject>]
[-CollectionId <String>]
[-CollectionName <String>]
[-DisableWildcardHandling]
[-ForceWildcardHandling]
[-WhatIf]
[-Confirm]
[<CommonParameters>] Set-CMSoftwareUpdateDeployment
[-AlertDateTime <DateTime>]
[-AllowRestart <Boolean>]
[-AllowUseMeteredNetwork <Boolean>]
[-AvailableDateTime <DateTime>]
[-DeploymentExpireDateTime <DateTime>]
[-DeploymentName <String>]
[-DeploymentType <DeploymentType>]
[-Description <String>]
[-DisableOperationsManagerAlert <Boolean>]
[-DownloadFromMicrosoftUpdate <Boolean>]
[-Enable <Boolean>]
[-GenerateOperationsManagerAlert <Boolean>]
[-GenerateSuccessAlert <Boolean>]
[-NewDeploymentName <String>]
[-PercentSuccess <Int32>]
[-PersistOnWriteFilterDevice <Boolean>]
[-ProtectedType <ProtectedType>]
[-RequirePostRebootFullScan <Boolean>]
[-RestartServer <Boolean>]
[-RestartWorkstation <Boolean>]
[-SendWakeupPacket <Boolean>]
[-SoftDeadlineEnabled <Boolean>]
[-SoftwareInstallation <Boolean>]
-SoftwareUpdateId <String>
[-TimeBasedOn <TimeType>]
[-UnprotectedType <UnprotectedType>]
[-UseBranchCache <Boolean>]
[-UserNotification <UserNotificationType>]
[-VerbosityLevel <VerbosityLevelType>]
[-PassThru]
[-Collection <IResultObject>]
[-CollectionId <String>]
[-CollectionName <String>]
[-DisableWildcardHandling]
[-ForceWildcardHandling]
[-WhatIf]
[-Confirm]
[<CommonParameters>] Set-CMSoftwareUpdateDeployment
[-AlertDateTime <DateTime>]
[-AllowRestart <Boolean>]
[-AllowUseMeteredNetwork <Boolean>]
[-AvailableDateTime <DateTime>]
[-DeploymentExpireDateTime <DateTime>]
[-DeploymentName <String>]
[-DeploymentType <DeploymentType>]
[-Description <String>]
[-DisableOperationsManagerAlert <Boolean>]
[-DownloadFromMicrosoftUpdate <Boolean>]
[-Enable <Boolean>]
[-GenerateOperationsManagerAlert <Boolean>]
[-GenerateSuccessAlert <Boolean>]
[-NewDeploymentName <String>]
[-PercentSuccess <Int32>]
[-PersistOnWriteFilterDevice <Boolean>]
[-ProtectedType <ProtectedType>]
[-RequirePostRebootFullScan <Boolean>]
[-RestartServer <Boolean>]
[-RestartWorkstation <Boolean>]
[-SendWakeupPacket <Boolean>]
[-SoftDeadlineEnabled <Boolean>]
[-SoftwareInstallation <Boolean>]
-SoftwareUpdateName <String>
[-TimeBasedOn <TimeType>]
[-UnprotectedType <UnprotectedType>]
[-UseBranchCache <Boolean>]
[-UserNotification <UserNotificationType>]
[-VerbosityLevel <VerbosityLevelType>]
[-PassThru]
[-Collection <IResultObject>]
[-CollectionId <String>]
[-CollectionName <String>]
[-DisableWildcardHandling]
[-ForceWildcardHandling]
[-WhatIf]
[-Confirm]
[<CommonParameters>] 说明
使用此 cmdlet 在 Configuration Manager 中修改软件更新的部署。
有关详细信息，请参阅 在 Configuration Manager 中部署软件更新。
注意
从 Configuration Manager 站点驱动器运行 Configuration Manager cmdlet，例如 PS XYZ:\>。 有关详细信息，请参阅 入门。
示例
示例 1：设置具有过期时间的部署
此命令使用软件更新名称和过期时间设置软件更新部署。
Set-CMSoftwareUpdateDeployment -SoftwareUpdateName "CT" -DeploymentName "Contoso-test1" -NewDeploymentName "Contoso-test5" -Description "Contoso-test5-deployment" -CollectionName "All Mobile Devices" -SendWakeUpPacket $False -VerbosityLevel OnlySuccessAndErrorMessages -TimeBasedOn LocalTime -DeploymentAvailableDay 2013/11/24 -DeploymentAvailableTime 13:26 -DeploymentExpireDay 2014/7/22 -DeploymentExpireTime 4:30 -UserNotification DisplayAll -SoftwareInstallation $False -AllowRestart $False -RestartServer $False -RestartWorkstation $False -PersistOnWriteFilterDevice $True -GenerateSuccessAlert $False -PercentSuccess 99 -DisableOperationsManagerAlert $False -GenerateOperationsManagerAlert $False -ProtectedType NoInstall -UnprotectedType UnprotectedDistributionPoint -UseBranchCache $True -DownloadFromMicrosoftUpdate $False -AllowUseMeteredNetwork $False示例 2：在没有过期时间的情况下启动部署
此命令使用软件更新名称设置软件更新部署，但没有指定的过期时间。
Set-CMSoftwareUpdateDeployment -SoftwareUpdateName "CT" -DeploymentName "Contoso-test2" -NewDeploymentName "Contoso-test6" -Description "Contoso-test6-deployment" -CollectionName "All Mobile Devices" -VerbosityLevel OnlyErrorMessages -TimeBasedOn LocalTime -DeploymentAvailableDay 2013/12/24 -DeploymentAvailableTime 3:56 -UserNotification DisplaySoftwareCenterOnly -PersistOnWriteFilterDevice $True -DisableOperationsManagerAlert $False -GenerateOperationsManagerAlert $False -ProtectedType NoInstall -UnprotectedType UnprotectedDistributionPoint -UseBranchCache $True -DownloadFromMicrosoftUpdate $False -AllowUseMeteredNetwork $False示例 3：按软件更新组名称和过期时间启动部署
此命令使用软件更新组名称和过期时间设置软件更新部署。
Set-CMSoftwareUpdateDeployment -SoftwareUpdateGroupName "CTG" -DeploymentName "Contoso-test3" -NewDeploymentName "Contoso-test7" -Description "Contoso-test7-deployment" -CollectionName "All Mobile Devices" -SendWakeUpPacket $False -VerbosityLevel OnlySuccessAndErrorMessages -TimeBasedOn LocalTime -DeploymentAvailableDay 2013/11/24 -DeploymentAvailableTime 13:26 -DeploymentExpireDay 2014/7/22 -DeploymentExpireTime 4:30 -UserNotification DisplayAll -SoftwareInstallation $False -AllowRestart $False -RestartServer $False -RestartWorkstation $False -PersistOnWriteFilterDevice $True -GenerateSuccessAlert $False -PercentSuccess 99 -DisableOperationsManagerAlert $False -GenerateOperationsManagerAlert $False -ProtectedType NoInstall -UnprotectedType UnprotectedDistributionPoint -UseBranchCache $True -DownloadFromMicrosoftUpdate $False -AllowUseMeteredNetwork $False示例 4：按软件更新组名称启动部署
此命令使用软件更新组名称（但未指定过期时间）启动软件更新部署。
Set-CMSoftwareUpdateDeployment -SoftwareUpdateGroupName "CTG" -DeploymentName "Contoso-test4" -NewDeploymentName "Contoso-test8" -Description "Contoso-test8-deployment" -CollectionName "All Mobile Devices" -VerbosityLevel OnlyErrorMessages -TimeBasedOn LocalTime -DeploymentAvailableDay 2013/12/24 -DeploymentAvailableTime 3:56 -UserNotification DisplaySoftwareCenterOnly -PersistOnWriteFilterDevice $True -DisableOperationsManagerAlert $False -GenerateOperationsManagerAlert $False -ProtectedType NoInstall -UnprotectedType UnprotectedDistributionPoint -UseBranchCache $True -DownloadFromMicrosoftUpdate $False -AllowUseMeteredNetwork $False参数
-AlertDateTime
如果 -GenerateSuccessAlert 为 $true，请指定生成警报的时间。
| 类型: | DateTime |
| Position: | Named |
| 默认值: | None |
| 必需: | False |
| 接受管道输入: | False |
| 接受通配符: | False |
-AllowRestart
指示是否允许在安装后重启。
| 类型: | Boolean |
| Position: | Named |
| 默认值: | None |
| 必需: | False |
| 接受管道输入: | False |
| 接受通配符: | False |
-AllowUseMeteredNetwork
指示是否允许客户端使用按流量计费的网络下载更新。
| 类型: | 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 |
-Confirm
提示你在运行 cmdlet 之前进行确认。
| 类型: | SwitchParameter |
| 别名: | cf |
| Position: | Named |
| 默认值: | False |
| 必需: | False |
| 接受管道输入: | False |
| 接受通配符: | False |
-DeploymentExpireDateTime
指定部署的过期时间。
| 类型: | DateTime |
| Position: | Named |
| 默认值: | None |
| 必需: | False |
| 接受管道输入: | False |
| 接受通配符: | False |
-DeploymentName
在 Configuration Manager 中指定软件更新部署的名称。
| 类型: | String |
| Position: | Named |
| 默认值: | None |
| 必需: | False |
| 接受管道输入: | False |
| 接受通配符: | False |
-DeploymentType
指定此部署是否可供用户安装，或者是否是指定截止时间计划所需的安装。
| 类型: | DeploymentType |
| 接受的值: | Required, Available |
| Position: | Named |
| 默认值: | None |
| 必需: | False |
| 接受管道输入: | False |
| 接受通配符: | False |
-Description
指定软件更新部署的说明。
| 类型: | String |
| 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 |
-DownloadFromMicrosoftUpdate
指示客户端是否直接从 Microsoft 更新下载更新。
| 类型: | Boolean |
| Position: | Named |
| 默认值: | None |
| 必需: | False |
| 接受管道输入: | False |
| 接受通配符: | False |
-Enable
指示是否启用此部署。
| 类型: | 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, DeploymentSummary, SoftwareUpdateGroup, Assignment |
| Position: | Named |
| 默认值: | None |
| 必需: | True |
| 接受管道输入: | True |
| 接受通配符: | False |
-NewDeploymentName
重命名此软件更新部署。
| 类型: | String |
| Position: | Named |
| 默认值: | None |
| 必需: | False |
| 接受管道输入: | False |
| 接受通配符: | False |
-PassThru
返回一个 对象，该对象表示正在使用的项。 默认情况下，此 cmdlet 可能不会生成任何输出。
| 类型: | SwitchParameter |
| Position: | Named |
| 默认值: | None |
| 必需: | False |
| 接受管道输入: | False |
| 接受通配符: | 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
指示是否需要重启才能完成更新安装，是否取消服务器重启。
-
$true：取消重启 -
$false：允许服务器重启
| 类型: | Boolean |
| Position: | Named |
| 默认值: | None |
| 必需: | False |
| 接受管道输入: | False |
| 接受通配符: | False |
-RestartWorkstation
指示是否需要重启才能完成更新安装，是否禁止重启工作站。
-
$true：取消重启 -
$false：允许服务器重启
| 类型: | Boolean |
| Position: | Named |
| 默认值: | None |
| 必需: | False |
| 接受管道输入: | False |
| 接受通配符: | False |
-SendWakeupPacket
指示是否在部署开始前将唤醒数据包发送到计算机。
-
$True：Configuration Manager 将计算机从睡眠状态唤醒。 -
$False：它不会将计算机从睡眠状态唤醒。
对于要唤醒的计算机，请先 在 LAN 上配置唤醒。
| 类型: | Boolean |
| Position: | Named |
| 默认值: | None |
| 必需: | False |
| 接受管道输入: | False |
| 接受通配符: | False |
-SoftDeadlineEnabled
将此参数设置为 以 $true 根据用户首选项延迟此部署的执行，最长为客户端设置中定义的宽限期。
| 类型: | Boolean |
| 别名: | DelayEnforcementAndUpToGracePeriod |
| Position: | Named |
| 默认值: | None |
| 必需: | False |
| 接受管道输入: | False |
| 接受通配符: | False |
-SoftwareInstallation
指示是否允许安装软件更新，即使安装发生在维护时段之外也是如此。
| 类型: | 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
在 Configuration Manager 中指定软件更新的 ID。
| 类型: | String |
| Position: | Named |
| 默认值: | None |
| 必需: | True |
| 接受管道输入: | False |
| 接受通配符: | False |
-SoftwareUpdateName
在 Configuration Manager 中指定软件更新的名称。
| 类型: | String |
| Position: | Named |
| 默认值: | None |
| 必需: | True |
| 接受管道输入: | False |
| 接受通配符: | False |
-TimeBasedOn
指定客户端计算机使用本地时间或 UTC 时间来确定程序的可用性。 UTC 时间使软件更新同时可供所有计算机使用。
| 类型: | TimeType |
| 接受的值: | LocalTime, Utc |
| 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 |
-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 |
| 默认值: | False |
| 必需: | False |
| 接受管道输入: | False |
| 接受通配符: | False |
输入
Microsoft.ConfigurationManagement.ManagementProvider.IResultObject
输出
System.Object