Remove-CMSoftwareUpdateAutoDeploymentRule
删除自动软件更新的 Configuration Manager 部署规则。
语法
Remove-CMSoftwareUpdateAutoDeploymentRule
[-Force]
[-Id] <Int32>
[-DisableWildcardHandling]
[-ForceWildcardHandling]
[-WhatIf]
[-Confirm]
[<CommonParameters>] Remove-CMSoftwareUpdateAutoDeploymentRule
[-Force]
[-InputObject] <IResultObject>
[-DisableWildcardHandling]
[-ForceWildcardHandling]
[-WhatIf]
[-Confirm]
[<CommonParameters>] Remove-CMSoftwareUpdateAutoDeploymentRule
[-Force]
[-Name] <String>
[-DisableWildcardHandling]
[-ForceWildcardHandling]
[-WhatIf]
[-Confirm]
[<CommonParameters>] 说明
Remove-CMSoftwareUpdateAutoDeploymentRule cmdlet 删除自动软件更新的指定 Configuration Manager 部署规则。
Configuration Manager 使用规则来管理软件更新的自动部署。 规则运行时，Configuration Manager 会将符合规则条件的更新添加到软件更新组。 Configuration Manager 服务器下载内容文件并将其复制到分发点，然后更新客户端计算机。
可以按 ID 或名称指定要删除的规则，或使用 Get-CMSoftwareUpdateAutoDeploymentRule cmdlet 指定规则对象。 此 cmdlet 永久删除规则。 可以使用 Disable-CMSoftwareUpdateAutoDeploymentRule cmdlet 暂停规则。
注意
从 Configuration Manager 站点驱动器运行 Configuration Manager cmdlet，例如 PS XYZ:\>。 有关详细信息，请参阅 入门。
示例
示例 1：按名称删除部署规则
PS XYZ:\> Remove-CMSoftwareUpdateAutoDeploymentRule -Name "Weekly Driver Updates"
Remove
Are you sure you wish to remove SoftwareUpdateAutoDeploymentRule: Name="Weekly Driver Updates"?
[Y] Yes [N] No [S] Suspend [?] Help (default is "Y"):此命令删除名为“每周驱动程序更新”的规则。 由于命令不包括 Force 参数，因此 cmdlet 会在删除规则之前提示你。
示例 2：按 ID 删除部署规则
PS XYZ:\> Remove-CMSoftwareUpdateAutoDeploymentRule -Id "16777217" -Force此命令禁用 ID 为16777217的部署规则。 此命令包含 Force 参数，因此 cmdlet 在删除规则之前不会提示你。
示例 3：使用变量删除部署规则
PS XYZ:\> $CMSUADR = Get-CMSoftwareUpdateAutoDeploymentRule -Name "Weekly Driver Updates"
PS XYZ:\> Remove-CMSoftwareUpdateAutoDeploymentRule -InputObject $CMSUADR -Force第一个命令获取具有指定名称的部署规则，然后将其存储在 $CMSUADR 变量中。
第二个命令删除变量中存储的规则。
参数
-Confirm
提示你在运行 cmdlet 之前进行确认。
| 类型: | SwitchParameter |
| 别名: | cf |
| Position: | Named |
| 默认值: | False |
| 必需: | False |
| 接受管道输入: | False |
| 接受通配符: | False |
-DisableWildcardHandling
此参数将通配符视为文本字符值。 不能将其与 ForceWildcardHandling 组合使用。
| 类型: | SwitchParameter |
| Position: | Named |
| 默认值: | None |
| 必需: | False |
| 接受管道输入: | False |
| 接受通配符: | False |
-Force
强制运行命令而不要求用户确认。
| 类型: | SwitchParameter |
| Position: | Named |
| 默认值: | None |
| 必需: | False |
| 接受管道输入: | False |
| 接受通配符: | False |
-ForceWildcardHandling
此参数处理通配符，并可能导致意外行为， (不建议) 。 不能将其与 DisableWildcardHandling 组合使用。
| 类型: | SwitchParameter |
| Position: | Named |
| 默认值: | None |
| 必需: | False |
| 接受管道输入: | False |
| 接受通配符: | False |
-Id
指定用于自动部署软件更新的规则的 ID 数组。 此值是部署规则对象的 AutoDeploymentID 属性。
| 类型: | Int32 |
| 别名: | AutoDeploymentId |
| Position: | 0 |
| 默认值: | None |
| 必需: | True |
| 接受管道输入: | False |
| 接受通配符: | False |
-InputObject
指定软件更新自动部署规则对象。 若要获取部署规则对象，请使用 Get-CMSoftwareUpdateAutoDeploymentRule。
| 类型: | IResultObject |
| Position: | 0 |
| 默认值: | None |
| 必需: | True |
| 接受管道输入: | True |
| 接受通配符: | False |
-Name
指定自动部署软件更新的规则的名称。
| 类型: | String |
| Position: | 0 |
| 默认值: | None |
| 必需: | True |
| 接受管道输入: | False |
| 接受通配符: | False |
-WhatIf
显示在 cmdlet 运行时发生的情况。 cmdlet 不会运行。
| 类型: | SwitchParameter |
| 别名: | wi |
| Position: | Named |
| 默认值: | False |
| 必需: | False |
| 接受管道输入: | False |
| 接受通配符: | False |
输入
Microsoft.ConfigurationManagement.ManagementProvider.IResultObject
输出
System.Object