New-ReportSubmissionRule
Cette cmdlet est disponible uniquement dans le service cloud.
Utilisez l’applet de commande New-ReportSubmissionRule pour créer la règle de soumission de rapport dans votre organization cloud. La règle de soumission de rapport identifie la boîte aux lettres de rapport dans laquelle les messages signalés par l’utilisateur sont remis.
Remarque : Si la règle existe déjà (l’applet de commande Get-ReportSubmissionRule retourne une sortie), vous ne pouvez pas utiliser cette applet de commande. Pour supprimer la règle existante et recommencer, utilisez d’abord l’applet de commande Remove-ReportSubmissionRule.
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-ReportSubmissionRule
[-Name] <String>
-ReportSubmissionPolicy <ReportSubmissionPolicyIdParameter>
[-Comments <String>]
[-Confirm]
[-Enabled <Boolean>]
[-SentTo <RecipientIdParameter[]>]
[-WhatIf]
[<CommonParameters>]
Description
Vous pouvez utiliser cette applet de commande uniquement si les instructions suivantes sont vraies :
- La règle de soumission de rapport n’existe pas (l’applet de commande Get-ReportSubmissionRule ne retourne aucune sortie).
- La stratégie de soumission de rapport existe (l’applet de commande Get-ReportSubmissionPolicy retourne une sortie).
Le paramètre SentTo identifie l’adresse e-mail de la boîte aux lettres de rapport. Votre organization a besoin d’une règle de soumission de rapport uniquement pour envoyer des messages signalés par l’utilisateur à la boîte aux lettres de création de rapports à l’aide des outils de création de rapports Microsoft ou non-Microsoft dans Outlook (la création de rapports dans Outlook est activée).
Lorsque vous définissez l’adresse e-mail de la boîte aux lettres de création de rapports dans le portail Microsoft Defender à l’adresse https://security.microsoft.com/securitysettings/userSubmission, la même adresse e-mail est également définie dans les applets de commande *-ReportSubmissionPolicy :
- Rapports intégrés Microsoft à l’aide des outils de création de rapports Microsoft dans Outlook : ReportJunkAddresses, ReportNotJunkAddresses et ReportPhishAddresses (les trois doivent avoir la même valeur).
- Rapports intégrés Microsoft à l’aide d’outils de création de rapports non-Microsoft dans Outlook : ThirdPartyReportAddresses.
Lorsque vous utilisez cette applet de commande pour définir l’adresse e-mail de la boîte aux lettres de création de rapports, les paramètres correspondants dans les applets de commande *-ReportSubmissionPolicy ne sont pas mis à jour.
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-ReportSubmissionRule -Name DefaultReportSubmissionRule -ReportSubmissionPolicy DefaultReportSubmissionPolicy -SentTo "userreportedmessages@contoso.onmicrosoft.com"
Cet exemple crée la règle de soumission de rapport. La boîte aux lettres de création de rapports est userreportedmessages@contoso.onmicrosoft.com.
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
Le paramètre Enabled spécifie si la règle est activée ou désactivée. Les valeurs valides sont les suivantes :
- $true : la règle est activée. Cette valeur est la valeur par défaut.
- $false : la règle est désactivée.
Après avoir créé la règle, utilisez les applets de commande Enable-ReportSubmissionRule et Disable-ReportSubmissionRule pour activer ou désactiver la règle.
Propriétés du paramètre
| Type: | Boolean |
| 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 de la règle de soumission du rapport. Lorsque la règle est créée automatiquement, le nom de la règle est DefaultReportSubmissionRule. Nous vous recommandons d’utiliser cette valeur pour éviter toute confusion.
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: | 0 |
| Obligatoire: | True |
| Valeur du pipeline: | False |
| Valeur du pipeline par nom de propriété: | False |
| Valeur des arguments restants: | False |
-ReportSubmissionPolicy
Applicable : Exchange Online
Le paramètre ReportSubmissionPolicy spécifie la stratégie de soumission de rapport associée à cette règle. La seule stratégie disponible est nommée DefaultReportSubmissionPolicy.
Propriétés du paramètre
| Type: | ReportSubmissionPolicyIdParameter |
| 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 |
-SentTo
Applicable : Exchange Online
Le paramètre SentTo spécifie l’adresse e-mail de la boîte aux lettres de création de rapports dans Exchange Online où les messages signalés par l’utilisateur sont envoyés.
La valeur de ce paramètre n’est significative que si la création de rapports dans Outlook est activée et que les messages signalés par les utilisateurs sont envoyés à une boîte aux lettres de création de rapports comme configuré dans les applets de commande *-ReportSubmissionPolicy (l’un des scénarios suivants) :
- Les rapports intégrés Microsoft sont activés à l’aide des outils de création de rapports Microsoft dans Outlook :
-EnableThirdPartyAddress $false -ReportJunkToCustomizedAddress $true -ReportNotJunkToCustomizedAddress $true -ReportPhishToCustomizedAddress $true. - La création de rapports intégrées à Microsoft est activée à l’aide d’outils de création de rapports non-Microsoft dans Outlook :
-EnableReportToMicrosoft $false -EnableThirdPartyAddress $true -ReportJunkToCustomizedAddress $false -ReportNotJunkToCustomizedAddress $false -ReportPhishToCustomizedAddress $false.
Si vous définissez l’adresse e-mail de la boîte aux lettres de création de rapports dans le portail Microsoft Defender, les paramètres suivants dans les applets de commande *-ReportSubmissionPolicy sont définis sur la même valeur :
- Rapports intégrés Microsoft à l’aide des outils de création de rapports Microsoft dans Outlook : ReportJunkAddresses, ReportNotJunkAddresses et ReportPhishAddresses (les trois doivent avoir la même valeur).
- Rapports intégrés Microsoft à l’aide d’outils de création de rapports non-Microsoft dans Outlook : ThirdPartyReportAddresses.
Lorsque vous utilisez cette applet de commande pour définir l’adresse e-mail de la boîte aux lettres de création de rapports, les valeurs de paramètre associées dans les applets de commande *-ReportSubmissionPolicy ne sont pas mises à jour, ce qui n’affecte pas les fonctionnalités de la boîte aux lettres de création de rapports. Vous devez mettre à jour les valeurs associées dans les applets de commande *-ReportSubmissionPolicy pour assurer la cohérence et éviter toute confusion.
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 |
-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.