Remove-ATPProtectionPolicyRule

Référence

Module:: ExchangePowerShell

S’applique à:: Exchange Online

Cette cmdlet est disponible uniquement dans le service cloud.

Utilisez l’applet de commande Remove-ATPProtectionPolicyRule pour supprimer des règles des protections Microsoft Defender pour Office 365 dans les stratégies de sécurité prédéfinies. Les règles spécifient des conditions de destinataire et des exceptions pour la protection, et vous permettent également d’activer et de désactiver les stratégies de sécurité prédéfinies associées.

Remarque : utilisez cette applet de commande pour supprimer une règle uniquement si vous envisagez de recréer immédiatement la règle à l’aide de l’applet de commande New-ATPProtectionPolicyRule. La stratégie de sécurité prédéfinie affectée ne fonctionnera pas sans une règle correspondante.

Pour plus d’informations sur les jeux de paramètres dans la section Syntaxe ci-après, voir Syntaxe da la cmdlet Exchange.

Syntax

Remove-ATPProtectionPolicyRule
      [-Identity] <RuleIdParameter>
      [-Confirm]
      [-WhatIf]
      [<CommonParameters>]

Description

Pour plus d’informations sur les stratégies de sécurité prédéfinies dans PowerShell, consultez Stratégies de sécurité prédéfinies dans Exchange Online PowerShell.

Des autorisations doivent vous être attribuées avant de pouvoir exécuter cette cmdlet. Bien que cette rubrique répertorie tous les paramètres de cette cmdlet, il est possible que vous n’ayez pas accès à certains paramètres s’ils ne sont pas inclus dans les autorisations qui vous ont été attribuées. Pour rechercher les autorisations requises pour exécuter une cmdlet ou un paramètre dans votre organisation, voir Find the permissions required to run any Exchange cmdlet.

Exemples

Exemple 1

Remove-ATPProtectionPolicyRule -Identity "Standard Preset Security Policy"

Cet exemple supprime la règle existante pour les protections Defender pour Office 365 dans la stratégie de sécurité prédéfinie Standard.

Paramètres

-Confirm

Le commutateur Confirme spécifie s’il faut afficher ou masquer l’invite de confirmation. L’incidence de ce commutateur sur la cmdlet varie selon que la cmdlet requiert une confirmation avant de poursuivre.

Les applets de commande destructrices (par exemple, les applets de commande Remove-*) ont une pause intégrée qui vous oblige à accuser réception de la commande avant de continuer. Pour ces cmdlets, vous pouvez ignorer l’invite de confirmation à l’aide de cette syntaxe exacte : -Confirm:$false.
La plupart des autres applets de commande (par exemple, les applets de commande New-* et Set-*) n’ont pas de pause intégrée. Pour ces cmdlets, la spécification du commutateur Confirm sans valeur introduit une pause qui vous oblige à confirmer la commande avant de poursuivre.

Type:	SwitchParameter
Aliases:	cf
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Exchange Online

-Identity

Le paramètre Identity spécifie la règle à supprimer. Vous pouvez utiliser une valeur quelconque qui identifie distinctement la règle. Par exemple :

Nom
Nom unique (DN)
GUID

Par défaut, les règles disponibles (si elles existent) sont nommées Stratégie de sécurité prédéfinie standard et Stratégie de sécurité prédéfinie stricte.

Type:	RuleIdParameter
Position:	0
Default value:	None
Required:	True
Accept pipeline input:	True
Accept wildcard characters:	False
Applies to:	Exchange Online

-WhatIf

Le commutateur WhatIf simule les actions de la commande. Vous pouvez utiliser ce commutateur pour afficher les modifications qui se produiraient sans réellement appliquer ces modifications. Il n’est pas nécessaire de spécifier une valeur pour ce commutateur.

Type:	SwitchParameter
Aliases:	wi
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Exchange Online

Partager via