Remove-CMSoftwareUpdateGroup

Entfernt Configuration Manager-Softwareupdategruppen.

Syntax

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

Beschreibung

Das Cmdlet "Remove-CMSoftwareUpdateGroup" entfernt Softwareupdategruppen aus Configuration Manager. Sie können jede Softwareupdategruppe angeben, die Sie entfernen möchten, indem Sie die Gruppen-IDs oder -Namen verwenden. Wenn Sie eine Softwareupdategruppe entfernen, können Sie das Cmdlet "Get-CMSoftwareUpdateGroup" verwenden, um ein Softwareupdate-Gruppenobjekt zurückzugeben, und dieses Objekt verwenden, um die Gruppe anzugeben, die Sie entfernen möchten.

Hinweis

Führen Sie Configuration Manager-Cmdlets beispielsweise vom Configuration Manager-Standortlaufwerk PS XYZ:\> aus. Weitere Informationen finden Sie unter "Erste Schritte".

Beispiele

Beispiel 1: Entfernen einer Softwareupdategruppe mithilfe einer ID

PS XYZ:\> Remove-CMSoftwareUpdateGroup -Id "ST10000B"

Mit diesem Befehl wird die Softwareupdategruppe mit der ID ST10000B entfernt.

Beispiel 2: Entfernen einer Softwareupdategruppe mithilfe eines Namens

PS XYZ:\> Remove-CMSoftwareUpdateGroup -Name "SUGroupD01"

Mit diesem Befehl wird die Softwareupdategruppe namens SUGroupD01 entfernt.

Beispiel 3: Entfernen einer Softwareupdategruppe mithilfe einer Objektvariablen

PS XYZ:\> $SubObj=Get-CMSoftwareUpdateGroup -Id "ST10000B"
PS XYZ:\> Remove-CMSoftwareUpdateGroup -SoftwareUpdateGroup $SubObj

Der erste Befehl ruft die Softwareupdategruppe mit der ID ST10000B ab und speichert sie dann in der Variablen $SubObj.

Mit dem zweiten Befehl wird die Softwareupdategruppe mithilfe der variablen $SubObj entfernt.

Parameter

-Confirm

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

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

-DisableWildcardHandling

Dieser Parameter behandelt Platzhalterzeichen als Literalzeichenwerte. Sie können es nicht mit ForceWildcardHandlingkombinieren.

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

-Force

Erzwingt die Ausführung des Befehls, ohne die Bestätigung des Benutzers anzufordern.

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

-ForceWildcardHandling

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

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

-Id

Gibt ein Array von Softwareupdate-Gruppen-IDs an.

Type:String[]
Aliases:CIId
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False

-InputObject

Gibt das zu entfernende Softwareupdategruppenobjekt an. Um ein Softwareupdate-Gruppenobjekt abzurufen, verwenden Sie Get-CMSoftwareUpdateGroup.

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

-Name

Gibt ein Array von Softwareupdate-Gruppennamen an.

Type:String
Aliases:LocalizedDisplayName
Position:Named
Default value:None
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
Accept pipeline input:False
Accept wildcard characters:False

Eingaben

Microsoft.ConfigurationManagement.ManagementProvider.IResultObject

Ausgaben

System.Object