Remove-CMSettingDeployment

Referenz

Modul:: ConfigurationManager

Dient zum Entfernen einer Bereitstellung für ein Einstellungsrichtlinienobjekt.

Syntax

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

Beschreibung

Dient zum Löschen einer 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 zurückgegeben. Anschließend wird der Pipe-Operator 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 Auflistung für ein Einstellungsobjekt der Microsoft Defender-Anwendungssteuerung

In diesem Beispiel wird zuerst ein Einstellungsobjekt für die Microsoft Defender-Anwendungssteuerung zurückgegeben. Anschließend wird der Pipe-Operator verwendet, um alle Bereitstellungen für dieses Richtlinienobjekt abzurufen. Die Where-Object-Klausel filtert die Liste der Bereitstellungen nach den Bereitstellungen in der Auflistung "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 Einstellungsbereitstellungsobjekt an. Verwenden Sie zum Abrufen des Bereitstellungsobjekts das Cmdlet "Get-CMSettingDeployment".

Type:	SettingsDeployment
Position:	1
Default value:	None
Accept pipeline input:	True
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

Führen Sie den Befehl aus, ohne um Bestätigung zu bitten.

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

Eingaben

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

Ausgaben