Freigeben über

Remove-CMSettingDeployment

  • Referenz
Modul:
ConfigurationManager

Entfernen sie eine Bereitstellung für ein Einstellungsrichtlinienobjekt.

Syntax

Remove-CMSettingDeployment
      [-CMSettingsDeployment] <SettingsDeployment>
      [-Force]
      [-DisableWildcardHandling]
      [-ForceWildcardHandling]
      [<CommonParameters>]

Beschreibung

Löschen sie eine Bereitstellung für ein Einstellungsrichtlinienobjekt. Entfernen Sie beispielsweise die Bereitstellung einer BitLocker-Verwaltungsrichtlinie oder einer Microsoft Defender-Anwendungssteuerungsrichtlinie.

Beispiele

Beispiel 1: Entfernen aller Bereitstellungen für ein BitLocker-Verwaltungseinstellungsobjekt

In diesem Beispiel wird zunächst ein BitLocker-Verwaltungseinstellungsobjekt abgerufen. Anschließend wird der Pipeoperator verwendet, um alle Bereitstellungen für dieses Richtlinienobjekt abzurufen, und diese Bereitstellungen werden gelöscht.

Get-CMBlmSetting -Name "My BitLocker settings" | Get-CMSettingDeployment | Remove-CMSettingDeployment

Beispiel 2: Entfernen aller Bereitstellungen in einer bestimmten Sammlung für ein Microsoft Defender Application Control-Einstellungsobjekt

In diesem Beispiel wird zunächst ein Einstellungsobjekt der Microsoft Defender-Anwendungssteuerung abgerufen. Anschließend wird der Pipeoperator verwendet, um alle Bereitstellungen für dieses Richtlinienobjekt abzurufen. Die Where-Object-Klausel filtert die Liste der Bereitstellungen für die Bereitstellungen in der Sammlung Alle Desktop- und Serverclients und löscht diese Bereitstellungen.

Get-CMWdacSetting -Name "My App Control settings" | Get-CMSettingDeployment | Where-Object { $_.CollectionId -eq (Get-CMCollection -Name "All Desktop and Server Clients").CollectionId } | Remove-CMSettingDeployment

Parameter

-CMSettingsDeployment

Geben Sie das zu konfigurierende Bereitstellungsobjekt für Einstellungen an. Verwenden Sie zum Abrufen des Bereitstellungsobjekts das Cmdlet Get-CMSettingDeployment .

Typ:SettingsDeployment
Position:1
Standardwert:None
Erforderlich:True
Pipelineeingabe akzeptieren:True
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

Führen Sie den Befehl aus, ohne zur Bestätigung zu fragen.

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

Eingaben

Microsoft.ConfigurationManagement.PowerShell.Cmdlets.Deployments.SettingsDeployment.SettingsDeployment

Ausgaben

Microsoft.ConfigurationManagement.PowerShell.Cmdlets.Deployments.SettingsDeployment.SettingsDeployment