New-TeamsProtectionPolicyRule
Cette cmdlet est disponible uniquement dans le service cloud.
Utilisez l’applet de commande New-TeamsProtectionPolicyRule pour créer des règles de stratégie de protection Microsoft Teams.
Remarque : Si la règle existe déjà (l’applet de commande Get-TeamsProtectionPolicyRule retourne une sortie), vous ne pouvez pas utiliser cette applet de commande.
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-TeamsProtectionPolicyRule
[-Name] <String>
-TeamsProtectionPolicy <TeamsProtectionPolicyIdParameter>
[-Comments <String>]
[-Confirm]
[-Enabled <Boolean>]
[-ExceptIfRecipientDomainIs <Word[]>]
[-ExceptIfSentTo <RecipientIdParameter[]>]
[-ExceptIfSentToMemberOf <RecipientIdParameter[]>]
[-Organization <OrganizationIdParameter>]
[-WhatIf]
[<CommonParameters>]
Description
Vous pouvez utiliser cette applet de commande uniquement si les instructions suivantes sont vraies :
- La règle de stratégie de protection Teams n’existe pas (l’applet de commande Get-TeamsProtectionPolicyRule ne retourne aucune sortie).
- La stratégie de protection Teams existe (l’applet de commande Get-TeamsProtectionPolicy retourne une sortie).
Importante
Différents types d’exceptions de destinataire utilisent la logique OR (le destinataire doit satisfaire l’une des exceptions spécifiées). Pour plus d’informations, consultez Configurer ZAP pour la protection Teams dans Defender for Office 365 Plan 2.
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-TeamsProtectionPolicyRule -Name "Teams Protection Policy Rule" -TeamsProtectionPolicy "Teams Protection Policy" -ExceptIfSentToMemberOf research@contoso.onmicrosoft.com
Cet exemple crée la règle de stratégie de protection Teams avec des membres du groupe nommé Recherche exclus de la protection ZAP pour Teams.
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’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-*) 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 cmdlets, la spécification du commutateur Confirm sans valeur introduit une pause qui vous oblige à confirmer la commande avant de poursuivre.
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 |
-Enabled
Applicable : Exchange Online
Ce paramètre est réservé à l’usage interne chez Microsoft.
Propriétés du paramètre
| Type: | Boolean |
| Valeur par défaut: | False |
| 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 |
-ExceptIfRecipientDomainIs
Applicable : Exchange Online
Le paramètre ExceptIfRecipientDomainIs spécifie une exception à ZAP pour la protection Teams qui recherche les destinataires des messages Teams avec 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 à ZAP pour la protection Teams qui recherche les destinataires des messages Teams. 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 à la protection ZAP pour Teams qui recherche les messages Teams envoyés aux membres de groupes de distribution ou de groupes de sécurité à extension messagerie. 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".
Si vous supprimez le groupe après avoir créé la règle, aucune exception n’est faite pour les messages Teams envoyés aux membres du groupe.
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 Name spécifie le nom unique de la règle de stratégie de protection Teams. Si la valeur contient des espaces, mettez le nom entre guillemets. Le nom par défaut de la règle de stratégie de protection Teams dans un organization est Règle de stratégie de protection Teams. Nous vous recommandons d’utiliser cette valeur.
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: | 1 |
| Obligatoire: | True |
| Valeur du pipeline: | False |
| Valeur du pipeline par nom de propriété: | False |
| Valeur des arguments restants: | False |
-Organization
Applicable : Exchange Online
Ce paramètre est réservé à l’usage interne chez Microsoft.
Propriétés du paramètre
| Type: | OrganizationIdParameter |
| 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 |
-TeamsProtectionPolicy
Applicable : Exchange Online
Le paramètre TeamsProtectionPolicy spécifie la stratégie de protection Teams associée à cette règle. La seule stratégie disponible est nommée Stratégie de protection Teams.
Propriétés du paramètre
| Type: | TeamsProtectionPolicyIdParameter |
| 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 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.
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 courants : -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction et -WarningVariable. Pour plus d’informations, consultez about_CommonParameters.