Set-CMAutoDeploymentRuleDeployment
设置自动部署规则的部署。
语法
Set-CMAutoDeploymentRuleDeployment
[-AlertTime <Int32>]
[-AlertTimeUnit <TimeUnitType>]
[-AllowDownloadFromMicrosoftUpdate <Boolean>]
[-AllowRestart <Boolean>]
[-AllowSoftwareInstallationOutsideMaintenanceWindow <Boolean>]
[-AllowUseMeteredNetwork <Boolean>]
[-AvailableImmediately <Boolean>]
[-AvailableTime <Int32>]
[-AvailableTimeUnit <TimeUnitType>]
[-Collection <IResultObject>]
[-CollectionId <String>]
[-CollectionName <String>]
[-DeadlineImmediately <Boolean>]
[-DeadlineTime <Int32>]
[-DeadlineTimeUnit <TimeUnitType>]
[-DisableOperationsManager <Boolean>]
[-EnableDeployment <Boolean>]
[-GenerateOperationsManagerAlert <Boolean>]
[-GenerateSuccessAlert <Boolean>]
[-InputObject] <IResultObject>
[-NoInstallOnRemote <Boolean>]
[-NoInstallOnUnprotected <Boolean>]
[-PassThru]
[-RequirePostRebootFullScan <Boolean>]
[-SendWakeupPacket <Boolean>]
[-SoftDeadlineEnabled <Boolean>]
[-SuccessPercentage <Int32>]
[-SuppressRestartServer <Boolean>]
[-SuppressRestartWorkstation <Boolean>]
[-UseBranchCache <Boolean>]
[-UserNotification <UserNotificationOption>]
[-UseUtc <Boolean>]
[-VerboseLevel <VerboseLevelType>]
[-WriteFilterHandling <Boolean>]
[-DisableWildcardHandling]
[-ForceWildcardHandling]
[-WhatIf]
[-Confirm]
[<CommonParameters>] Set-CMAutoDeploymentRuleDeployment
[-AlertTime <Int32>]
[-AlertTimeUnit <TimeUnitType>]
[-AllowDownloadFromMicrosoftUpdate <Boolean>]
[-AllowRestart <Boolean>]
[-AllowSoftwareInstallationOutsideMaintenanceWindow <Boolean>]
[-AllowUseMeteredNetwork <Boolean>]
[-AvailableImmediately <Boolean>]
[-AvailableTime <Int32>]
[-AvailableTimeUnit <TimeUnitType>]
[-Collection <IResultObject>]
[-CollectionId <String>]
[-CollectionName <String>]
[-DeadlineImmediately <Boolean>]
[-DeadlineTime <Int32>]
[-DeadlineTimeUnit <TimeUnitType>]
[-DisableOperationsManager <Boolean>]
[-EnableDeployment <Boolean>]
[-GenerateOperationsManagerAlert <Boolean>]
[-GenerateSuccessAlert <Boolean>]
[-Id] <Int32>
[-NoInstallOnRemote <Boolean>]
[-NoInstallOnUnprotected <Boolean>]
[-PassThru]
[-RequirePostRebootFullScan <Boolean>]
[-SendWakeupPacket <Boolean>]
[-SoftDeadlineEnabled <Boolean>]
[-SuccessPercentage <Int32>]
[-SuppressRestartServer <Boolean>]
[-SuppressRestartWorkstation <Boolean>]
[-UseBranchCache <Boolean>]
[-UserNotification <UserNotificationOption>]
[-UseUtc <Boolean>]
[-VerboseLevel <VerboseLevelType>]
[-WriteFilterHandling <Boolean>]
[-DisableWildcardHandling]
[-ForceWildcardHandling]
[-WhatIf]
[-Confirm]
[<CommonParameters>] 说明
Set-CMAutoDeploymentRuleDeployment cmdlet 更新自动部署规则的部署。
注意
从 Configuration Manager 站点驱动器运行 Configuration Manager cmdlet，例如 PS XYZ:\>。 有关详细信息，请参阅 入门。
示例
示例 1：按 ID 设置部署
PS XYZ:\> Set-CMAutoDeploymentRuleDeployment -ID 348 -CollectionName "All Systems" -EnableDeployment $True -SendWakeupPacket $False -VerboseLevel OnlySuccessAndErrorMessages -UseUtc $False -AvailableTime 7 -AvailableTimeUnit Days -DeadlineTime 7 -DeadlineTimeUnit Days -UserNotification DisplaySoftwareCenterOnly -AllowSoftwareInstallationOutsideMaintenanceWindow $False -AllowRestart $False -SuppressRestartServer $False -SuppressRestartWorkstation $False -WriteFilterHandling $False -GenerateSuccessAlert $True -SuccessPercentage 10 -AlertTime 7 -AlertTimeUnit Days -DisableOperationsManager $False -GenerateOperationsManagerAlert $False -NoInstallOnRemote $False -NoInstallOnUnprotected $False -UseBranchCache $False此命令使用操作 ID 348 和名为“所有系统”的集合更新部署规则部署的设置。
示例 2：使用变量设置部署
PS XYZ:\> $ReferenceADR = Get-CMAutoDeploymentRule -Name "TestADR01"
PS XYZ:\> $Deployment = $ReferenceADR | Get-CMAutoDeploymentRuleDeployment
PS XYZ:\> Set-CMAutoDeploymentRuleDeployment -InputObject $Deployment[0] -CollectionName "All Systems" -EnableDeployment $True -SendWakeupPacket $False -VerboseLevel OnlySuccessAndErrorMessages -UseUtc $False -AvailableTime 7 -AvailableTimeUnit Days -DeadlineTime 7 -DeadlineTimeUnit Days -UserNotification DisplaySoftwareCenterOnly -AllowSoftwareInstallationOutsideMaintenanceWindow $False -AllowRestart $False -SuppressRestartServer $False -SuppressRestartWorkstation $False -WriteFilterHandling $False -GenerateSuccessAlert $True -SuccessPercentage 10 -AlertTime 7 -AlertTimeUnit Days -DisableOperationsManager $False -GenerateOperationsManagerAlert $False -NoInstallOnRemote $False -NoInstallOnUnprotected $False -UseBranchCache $False第一个命令获取名为 TestADR01 的自动部署规则对象，并将对象存储在 $ReferenceADR 变量中。
第二个命令获取与存储在 $ReferenceADR 中的自动部署规则对象关联的部署，并将部署存储在 $Deployment 变量中。
最后一个命令更新存储在 $Deployment 中的第一个部署的设置。
参数
-AlertTime
指定与截止时间相距的时间单位数。
| 类型: | Int32 |
| Position: | Named |
| 默认值: | None |
| 必需: | False |
| 接受管道输入: | False |
| 接受通配符: | False |
-AlertTimeUnit
指定与截止时间的偏移量的时间单位类型。 有效值包含:
- 小时
- 天
- 星期
- 月
| 类型: | TimeUnitType |
| 接受的值: | Hours, Days, Weeks, Months |
| Position: | Named |
| 默认值: | None |
| 必需: | False |
| 接受管道输入: | False |
| 接受通配符: | False |
-AllowDownloadFromMicrosoftUpdate
使用此参数可在 ADR 部署 设置的“下载设置” 页上设置以下选项： 如果软件更新在当前、相邻或站点边界组中的分发点上不可用，请从Microsoft更新下载内容。
| 类型: | Boolean |
| Position: | Named |
| 默认值: | None |
| 必需: | False |
| 接受管道输入: | False |
| 接受通配符: | False |
-AllowRestart
指示在达到安装截止时间时，是否允许在任何定义的维护时段外执行系统重启。
| 类型: | Boolean |
| Position: | Named |
| 默认值: | None |
| 必需: | False |
| 接受管道输入: | False |
| 接受通配符: | False |
-AllowSoftwareInstallationOutsideMaintenanceWindow
指示在达到安装截止时间时，是否允许在任何定义的维护时段外执行软件安装。
| 类型: | Boolean |
| Position: | Named |
| 默认值: | None |
| 必需: | False |
| 接受管道输入: | False |
| 接受通配符: | False |
-AllowUseMeteredNetwork
使用此参数可在 ADR 部署 设置的“下载设置” 页上设置以下选项： 允许按流量计费的 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 cmdlet。
| 类型: | IResultObject |
| Position: | Named |
| 默认值: | None |
| 必需: | False |
| 接受管道输入: | False |
| 接受通配符: | False |
-CollectionId
指定软件更新部署的目标集合的 ID。
| 类型: | String |
| Position: | Named |
| 默认值: | None |
| 必需: | False |
| 接受管道输入: | False |
| 接受通配符: | False |
-CollectionName
指定软件更新部署的目标集合的名称。
| 类型: | String |
| Position: | Named |
| 默认值: | None |
| 必需: | False |
| 接受管道输入: | 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 |
-DisableOperationsManager
指示在软件更新运行时是否禁用 Operations Manager 警报。
| 类型: | Boolean |
| 别名: | DisableOperationManager |
| Position: | Named |
| 默认值: | None |
| 必需: | False |
| 接受管道输入: | False |
| 接受通配符: | False |
-DisableWildcardHandling
此参数将通配符视为文本字符值。 不能将其与 ForceWildcardHandling 组合使用。
| 类型: | SwitchParameter |
| Position: | Named |
| 默认值: | None |
| 必需: | False |
| 接受管道输入: | False |
| 接受通配符: | False |
-EnableDeployment
指示是否在针对关联的软件组运行此规则后启用部署。 如果设置为 $False，则必须手动部署软件更新组。
| 类型: | Boolean |
| 别名: | Enable, EnabledAfterCreate, EnableAfterCreate |
| Position: | Named |
| 默认值: | None |
| 必需: | False |
| 接受管道输入: | False |
| 接受通配符: | False |
-ForceWildcardHandling
此参数处理通配符，并可能导致意外行为， (不建议) 。 不能将其与 DisableWildcardHandling 组合使用。
| 类型: | SwitchParameter |
| Position: | Named |
| 默认值: | None |
| 必需: | False |
| 接受管道输入: | False |
| 接受通配符: | False |
-GenerateOperationsManagerAlert
指示软件更新安装失败时是否生成 Operations Manager 警报。
| 类型: | Boolean |
| 别名: | GenerateOperationManagerAlert |
| Position: | Named |
| 默认值: | None |
| 必需: | False |
| 接受管道输入: | False |
| 接受通配符: | False |
-GenerateSuccessAlert
指示此规则成功运行时是否生成警报。
| 类型: | Boolean |
| Position: | Named |
| 默认值: | None |
| 必需: | False |
| 接受管道输入: | False |
| 接受通配符: | False |
-Id
指定自动部署规则部署的操作 ID。
| 类型: | Int32 |
| 别名: | ActionID |
| Position: | 0 |
| 默认值: | None |
| 必需: | True |
| 接受管道输入: | False |
| 接受通配符: | False |
-InputObject
指定自动部署规则对象。 若要获取自动部署规则对象，请使用 Get-CMSoftwareUpdateAutoDeploymentRule cmdlet。
| 类型: | IResultObject |
| 别名: | AutoDeploymentRuleDeployment |
| Position: | 0 |
| 默认值: | None |
| 必需: | True |
| 接受管道输入: | True |
| 接受通配符: | False |
-NoInstallOnRemote
指示当更新在任何远程分发点上不可用时，是否安装软件更新。
| 类型: | Boolean |
| Position: | Named |
| 默认值: | None |
| 必需: | False |
| 接受管道输入: | False |
| 接受通配符: | False |
-NoInstallOnUnprotected
指示当更新在任何未受保护的分发点上不可用时，是否安装软件更新。
| 类型: | Boolean |
| Position: | Named |
| 默认值: | None |
| 必需: | False |
| 接受管道输入: | False |
| 接受通配符: | False |
-PassThru
添加此参数可返回一个对象，该对象表示正在使用的项。 默认情况下，此 cmdlet 可能不会生成任何输出。
| 类型: | SwitchParameter |
| Position: | Named |
| 默认值: | None |
| 必需: | False |
| 接受管道输入: | False |
| 接受通配符: | False |
-RequirePostRebootFullScan
使用此参数可在 ADR 部署设置的 “用户体验 ”页上设置以下选项： 如果此部署中的任何更新需要系统重启，请在重启后运行更新部署评估周期。
| 类型: | Boolean |
| 别名: | RunEvaluationAfterRestart |
| Position: | Named |
| 默认值: | None |
| 必需: | False |
| 接受管道输入: | False |
| 接受通配符: | False |
-SendWakeupPacket
指示是否使用 LAN 唤醒来唤醒客户端进行所需的部署。
| 类型: | Boolean |
| 别名: | EnableWakeOnLan |
| Position: | Named |
| 默认值: | None |
| 必需: | False |
| 接受管道输入: | False |
| 接受通配符: | False |
-SoftDeadlineEnabled
使用此参数可在 ADR 部署设置的“ 部署计划 ”页上设置以下选项： 根据用户首选项延迟此部署的强制，最长为客户端设置中定义的宽限期。
| 类型: | Boolean |
| 别名: | DelayEnforcementAndUpToGracePeriod |
| Position: | Named |
| 默认值: | None |
| 必需: | False |
| 接受管道输入: | False |
| 接受通配符: | False |
-SuccessPercentage
以整数形式指定客户端符合性百分比。 当客户端符合性低于此百分比时，将生成警报。
| 类型: | Int32 |
| Position: | Named |
| 默认值: | None |
| 必需: | False |
| 接受管道输入: | False |
| 接受通配符: | False |
-SuppressRestartServer
指示当软件更新需要系统重启才能完成安装过程时，是否在服务器上禁止系统重启。
| 类型: | Boolean |
| Position: | Named |
| 默认值: | None |
| 必需: | False |
| 接受管道输入: | False |
| 接受通配符: | False |
-SuppressRestartWorkstation
指示当软件更新需要系统重启才能完成安装过程时，是否在工作站上禁止系统重启。
| 类型: | Boolean |
| Position: | Named |
| 默认值: | None |
| 必需: | False |
| 接受管道输入: | False |
| 接受通配符: | False |
-UseBranchCache
指示是否允许客户端与同一子网上的其他客户端共享内容。
| 类型: | Boolean |
| Position: | Named |
| 默认值: | None |
| 必需: | False |
| 接受管道输入: | False |
| 接受通配符: | False |
-UserNotification
指定用户视觉体验的通知行为。 有效值包含:
- DisplayAll
- DisplaySoftwareCenterOnly
- HideAll
| 类型: | UserNotificationOption |
| 接受的值: | DisplayAll, DisplaySoftwareCenterOnly, HideAll |
| Position: | Named |
| 默认值: | None |
| 必需: | False |
| 接受管道输入: | False |
| 接受通配符: | False |
-UseUtc
指示是否根据世界协调时 (UTC) 评估此部署的计划。
| 类型: | Boolean |
| Position: | Named |
| 默认值: | None |
| 必需: | False |
| 接受管道输入: | False |
| 接受通配符: | False |
-VerboseLevel
指定客户端针对此规则创建的部署报告多少状态详细信息。 有效值包含:
- OnlyErrorMessages
- OnlySuccessAndErrorMessages
- AllMessages
| 类型: | 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 |
输入
Microsoft.ConfigurationManagement.ManagementProvider.IResultObject
输出
IResultObject