Remove-CMBaseline
删除配置基线。
语法
Remove-CMBaseline
      [-Force]
      [-Id] <Int32>
      [-DisableWildcardHandling]
      [-ForceWildcardHandling]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]Remove-CMBaseline
      [-Force]
      [-InputObject] <IResultObject>
      [-DisableWildcardHandling]
      [-ForceWildcardHandling]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]Remove-CMBaseline
      [-Force]
      [-Name] <String>
      [-DisableWildcardHandling]
      [-ForceWildcardHandling]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]说明
使用此 cmdlet 删除配置基线。 在删除配置基线之前,请删除对其的所有引用。
删除配置基线后,Configuration Manager 会从部署该基线的设备集合中删除配置基线,Configuration Manager 不再评估其与配置基线的符合性。
注意
从 Configuration Manager 站点驱动器运行 Configuration Manager cmdlet,例如 PS XYZ:\>。 有关详细信息,请参阅 入门。
示例
示例 1:按名称删除配置基线
此命令删除名为 BLConfigContoso02 的配置基线。 命令在运行前提示进行确认。
Remove-CMBaseline -Name "BLConfigContoso02"示例 2:删除依赖基线
此示例首先从 会计部门基线中删除配置基线作为配置数据。 然后,它会删除 ID 为 16777366 的基线。 由于指定了 Force 参数,因此它无需确认即可运行。
$id = "16777366"
Set-CMBaseline -Name "Accounting department baseline" -RemoveBaseline $id
Remove-CMBaseline -Id $id -Force如果不首先从依赖基线中删除基线作为配置数据,此 cmdlet 将返回以下错误: The configuration item cannot be deleted because there are dependent items in use.
参数
-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
指定要删除的配置基线 CI_ID 。 例如,16777516。
| 类型: | Int32 | 
| 别名: | CIId, CI_ID | 
| Position: | 0 | 
| 默认值: | None | 
| 必需: | True | 
| 接受管道输入: | False | 
| 接受通配符: | False | 
-InputObject
指定要删除的配置基线对象。 若要获取此对象,请使用 Get-CMBaseline cmdlet。
| 类型: | IResultObject | 
| Position: | 0 | 
| 默认值: | None | 
| 必需: | True | 
| 接受管道输入: | True | 
| 接受通配符: | False | 
-Name
指定要删除的配置基线的名称。
| 类型: | String | 
| 别名: | LocalizedDisplayName | 
| Position: | 0 | 
| 默认值: | None | 
| 必需: | True | 
| 接受管道输入: | False | 
| 接受通配符: | False | 
-WhatIf
显示在 cmdlet 运行时发生的情况。 cmdlet 不会运行。
| 类型: | SwitchParameter | 
| 别名: | wi | 
| Position: | Named | 
| 默认值: | False | 
| 必需: | False | 
| 接受管道输入: | False | 
| 接受通配符: | False | 
输入
Microsoft.ConfigurationManagement.ManagementProvider.IResultObject
输出
System.Object