Freigeben über

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 bewertet nicht mehr deren Konformität mit der Konfigurationsbaseline.

Hinweis

Führen Sie Configuration Manager-Cmdlets auf dem Configuration Manager-Standortlaufwerk aus, z. B PS XYZ:\>. . 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.

Typ:SwitchParameter
Aliase:cf
Position:Named
Standardwert:False
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-DisableWildcardHandling

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

Typ:SwitchParameter
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-Force

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

Typ:SwitchParameter
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-ForceWildcardHandling

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

Typ:SwitchParameter
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-Id

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

Typ:Int32
Aliase:CIId, CI_ID
Position:0
Standardwert:None
Erforderlich:True
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-InputObject

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

Typ:IResultObject
Position:0
Standardwert:None
Erforderlich:True
Pipelineeingabe akzeptieren:True
Platzhalterzeichen akzeptieren:False

-Name

Geben Sie den Namen der zu entfernenden Konfigurationsbaseline an.

Typ:String
Aliase:LocalizedDisplayName
Position:0
Standardwert:None
Erforderlich:True
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-WhatIf

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

Typ:SwitchParameter
Aliase:wi
Position:Named
Standardwert:False
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

Eingaben

Microsoft.ConfigurationManagement.ManagementProvider.IResultObject

Ausgaben

System.Object