Remove-CMSettingDeployment

Supprimer un déploiement pour un objet de stratégie de paramètres.

Syntax

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

Description

Supprimer un déploiement pour un objet de stratégie de paramètres. Par exemple, supprimez le déploiement d’une stratégie de gestion BitLocker ou d’une stratégie Microsoft Defender Application Control.

Exemples

Exemple 1 : Supprimer tous les déploiements d’un objet de paramètres de gestion BitLocker

Cet exemple obtient d’abord un objet de paramètres de gestion BitLocker. Il utilise ensuite l’opérateur pipe pour obtenir tous les déploiements de cet objet de stratégie et supprime ces déploiements.

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

Exemple 2 : Supprimer tous les déploiements dans une collection spécifique pour un objet de paramètres Microsoft Defender Application Control

Cet exemple obtient d’abord un objet de paramètres Microsoft Defender Application Control. Il utilise ensuite l’opérateur pipe pour obtenir tous les déploiements de cet objet de stratégie. La clause Where-Object filtre la liste des déploiements vers ceux de la collection All Desktop and Server Clients et supprime ces déploiements.

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

Paramètres

-CMSettingsDeployment

Spécifiez l’objet de déploiement des paramètres à configurer. Pour obtenir l’objet de déploiement, utilisez la cmdlet Get-CMSettingDeployment.

Type:SettingsDeployment
Position:1
Default value:None
Accept pipeline input:True
Accept wildcard characters:False

-DisableWildcardHandling

Ce paramètre traite les caractères génériques comme des valeurs littérales. Vous ne pouvez pas la combiner avec ForceWildcardHandling.

Type:SwitchParameter
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False

-Force

Exécutez la commande sans demander confirmation.

Type:SwitchParameter
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False

-ForceWildcardHandling

Ce paramètre traite les caractères génériques et peut entraîner un comportement inattendu (non recommandé). Vous ne pouvez pas la combiner avec DisableWildcardHandling.

Type:SwitchParameter
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False

Entrées

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

Sorties

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