Set-CMAutoDeploymentRuleDeployment

模块:

ConfigurationManager

设置自动部署规则的部署。

语法

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

指定与截止时间相距的时间单位数。

Type:	Int32
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-AlertTimeUnit

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

• 工作时间
• 天
• 星期
• 月

Type:	TimeUnitType
Accepted values:	Hours, Days, Weeks, Months
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-AllowDownloadFromMicrosoftUpdate

使用此参数可在 ADR 部署设置的“下载设置”页上设置以下选项：如果软件更新在当前、邻居或站点边界组中的分发点上不可用，请从 Microsoft 汇报下载内容。

Type:	Boolean
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-AllowRestart

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

Type:	Boolean
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-AllowSoftwareInstallationOutsideMaintenanceWindow

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

Type:	Boolean
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-AllowUseMeteredNetwork

使用此参数可在 ADR 部署 设置的“下载设置” 页上设置以下选项： 允许按流量计费的 Internet 连接上的客户端在安装截止时间后下载内容，这可能会产生额外成本

Type:	Boolean
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-AvailableImmediately

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

Type:	Boolean
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-AvailableTime

指定软件可用时间的时间单位数。

Type:	Int32
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-AvailableTimeUnit

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

• 工作时间
• 天
• 星期
• 月

Type:	TimeUnitType
Accepted values:	Hours, Days, Weeks, Months
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-Collection

指定软件更新部署的目标集合对象。 若要获取集合对象，请使用 Get-CMCollection cmdlet。

Type:	IResultObject
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-CollectionId

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

Type:	String
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-CollectionName

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

Type:	String
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-Confirm

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

Type:	SwitchParameter
Aliases:	cf
Position:	Named
Default value:	False
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-DeadlineImmediately

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

Type:	Boolean
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-DeadlineTime

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

Type:	Int32
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-DeadlineTimeUnit

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

• 工作时间
• 天
• 星期
• 月

Type:	TimeUnitType
Accepted values:	Hours, Days, Weeks, Months
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-DisableOperationsManager

指示在软件更新运行时是否禁用 Operations Manager 警报。

Type:	Boolean
Aliases:	DisableOperationManager
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-DisableWildcardHandling

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

Type:	SwitchParameter
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-EnableDeployment

指示是否在针对关联的软件组运行此规则后启用部署。 如果设置为 $False，则必须手动部署软件更新组。

Type:	Boolean
Aliases:	Enable, EnabledAfterCreate, EnableAfterCreate
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-ForceWildcardHandling

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

Type:	SwitchParameter
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-GenerateOperationsManagerAlert

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

Type:	Boolean
Aliases:	GenerateOperationManagerAlert
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-GenerateSuccessAlert

指示此规则成功运行时是否生成警报。

Type:	Boolean
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-Id

指定自动部署规则部署的操作 ID。

Type:	Int32
Aliases:	ActionID
Position:	0
Default value:	None
Required:	True
Accept pipeline input:	False
Accept wildcard characters:	False

-InputObject

指定自动部署规则对象。 若要获取自动部署规则对象，请使用 Get-CMSoftwareUpdateAutoDeploymentRule cmdlet。

Type:	IResultObject
Aliases:	AutoDeploymentRuleDeployment
Position:	0
Default value:	None
Required:	True
Accept pipeline input:	True
Accept wildcard characters:	False

-NoInstallOnRemote

指示当更新在任何远程分发点上不可用时，是否安装软件更新。

Type:	Boolean
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-NoInstallOnUnprotected

指示当更新在任何未受保护的分发点上不可用时，是否安装软件更新。

Type:	Boolean
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-PassThru

添加此参数可返回一个对象，该对象表示正在使用的项。 默认情况下，此 cmdlet 可能不会生成任何输出。

Type:	SwitchParameter
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-RequirePostRebootFullScan

使用此参数可在 ADR 部署设置的“ 用户体验 ”页上设置以下选项： 如果此部署中的任何更新需要系统重启，请在重启后运行更新部署评估周期。

Type:	Boolean
Aliases:	RunEvaluationAfterRestart
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-SendWakeupPacket

指示是否使用 LAN 唤醒来唤醒客户端进行所需的部署。

Type:	Boolean
Aliases:	EnableWakeOnLan
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-SoftDeadlineEnabled

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

Type:	Boolean
Aliases:	DelayEnforcementAndUpToGracePeriod
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-SuccessPercentage

以整数形式指定客户端符合性百分比。 当客户端符合性低于此百分比时，将生成警报。

Type:	Int32
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-SuppressRestartServer

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

Type:	Boolean
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-SuppressRestartWorkstation

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

Type:	Boolean
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-UseBranchCache

指示是否允许客户端与同一子网上的其他客户端共享内容。

Type:	Boolean
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-UserNotification

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

• DisplayAll
• DisplaySoftwareCenterOnly
• HideAll

Type:	UserNotificationOption
Accepted values:	DisplayAll, DisplaySoftwareCenterOnly, HideAll
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-UseUtc

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

Type:	Boolean
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-VerboseLevel

指定客户端针对此规则创建的部署报告多少状态详细信息。 有效值包含:

• OnlyErrorMessages
• OnlySuccessAndErrorMessages
• AllMessages

Type:	VerboseLevelType
Accepted values:	OnlyErrorMessages, OnlySuccessAndErrorMessages, AllMessages
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-WhatIf

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

Type:	SwitchParameter
Aliases:	wi
Position:	Named
Default value:	False
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-WriteFilterHandling

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

Type:	Boolean
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

输入

Microsoft.ConfigurationManagement.ManagementProvider.IResultObject

输出

IResultObject

相关链接

• Get-CMCollection
• Get-CMAutoDeploymentRuleDeployment
• Get-CMSoftwareUpdateAutoDeploymentRule
• New-CMAutoDeploymentRuleDeployment
• Remove-CMAutoDeploymentRuleDeployment