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