Remove-CMBaseline

  • Referenz
Modul:
ConfigurationManager

Entfernen sie eine Konfigurationsbaseline.

Syntax

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

Beschreibung

Verwenden Sie dieses Cmdlet, um eine Konfigurationsbaseline zu entfernen. Bevor Sie eine Konfigurationsbaseline entfernen können, entfernen Sie alle Verweise darauf.

Nachdem Sie eine Konfigurationsbaseline entfernt haben, entfernt Configuration Manager die Konfigurationsbaseline aus der Sammlung der Geräte, auf denen Sie sie bereitgestellt haben, und Configuration Manager ihre Konformität mit der Konfigurationsbaseline nicht mehr bewertet.

Hinweis

Führen Sie Configuration Manager Cmdlets auf dem Configuration Manager-Websitelaufwerk aus, z. PS XYZ:\>B. . Weitere Informationen finden Sie unter Erste Schritte.

Beispiele

Beispiel 1: Entfernen einer Konfigurationsbaseline anhand des Namens

Dieser Befehl entfernt die Konfigurationsbaseline mit dem Namen BLConfigContoso02. Der Befehl fordert zur Bestätigung auf, bevor er ausgeführt wird.

Remove-CMBaseline -Name "BLConfigContoso02"

Beispiel 2: Entfernen einer abhängigen Baseline

In diesem Beispiel wird zunächst die Konfigurationsbaseline als Konfigurationsdaten aus der Baseline der Buchhaltungsabteilung entfernt. Anschließend wird die Baseline mit der ID 16777366 entfernt. Da der Force-Parameter angegeben ist, wird er ohne Bestätigung ausgeführt.

$id = "16777366"
Set-CMBaseline -Name "Accounting department baseline" -RemoveBaseline $id
Remove-CMBaseline -Id $id -Force

Wenn Sie nicht zuerst eine Baseline als Konfigurationsdaten aus abhängigen Baselines entfernen, gibt dieses Cmdlet den folgenden Fehler zurück: The configuration item cannot be deleted because there are dependent items in use.

Parameter

-Confirm

Fordert Sie vor dem Ausführen des Cmdlets zur Bestätigung auf.

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

-DisableWildcardHandling

Dieser Parameter behandelt Wildcardzeichen als Literalzeichenwerte. Sie können es nicht mit ForceWildcardHandling kombinieren.

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

-Force

Erzwingt die Ausführung des Befehls ohne Benutzerbestätigung.

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

-ForceWildcardHandling

Dieser Parameter verarbeitet Wildcardzeichen und kann zu unerwartetem Verhalten führen (nicht empfohlen). Sie können es nicht mit DisableWildcardHandling kombinieren.

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

-Id

Geben Sie die CI_ID der zu entfernenden Konfigurationsbaseline an. Beispiel: 16777516.

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

-InputObject

Geben Sie ein zu entfernende Konfigurationsbaselineobjekt an. Verwenden Sie zum Abrufen dieses Objekts das Cmdlet Get-CMBaseline .

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

-Name

Geben Sie den Namen der zu entfernenden Konfigurationsbaseline an.

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

-WhatIf

Zeigt, was passieren würde, wenn das Cmdlet ausgeführt wird. Das Cmdlet wird nicht ausgeführt.

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

Eingaben

Microsoft.ConfigurationManagement.ManagementProvider.IResultObject

Ausgaben

System.Object