New-ATPBuiltInProtectionRule
Cette cmdlet est disponible uniquement dans le service cloud.
Remarque : n’utilisez pas cette applet de commande. Cette applet de commande est utilisée par le système pour créer la seule et unique règle pour la stratégie de sécurité prédéfinie de protection intégrée lors de la création de l’organisation. Vous ne pouvez pas utiliser cette applet de commande si une règle pour la stratégie de sécurité prédéfinie de protection intégrée existe déjà. L’applet de commande Remove-ATPBuiltInProtectionRule n’est pas disponible pour supprimer des règles.
Utilisez l’applet de commande New-ATPBuiltInProtectionRule pour créer la règle de la stratégie de sécurité prédéfinie de protection intégrée qui fournit efficacement des stratégies par défaut pour les liens fiables et les pièces jointes fiables dans Microsoft Defender pour Office 365. La règle spécifie les exceptions à la stratégie.
Pour plus d’informations sur les jeux de paramètres dans la section Syntaxe ci-après, voir Syntaxe da la cmdlet Exchange.
Syntaxe
Default (Par défaut)
New-ATPBuiltInProtectionRule
-SafeAttachmentPolicy <SafeAttachmentPolicyIdParameter>
-SafeLinksPolicy <SafeLinksPolicyIdParameter>
[-Comments <String>]
[-Confirm]
[-ExceptIfRecipientDomainIs <Word[]>]
[-ExceptIfSentTo <RecipientIdParameter[]>]
[-ExceptIfSentToMemberOf <RecipientIdParameter[]>]
[-Name <String>]
[-WhatIf]
[<CommonParameters>]
Description
Pour plus d’informations sur les stratégies de sécurité prédéfinies dans PowerShell, voir Stratégies de sécurité prédéfinies dans Exchange Online PowerShell.
Importante
Différents types d’exceptions de destinataire utilisent la logique OU (le destinataire doit satisfaire à l’une des exceptions spécifiées). Pour plus d’informations, consultez Profils dans les stratégies de sécurité prédéfinies.
Des autorisations doivent vous être attribuées avant de pouvoir exécuter cette cmdlet. Bien que cet article répertorie tous les paramètres de l’applet de commande, il se peut que vous n’ayez pas accès à certains paramètres s’ils ne sont pas inclus dans les autorisations qui vous sont 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
New-ATPBuiltInProtectionRule -SafeAttachmentPolicy "Built-In Protection Policy" -SafeLinksPolicy "Built-In Protection Policy"
Cette applet de commande crée la règle pour la stratégie de sécurité prédéfinie de protection intégrée. Cette commande échoue si la règle existe déjà.
Paramètres
-Comments
Applicable : Exchange Online
Le paramètre Comments permet de spécifier des commentaires informatifs pour la règle, tels que le rôle de la règle ou son évolution dans le temps. Le commentaire ne peut pas comporter plus de 1 024 caractères.
Propriétés du paramètre
| Type: | String |
| Valeur par défaut: | None |
| Prend en charge les caractères génériques: | False |
| DontShow: | False |
Jeux de paramètres
(All)
| Position: | Named |
| Obligatoire: | False |
| Valeur du pipeline: | False |
| Valeur du pipeline par nom de propriété: | False |
| Valeur des arguments restants: | False |
-Confirm
Applicable : Exchange Online
Le commutateur Confirme spécifie s’il faut afficher ou masquer l’invite de confirmation. L’impact de ce commutateur sur l’applet de commande varie selon que l’applet de commande nécessite une confirmation avant de continuer.
- Les applets de commande destructrices (par exemple, les applets de commande Remove-*) comportent 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 applets de commande, la spécification du commutateur Confirmer sans valeur introduit une pause qui vous oblige à accuser réception de la commande avant de continuer.
Propriétés du paramètre
| Type: | SwitchParameter |
| Valeur par défaut: | None |
| Prend en charge les caractères génériques: | False |
| DontShow: | False |
| Alias: | cf |
Jeux de paramètres
(All)
| Position: | Named |
| Obligatoire: | False |
| Valeur du pipeline: | False |
| Valeur du pipeline par nom de propriété: | False |
| Valeur des arguments restants: | False |
-ExceptIfRecipientDomainIs
Applicable : Exchange Online
Le paramètre ExceptIfRecipientDomainIs spécifie une exception qui recherche les destinataires ayant des adresses e-mail dans les domaines spécifiés. Vous pouvez spécifier plusieurs domaines séparés par des virgules.
Propriétés du paramètre
| Type: | Word[] |
| Valeur par défaut: | None |
| Prend en charge les caractères génériques: | False |
| DontShow: | False |
Jeux de paramètres
(All)
| Position: | Named |
| Obligatoire: | False |
| Valeur du pipeline: | False |
| Valeur du pipeline par nom de propriété: | False |
| Valeur des arguments restants: | False |
-ExceptIfSentTo
Applicable : Exchange Online
Le paramètre ExceptIfSentTo spécifie une exception qui recherche les destinataires dans les messages. Vous pouvez utiliser une valeur quelconque qui identifie le destinataire. Par exemple :
- Nom
- Alias
- Nom unique
- Nom unique
- Nom unique canonique
- GUID
Vous pouvez entrer plusieurs valeurs séparées par des virgules. Si les valeurs contiennent des espaces ou requièrent des guillemets, utilisez la syntaxe suivante : "Value1","Value2",..."ValueN".
Propriétés du paramètre
| Type: | RecipientIdParameter[] |
| Valeur par défaut: | None |
| Prend en charge les caractères génériques: | False |
| DontShow: | False |
Jeux de paramètres
(All)
| Position: | Named |
| Obligatoire: | False |
| Valeur du pipeline: | False |
| Valeur du pipeline par nom de propriété: | False |
| Valeur des arguments restants: | False |
-ExceptIfSentToMemberOf
Applicable : Exchange Online
Le paramètre ExceptIfSentToMemberOf spécifie une exception qui recherche les messages envoyés aux membres de groupes. Vous pouvez utiliser n’importe quelle valeur qui identifie de manière unique le groupe. Par exemple :
- Nom
- Alias
- Nom unique
- Nom unique
- Nom unique canonique
- GUID
Vous pouvez entrer plusieurs valeurs séparées par des virgules. Si les valeurs contiennent des espaces ou requièrent des guillemets, utilisez la syntaxe suivante : "Value1","Value2",..."ValueN".
PD_UCC_Multiple_Values
Propriétés du paramètre
| Type: | RecipientIdParameter[] |
| Valeur par défaut: | None |
| Prend en charge les caractères génériques: | False |
| DontShow: | False |
Jeux de paramètres
(All)
| Position: | Named |
| Obligatoire: | False |
| Valeur du pipeline: | False |
| Valeur du pipeline par nom de propriété: | False |
| Valeur des arguments restants: | False |
-Name
Applicable : Exchange Online
Le paramètre Nom spécifie un nom unique pour la règle. La longueur maximale est de 64 caractères.
Le nom de la seule règle est ATP Built-In Règle de protection.
Propriétés du paramètre
| Type: | String |
| Valeur par défaut: | None |
| Prend en charge les caractères génériques: | False |
| DontShow: | False |
Jeux de paramètres
(All)
| Position: | Named |
| Obligatoire: | False |
| Valeur du pipeline: | False |
| Valeur du pipeline par nom de propriété: | False |
| Valeur des arguments restants: | False |
-SafeAttachmentPolicy
Applicable : Exchange Online
Le paramètre SafeAttachmentPolicy spécifie la stratégie de pièces jointes fiables associée à la stratégie de sécurité prédéfinie intégrée. Utilisez la commande suivante pour identifier la stratégie : Get-SafeAttachmentPolicy | Where-Object -Property IsBuiltInProtection -eq -Value "True".
Le nom de la stratégie par défaut des pièces jointes sécurisées utilisée pour la stratégie de sécurité prédéfinie de protection intégrée est Built-In stratégie de protection.
Propriétés du paramètre
| Type: | SafeAttachmentPolicyIdParameter |
| Valeur par défaut: | None |
| Prend en charge les caractères génériques: | False |
| DontShow: | False |
Jeux de paramètres
(All)
| Position: | Named |
| Obligatoire: | True |
| Valeur du pipeline: | False |
| Valeur du pipeline par nom de propriété: | False |
| Valeur des arguments restants: | False |
-SafeLinksPolicy
Applicable : Exchange Online
Le paramètre SafeLinksPolicy spécifie la stratégie de liens fiables associée à la stratégie de sécurité prédéfinie intégrée. Utilisez la commande suivante pour identifier la stratégie : Get-SafeLinksPolicy | Where-Object -Property IsBuiltInProtection -eq -Value "True".
Le nom de la stratégie de liens fiables par défaut utilisée pour la stratégie de sécurité prédéfinie de protection intégrée est Built-In stratégie de protection.
Propriétés du paramètre
| Type: | SafeLinksPolicyIdParameter |
| Valeur par défaut: | None |
| Prend en charge les caractères génériques: | False |
| DontShow: | False |
Jeux de paramètres
(All)
| Position: | Named |
| Obligatoire: | True |
| Valeur du pipeline: | False |
| Valeur du pipeline par nom de propriété: | False |
| Valeur des arguments restants: | False |
-WhatIf
Applicable : Exchange Online
Le commutateur WhatIf affiche ce que la commande fait sans apporter de modifications. Il n’est pas nécessaire de spécifier une valeur pour ce commutateur.
Propriétés du paramètre
| Type: | SwitchParameter |
| Valeur par défaut: | None |
| Prend en charge les caractères génériques: | False |
| DontShow: | False |
| Alias: | wi |
Jeux de paramètres
(All)
| Position: | Named |
| Obligatoire: | False |
| Valeur du pipeline: | False |
| Valeur du pipeline par nom de propriété: | False |
| Valeur des arguments restants: | False |
CommonParameters
Cette applet de commande prend en charge les paramètres communs : -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction et -WarningVariable. Pour plus d’informations, consultez about_CommonParameters.