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-Websitelaufwerk aus, z. PS XYZ:\>B. . 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.

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

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

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

-InputObject

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

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

-Name

Gibt ein Array von Namen von Konfigurationselementen an.

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

-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