New-CMAutoDeploymentRuleDeployment

参考

模块:: ConfigurationManager

为自动部署规则创建部署。

语法

New-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>]
   [-Name] <String>
   [-NoInstallOnRemote <Boolean>]
   [-NoInstallOnUnprotected <Boolean>]
   [-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>]

New-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>]
   [-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>]

New-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>]
   [-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>]

说明

New-CMAutoDeploymentRuleDeployment cmdlet 为自动部署规则创建部署， (ADR) 。

注意

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

示例

示例 1：按名称为自动部署规则创建部署

此命令为自动部署规则 TestDepRule01 和 All Systems 集合创建部署。

New-CMAutoDeploymentRuleDeployment -Name "TestDepRule01" -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

示例 2：按对象创建自动部署规则的部署

此命令获取名为 TestDepRule02 的自动部署规则对象。然后，它使用管道运算符将对象传递给 New-CMAutoDeploymentRuleDeployment，这将为自动部署规则 TestDepRule02 和 All Systems 集合创建部署。

Get-CMAutoDeploymentRule -Name "TestDepRule02" | New-CMAutoDeploymentRuleDeployment -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

参数

-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
别名:	AutoDeploymentID
Position:	0
默认值:	None
必需:	True
接受管道输入:	False
接受通配符:	False

-InputObject

指定要将此部署添加到的自动部署规则对象。若要获取自动部署规则对象，请使用 Get-CMSoftwareUpdateAutoDeploymentRule cmdlet。

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

-Name

指定要将此部署添加到的自动部署规则的名称。

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

-NoInstallOnRemote

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

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

-NoInstallOnUnprotected

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

类型:	Boolean
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

指定用户视觉体验的通知行为。

类型:	UserNotificationOption
接受的值:	DisplayAll, DisplaySoftwareCenterOnly, HideAll
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

-UseUtc

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

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

-VerboseLevel

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

类型:	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

通过