Remove-CMSoftwareUpdateAutoDeploymentRule

Referenz

Modul:: ConfigurationManager

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 angegebene Configuration Manager-Bereitstellungsregeln für automatische Softwareupdates.

Configuration Manager verwendet Regeln zum Verwalten der automatischen Bereitstellung von Softwareupdates. Wenn eine Regel ausgeführt wird, fügt Configuration Manager einer Softwareupdategruppe Updates hinzu, die für die Regel gelten. Der Configuration Manager-Server lädt Inhaltsdateien herunter und kopiert sie in Verteilungspunkte und aktualisiert dann Clientcomputer.

Mit dem Cmdlet "Get-CMSoftwareUpdateAutoDeploymentRule" können Sie Regeln angeben, die nach ID oder Name entfernt werden sollen, oder ein Regelobjekt angeben. Mit diesem Cmdlet werden Regeln dauerhaft gelöscht. Sie können das Cmdlet "Disable-CMSoftwareUpdateAutoDeploymentRule" verwenden, um eine Regel anzuhalten.

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 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"):

Mit diesem Befehl wird die Regel "Wöchentliche Treiberupdates" entfernt. Da der Befehl den Parameter "Force" nicht enthält, werden Sie vom Cmdlet aufgefordert, bevor die Regel gelöscht wird.

Beispiel 2: Entfernen einer Bereitstellungsregel nach ID

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

Mit diesem Befehl wird eine Bereitstellungsregel deaktiviert, die die ID 16777217 hat. Dieser Befehl enthält den Parameter "Force", 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.

Mit dem zweiten Befehl wird die in der Variablen gespeicherte Regel 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 IDs für Regeln für die automatische Bereitstellung von Softwareupdates an. Dieser Wert ist die AutoDeploymentID-Eigenschaft des Bereitstellungsregelobjekts.

Type:	Int32
Aliases:	AutoDeploymentId
Position:	0
Default value:	None
Accept pipeline input:	False
Accept wildcard characters:	False

-InputObject

Gibt ein Objekt für die automatische Bereitstellungsregel für Softwareupdates an. Um ein Bereitstellungsregelobjekt abzurufen, verwenden Sie Get-CMSoftwareUpdateAutoDeploymentRule.

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

-Name

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

Type:	String
Position:	0
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