Freigeben über


Remove-CMSoftwareUpdateAutoDeploymentRule

Entfernt Configuration Manager-Bereitstellungsregeln für automatische Softwareupdates.

Syntax

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

Beschreibung

Das Cmdlet Remove-CMSoftwareUpdateAutoDeploymentRule entfernt die angegebenen Configuration Manager-Bereitstellungsregeln für automatische Softwareupdates.

Configuration Manager verwendet Regeln, um die automatische Bereitstellung von Softwareupdates zu verwalten. Wenn eine Regel ausgeführt wird, fügt Configuration Manager einer Softwareupdategruppe Updates hinzu, die für die Regel geeignet sind. Der Configuration Manager-Server lädt Inhaltsdateien herunter, kopiert sie auf Verteilungspunkte und aktualisiert dann Clientcomputer.

Sie können regeln angeben, die entfernt werden sollen, indem Sie die ID oder den Namen verwenden oder ein Regelobjekt mithilfe des Cmdlets Get-CMSoftwareUpdateAutoDeploymentRule angeben. Dieses Cmdlet löscht Regeln dauerhaft. Sie können das Cmdlet Disable-CMSoftwareUpdateAutoDeploymentRule verwenden, um eine Regel anzusetzen.

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 Bereitstellungsregel anhand des Namens

PS XYZ:\> Remove-CMSoftwareUpdateAutoDeploymentRule -Name "Weekly Driver Updates"
Remove
Are you sure you wish to remove SoftwareUpdateAutoDeploymentRule: Name="Weekly Driver Updates"?
[Y] Yes  [N] No  [S] Suspend  [?] Help (default is "Y"):

Dieser Befehl entfernt eine Regel mit dem Namen Wöchentliche Treiberupdates. Da der Befehl den Force-Parameter nicht enthält, werden Sie vom Cmdlet aufgefordert, bevor es die Regel löscht.

Beispiel 2: Entfernen einer Bereitstellungsregel nach ID

PS XYZ:\> Remove-CMSoftwareUpdateAutoDeploymentRule -Id "16777217" -Force

Dieser Befehl deaktiviert eine Bereitstellungsregel mit der ID 16777217. Dieser Befehl enthält den Force-Parameter , sodass Sie vom Cmdlet nicht aufgefordert werden, bevor die Regel entfernt wird.

Beispiel 3: Entfernen einer Bereitstellungsregel mithilfe einer Variablen

PS XYZ:\> $CMSUADR = Get-CMSoftwareUpdateAutoDeploymentRule -Name "Weekly Driver Updates"
PS XYZ:\> Remove-CMSoftwareUpdateAutoDeploymentRule -InputObject $CMSUADR -Force

Der erste Befehl ruft eine Bereitstellungsregel mit dem angegebenen Namen ab und speichert sie dann in der variablen $CMSUADR.

Der zweite Befehl entfernt die in der Variablen gespeicherte Regel.

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 IDs für Regeln für die automatische Bereitstellung von Softwareupdates an. Dieser Wert ist die AutoDeploymentID-Eigenschaft des Bereitstellungsregelobjekts.

Typ:Int32
Aliase:AutoDeploymentId
Position:0
Standardwert:None
Erforderlich:True
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-InputObject

Gibt ein Automatisches Bereitstellungsregelobjekt für Softwareupdates an. Verwenden Sie Get-CMSoftwareUpdateAutoDeploymentRule, um ein Bereitstellungsregelobjekt abzurufen.

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

-Name

Gibt den Namen einer Regel für die automatische Bereitstellung von Softwareupdates an.

Typ:String
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