Freigeben über

Remove-CMConfigurationItem

  • Referenz
Modul:
ConfigurationManager

Entfernt Konfigurationselemente aus Configuration Manager.

Syntax

Remove-CMConfigurationItem
      [-Force]
      [-Id] <Int32>
      [-DisableWildcardHandling]
      [-ForceWildcardHandling]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]
Remove-CMConfigurationItem
      [-Force]
      [-InputObject] <IResultObject>
      [-DisableWildcardHandling]
      [-ForceWildcardHandling]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]
Remove-CMConfigurationItem
      [-Force]
      [-Name] <String>
      [-DisableWildcardHandling]
      [-ForceWildcardHandling]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]

Beschreibung

Das Cmdlet Remove-CMConfigurationItem entfernt die angegebenen Konfigurationselemente aus Configuration Manager. Sie können Elemente anhand der ID, des Namens oder mithilfe des Cmdlets angeben.

Konfigurationselemente enthalten mindestens eine Einstellung sowie Kompatibilitätsregeln. Elemente definieren in der Regel eine Gewünschte Konfigurationseinheit.

Wenn Sie ein Konfigurationselement entfernen, das in einer Sammlung bereitgestellt wurde, wird auch die Bereitstellung entfernt.

Weitere Informationen zu Konfigurationselementen finden Sie unter Einführung in Kompatibilitätseinstellungen in Configuration Manager.

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 eines Elements mithilfe einer ID

PS XYZ:\> Remove-CMConfigurationItem -Id "16777568"

Dieser Befehl entfernt ein Konfigurationselement mit dem angegebenen Bezeichner.

Beispiel 2: Entfernen eines Elements mithilfe eines Namens

PS XYZ:\> Remove-CMConfigurationItem -Name "ConfigItem76"

Dieser Befehl entfernt ein Konfigurationselement mit dem Namen ConfigItem76.

Beispiel 3: Entfernen eines Elements mithilfe einer Variablen

PS XYZ:\> $CIObj=Get-CMConfigurationItem -Id "16777568"
PS XYZ:\> Remove-CMConfigurationItem -InputObject $CIObj

Der erste Befehl ruft ein Konfigurationselement mit dem angegebenen Bezeichner ab und speichert es in der variablen $CIObj.

Der zweite Befehl entfernt das in der $CIObj Variable gespeicherte Element.

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

Gibt ein Array von Bezeichnern für ein oder mehrere Konfigurationselemente an. Sie können eine durch Trennzeichen getrennte Liste verwenden.

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

-InputObject

Gibt ein Konfigurationselementobjekt an. Zum Abrufen eines Konfigurationselementobjekts können Sie das Cmdlet Get-CMConfigurationItem verwenden.

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

-Name

Gibt ein Array von Namen von Konfigurationselementen an.

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

-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