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 之前进行确认。
| Type: | SwitchParameter |
| Aliases: | cf |
| Position: | Named |
| Default value: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-DisableWildcardHandling
此参数将通配符视为文字字符值。 不能将其与 ForceWildcardHandling 结合使用。
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-Force
强制运行命令，而不要求用户确认。
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-ForceWildcardHandling
此参数处理通配符，并且可能会导致意外行为 (不建议) 。 不能将其与 DisableWildcardHandling 结合使用。
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-Id
指定自动部署软件更新的规则的一组 ID。 此值为 部署规则对象的 AutoDeploymentID 属性。
| Type: | Int32 |
| Aliases: | AutoDeploymentId |
| Position: | 0 |
| Default value: | None |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-InputObject
指定软件更新自动更新部署规则对象。 若要获取部署规则对象，请使用 Get-CMSoftwareUpdateAutoDeploymentRule。
| Type: | IResultObject |
| Position: | 0 |
| Default value: | None |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-WhatIf
显示在 cmdlet 运行时发生的情况。 cmdlet 不运行。
| Type: | SwitchParameter |
| Aliases: | wi |
| Position: | Named |
| Default value: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-名称
指定自动部署软件更新的规则的名称。
| Type: | String |
| Position: | 0 |
| Default value: | None |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
输入
Microsoft.ConfigurationManagement.ManagementProvider.IResultObject
输出
System.Object