Set-TeamsProtectionPolicyRule
Cette cmdlet est disponible uniquement dans le service cloud.
Utilisez l’applet de commande Set-TeamsProtectionPolicyRule pour modifier les règles de stratégie de protection Microsoft Teams.
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)
Set-TeamsProtectionPolicyRule
[-Identity] <RuleIdParameter>
[-Comments <String>]
[-Confirm]
[-ExceptIfRecipientDomainIs <Word[]>]
[-ExceptIfSentTo <RecipientIdParameter[]>]
[-ExceptIfSentToMemberOf <RecipientIdParameter[]>]
[-WhatIf]
[<CommonParameters>]
Description
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
Set-TeamsProtectionPolicyRule -Identity "Teams Protection Policy Rule" -ExceptIfRecipientDomainIs research.contoso.com
Cet exemple modifie la règle de stratégie de protection Teams existante en excluant les destinataires du domaine research.contoso.com 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 |
-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.
Pour remplacer tous les domaines existants par les valeurs que vous spécifiez, utilisez la syntaxe suivante : Domain1,Domain2,...DomainN.
Pour ajouter des domaines sans affecter d’autres valeurs existantes, utilisez la syntaxe suivante :
$DomainsAdd = Get-TeamsProtectionPolicyRule -Identity "Teams Protection Policy Rule" | select -Expand ExceptIfRecipientDomainIs
$DomainsAdd += "Domain1","Domain2",..."DomainN"
Set-TeamsProtectionPolicyRule -Identity "Teams Protection Policy Rule" -ExceptIfRecipientDomainIs $DomainsAdd
Pour supprimer des domaines sans affecter d’autres valeurs existantes, utilisez la syntaxe suivante :
Exécutez les commandes suivantes pour afficher la liste de valeurs existante dans l’ordre :
$x = Get-TeamsProtectionPolicyRule -Identity "Teams Protection Policy Rule"$d = [System.Collections.ArrayList]($x.ExceptIfRecipientDomainIs)$dLa première valeur de la liste a le numéro d’index 0, la seconde le numéro d’index 1, et ainsi de suite.
Utilisez le numéro d’index pour spécifier la valeur à supprimer. Par exemple, pour supprimer la septième valeur de la liste, exécutez les commandes suivantes :
$d.RemoveAt(6)Set-TeamsProtectionPolicyRule -Identity "Teams Protection Policy Rule" -ExceptIfRecipientDomainIs $d
Pour vider la liste, utilisez la valeur $null pour ce paramètre.
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
Pour remplacer tous les destinataires existants par les valeurs que vous spécifiez, utilisez la syntaxe suivante : "User1","User2",..."UserN".
Pour ajouter des destinataires sans affecter d’autres valeurs existantes, utilisez la syntaxe suivante :
$UsersAdd = Get-TeamsProtectionPolicyRule -Identity "Teams Protection Policy Rule" | select -Expand ExceptIfSentTo
$UsersAdd += "User1","User2",..."UserN"
Set-TeamsProtectionPolicyRule -Identity "Teams Protection Policy Rule" -ExceptIfSentTo $UsersAdd
Pour supprimer des destinataires sans affecter d’autres valeurs existantes, utilisez la syntaxe suivante :
Exécutez les commandes suivantes pour afficher la liste de valeurs existante dans l’ordre :
$x = Get-TeamsProtectionPolicyRule -Identity "Teams Protection Policy Rule"$u = [System.Collections.ArrayList]($x.ExceptIfSentTo)$uLa première valeur de la liste a le numéro d’index 0, la seconde le numéro d’index 1, et ainsi de suite.
Utilisez le numéro d’index pour spécifier la valeur à supprimer. Par exemple, pour supprimer la septième valeur de la liste, exécutez les commandes suivantes :
$u.RemoveAt(6)Set-TeamsProtectionPolicyRule -Identity "Teams Protection Policy Rule" -ExceptIfSentTo $u
Pour vider la liste, utilisez la valeur $null pour ce paramètre.
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
Pour ajouter des groupes sans affecter d’autres valeurs existantes, utilisez la syntaxe suivante :
$GroupsAdd = Get-TeamsProtectionPolicyRule -Identity "Teams Protection Policy Rule" | select -Expand ExceptIfSentToMemberOf
$GroupsAdd += "Group1","Group2",..."GroupN"
Set-TeamsProtectionPolicyRule -Identity "Teams Protection Policy Rule" -ExceptIfSentToMemberOf $GroupsAdd
Pour supprimer des groupes sans affecter d’autres valeurs existantes, utilisez la syntaxe suivante :
Exécutez les commandes suivantes pour afficher la liste de valeurs existante dans l’ordre :
$x = Get-TeamsProtectionPolicyRule -Identity "Teams Protection Policy Rule"$g = [System.Collections.ArrayList]($x.ExceptIfSentToMemberOf)$gLa première valeur de la liste a le numéro d’index 0, la seconde le numéro d’index 1, et ainsi de suite.
Utilisez le numéro d’index pour spécifier la valeur à supprimer. Par exemple, pour supprimer la septième valeur de la liste, exécutez les commandes suivantes :
$g.RemoveAt(6)Set-TeamsProtectionPolicyRule -Identity "Teams Protection Policy Rule" -ExceptIfSentTo $g
Si vous supprimez le groupe après avoir créé la règle, aucune exception n’est faite pour ZAP pour Teams pour les messages envoyés aux membres du groupe.
Pour vider la liste, utilisez la valeur $null pour ce paramètre.
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 |
-Identity
Applicable : Exchange Online
Le paramètre Identity spécifie la règle de stratégie de protection Teams que vous souhaitez modifier. Il n’existe qu’une seule règle de stratégie de protection Teams dans une organization nommée Règle de stratégie de protection Teams.
Propriétés du paramètre
| Type: | RuleIdParameter |
| 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: | True |
| Valeur du pipeline par nom de propriété: | True |
| 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.