Set-MailboxJunkEmailConfiguration

 

S’applique à :Exchange Online, Exchange Server 2016

Dernière rubrique modifiée :2018-01-17

Cette cmdlet est disponible dans Exchange sur site et dans le service en nuage. Certains paramètres peuvent être propres à un environnement ou à un autre.

Utilisez la cmdlet Set-MailboxJunkEmailConfiguration pour configurer les paramètres de courrier indésirable sur les boîtes aux lettres.

noteRemarque :
Vous pouvez uniquement utiliser cette cmdlet sur une boîte aux lettres ouverte dans Outlook (en mode Exchange mis en cache) ou Outlook sur le web. Si la boîte aux lettres n’a pas été ouverte, vous recevez l’erreur : The Junk Email configuration couldn't be set. The user needs to sign in to Outlook Web App before they can modify their Safe Senders and Recipients or Blocked Senders lists. Si vous voulez supprimer cette erreur pour les opérations en bloc, vous pouvez ajouter l’élément -ErrorAction SlientlyContinue à la fin de la commande.

Set-MailboxJunkEmailConfiguration -Identity <MailboxIdParameter> [-BlockedSendersAndDomains <MultiValuedProperty>] [-Confirm [<SwitchParameter>]] [-ContactsTrusted <$true | $false>] [-DomainController <Fqdn>] [-Enabled <$true | $false>] [-IgnoreDefaultScope <SwitchParameter>] [-TrustedListsOnly <$true | $false>] [-TrustedRecipientsAndDomains <MultiValuedProperty>] [-TrustedSendersAndDomains <MultiValuedProperty>] [-WhatIf [<SwitchParameter>]]

Cet exemple désactive la configuration de la règle de courrier indésirable pour l'utilisateur nommé David Pelton.

Set-MailboxJunkEmailConfiguration "David Pelton" -Enabled $false

Cet exemple apporte les modifications suivantes à la configuration de la collection de listes fiables pour l'utilisatrice nommée Michele Martin :

  • Ajoute contoso.com et fabrikam.com à la liste des expéditeurs approuvés sans modifier les autres entrées existantes.

  • Ajoute jane@fourthcoffee.com à la liste des expéditeurs bloqués sans modifier les autres entrées existantes.

Set-MailboxJunkEmailConfiguration "Michele Martin" -TrustedSendersAndDomains @{Add="contoso.com","fabrikam.com"} -BlockedSendersAndDomains @{Add="jane@fourthcoffee.com"}

Cet exemple identifie les boîtes aux lettres dans lesquelles les contacts sont traités comme des expéditeurs approuvé, puis modifie la configuration du courrier indésirable pour ne pas traiter les contacts en tant qu’expéditeurs approuvés.

Get-MailboxJunkEmailConfiguration * | Where {$_.ContactsTrusted -eq $true} | Set-MailboxJunkEmailConfiguration -ContactsTrusted $false

Cette cmdlet détermine les paramètres de courrier indésirable suivants pour la boîte aux lettres :

  • Activer ou désactiver la règle de courrier indésirable  La règle de courrier indésirable (une règle de boîte de réception masquée nommée Junk E-mail Rule) détermine la remise des messages dans le dossier de courrier indésirable ou dans la boîte de réception en fonction du seuil SCL de dossier de courrier indésirable (pour l’organisation ou la boîte aux lettres) et de la collection de listes fiables de la boîte aux lettres. Les utilisateurs peuvent activer ou désactiver la règle de courrier indésirable sur leur propre boîte aux lettres à l’aide d’Outlook sur le web.

  • Collection de listes fiables   La collection de listes fiables comprend la liste des expéditeurs approuvés, la liste des destinataires approuvés et la liste des expéditeurs bloqués. Par défaut, les utilisateurs peuvent configurer la collection de listes fiables sur leur propre boîte aux lettres à l’aide de MicrosoftOutlook ou d’Outlook sur le web.

Pour plus d’informations, reportez-vous à Configurer les paramètres de blocage du courrier indésirable Exchange sur les boîtes aux lettres.

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 nécessaires pour exécuter une cmdlet ou un paramètre dans votre organisation, consultez la rubrique Rechercher les autorisations requises pour exécuter les cmdlets Exchange.

 

Paramètre Obligatoire Type Description

Identity

Obligatoire

Microsoft.Exchange.Configuration.Tasks.MailboxIdParameter

Le paramètre Identity spécifie la boîte aux lettres que vous voulez modifier. Vous pouvez utiliser n’importe quelle valeur qui identifie de manière unique la boîte aux lettres.

Par exemple :

  • Nom

  • Nom complet

  • Alias

  • Nom unique

  • Nom unique canonique

  • <domain name>\<account name>

  • Adresse de messagerie

  • GUID

  • LegacyExchangeDN

  • SamAccountName

  • Identifiant utilisateur ou nom d’utilisateur principal (UPN)

BlockedSendersAndDomains

Facultatif

Microsoft.Exchange.Data.MultiValuedProperty

Le paramètre BlockedSendersAndDomains spécifie la liste des expéditeurs bloqués, qui est une liste d’adresses de messagerie et de domaines d’expéditeurs dont les messages sont automatiquement envoyés vers le dossier de courrier indésirable. Ce paramètre correspond au paramètre Outlook sur le web : Déplacez les messages de ces expéditeurs ou domaines vers mon dossier Courrier indésirable.

Pour saisir plusieurs valeurs et remplacer les entrées existantes, utilisez la syntaxe suivante : <value1>,<value2>.... Si les valeurs contiennent des espaces ou requièrent des guillemets, vous devez utiliser la syntaxe suivante : "<value1>","<value2>"....

Pour ajouter ou supprimer une ou plusieurs valeur(s) sans affecter les entrées existantes, utilisez la syntaxe suivante : @{Add="<value1>","<value2>"...; Remove="<value1>","<value2>"...}.

Confirm

Facultatif

System.Management.Automation.SwitchParameter

Le commutateur Confirm 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 cmdlets destructives (par exemple, les cmdlets Remove-*) ont une pause intégrée qui vous oblige à confirmer la commande avant de poursuivre. Pour ces cmdlets, vous pouvez ignorer l’invite de confirmation à l’aide de cette syntaxe exacte : -Confirm:$false.

  • La plupart des autres cmdlets (par exemple, les cmdlets 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.

ContactsTrusted

Facultatif

System.Boolean

Le paramètre ContactsTrusted spécifie si les contacts du dossier Contacts sont traités comme des expéditeurs fiables ou non. Ce paramètre correspond au paramètre Outlook sur le web : Autoriser les messages électroniques de mes contacts. Les valeurs valides sont les suivantes :

  • $true   Les messages des contacts dans le dossier Contacts qui arrivent dans la boîte aux lettres ne sont jamais envoyés vers le dossier Courrier indésirable, quel que soit leur contenu.

  • $false   Les messages des contacts dans le dossier Contacts ne sont pas traités comme des expéditeurs fiables. L’adresse de messagerie est un expéditeur approuvé uniquement si elle est définie dans la liste des expéditeurs fiables. Il s’agit de la valeur par défaut.

DomainController

Facultatif

Microsoft.Exchange.Data.Fqdn

Ce paramètre est disponible uniquement dans Exchange sur site.

Le paramètre DomainController spécifie le contrôleur de domaine qui est utilisé par cette cmdlet pour lire ou écrire les données dans Active Directory. Vous identifiez le contrôleur de domaine par son nom de domaine complet (FQDN). Par exemple : dc01.contoso.com.

Enabled

Facultatif

System.Boolean

Le paramètre Enabled active ou désactive la règle de courrier indésirable sur la boîte aux lettres (une règle de boîte de réception masquée nommée Junk E-mail Rule). Les valeurs valides sont les suivantes :

  • $true   La règle de courrier indésirable est activée dans la boîte aux lettres. Cette valeur correspond au paramètre Outlook sur le web : Filtrer automatiquement le courrier indésirable. Il s’agit de la valeur par défaut.

    Exchange utilise la collection de listes fiables de la boîte aux lettres (la liste des expéditeurs approuvés, la liste des destinataires approuvés et la liste des expéditeurs bloqués) et le seuil SCL de dossier de courrier indésirable (pour l’organisation ou la boîte aux lettres) pour remettre des messages dans la boîte de réception ou le dossier de courrier indésirable.

  • $false   La règle de courrier indésirable est désactivée dans la boîte aux lettres. Cette valeur correspond au paramètre Outlook sur le web : Ne pas déplacer les messages vers mon dossier Courrier indésirable. Exchange n’utilise pas la collection de listes fiables de la boîte aux lettres ou le seuil SCL de dossier de courrier indésirable pour remettre des messages dans la boîte de réception ou le dossier de courrier indésirable.

Vous pouvez afficher l’état de la règle de courrier indésirable en exécutant l’une des commandes suivantes pour rechercher la valeur de propriété Enabled :

  • Get-MailboxJunkEmailConfiguration <MailboxIdentity>

  • Get-InboxRule "Junk E-mail Rule" -Mailbox <MailboxIdentity> -IncludeHidden

Vous utilisez le paramètre JunkEmailEnabled sur les cmdlets Set-OwaMailboxPolicy ou Set-OwaVirtualDirectory pour contrôler la disponibilité des paramètres de courrier indésirable dans Outlook sur le web.

noteRemarque :
L’état de la règle de courrier indésirable sur la boîte aux lettres ne modifie pas la disponibilité des paramètres de courrier indésirable côté client dans le filtre de courrier indésirable Outlook. Même si la règle de courrier indésirable est désactivée dans la boîte aux lettres, Outlook peut quand même déplacer des messages vers le dossier de courrier indésirable. Par exemple, si Outlook détermine que le message est un courrier indésirable, ou si l’expéditeur est répertorié dans la liste des expéditeurs bloqués, Outlook peut déplacer le message vers le dossier de courrier indésirable. Pour plus d’informations, reportez-vous à Configurer les paramètres du courrier indésirable dans Outlook 2013.

IgnoreDefaultScope

Facultatif

System.Management.Automation.SwitchParameter

Le commutateur IgnoreDefaultScope donne pour instruction à la commande d’ignorer le paramétrage de l’étendue du destinataire par défaut pour la session Exchange Management Shell et d’utiliser l’ensemble de la forêt comme étendue. Cela permet à la commande d’accéder à des objets Active Directory ne figurant pas actuellement dans l’étendue par défaut.

L’utilisation du commutateur IgnoreDefaultScope introduit les restrictions suivantes :

  • Vous ne pouvez pas utiliser le paramètre DomainController. La commande utilise automatiquement un serveur de catalogue global approprié.

  • Vous ne pouvez utiliser que le nom unique pour le paramètre Identity. D'autres formes d'identification, telles qu'un alias ou un GUID, ne sont pas acceptées.

TrustedListsOnly

Facultatif

System.Boolean

Le paramètre TrustedListsOnly spécifie que seuls les messages provenant d’expéditeurs figurant sur la liste des expéditeurs approuvés sont remis dans la boîte de réception. Tous les autres messages sont traités comme du courrier indésirable. Ce paramètre correspond au paramètre Outlook sur le web : Uniquement faire confiance aux messages électroniques s'ils proviennent de la liste verte et de la liste de destinataires. Les valeurs valides sont les suivantes :

  • $true   Seuls les messages provenant d’entrées d’adresse de messagerie ou de domaine figurant dans la liste des expéditeurs approuvés et la liste des destinataires approuvés sont remis dans la boîte de réception. Tous les autres messages sont automatiquement envoyés vers le dossier de courrier indésirable.

  • $false   Les messages provenant d’autres expéditeurs, destinataires et domaines ne sont pas automatiquement traités comme du courrier indésirable et sont évalués individuellement. Il s’agit de la valeur par défaut.

TrustedRecipientsAndDomains

Facultatif

Microsoft.Exchange.Data.MultiValuedProperty

Ce paramètre est réservé à l’usage interne chez Microsoft.

TrustedSendersAndDomains

Facultatif

Microsoft.Exchange.Data.MultiValuedProperty

Le paramètre TrustedSendersAndDomains spécifie la liste des expéditeurs approuvés et la liste des destinataires approuvés, qui sont des listes d’adresses de messagerie et de domaines. Les messages provenant de ces expéditeurs qui arrivent dans la boîte aux lettres ne sont jamais envoyés vers le dossier de courrier indésirable, quel que soit leur contenu. Ce paramètre correspond au paramètre Outlook sur le web : Ne pas déplacer les messages de ces expéditeurs ou domaines vers mon dossier Courrier indésirable.

Pour saisir plusieurs valeurs et remplacer les entrées existantes, utilisez la syntaxe suivante : <value1>,<value2>.... Si les valeurs contiennent des espaces ou requièrent des guillemets, vous devez utiliser la syntaxe suivante : "<value1>","<value2>"....

Pour ajouter ou supprimer une ou plusieurs valeur(s) sans affecter les entrées existantes, utilisez la syntaxe suivante : @{Add="<value1>","<value2>"...; Remove="<value1>","<value2>"...}.

Pour vider la liste des domaines et des adresses de messagerie, utilisez la valeur $null.

Remarques :

  • Toutes les adresses de messagerie répertoriées dans la liste d’adresses globale (LAG) sont automatiquement considérées comme des expéditeurs approuvés. Vous n’avez donc pas besoin de les ajouter à la liste.

  • Vous ne pouvez pas modifier directement la liste des destinataires approuvés à l’aide de cette cmdlet. Ce paramètre vous permet de modifier la liste des expéditeurs approuvés. En outre, les adresses de messagerie et les domaines sont synchronisés avec la liste des destinataires approuvés.

  • Les domaines approuvés ne sont pas reconnus dans Exchange Online ni dans Exchange Online Protection. Pour plus d’informations, reportez-vous à l’article Des domaines de la liste des expéditeurs approuvés Outlook ne sont pas reconnus par Exchange Online ou Exchange Online Protection.

WhatIf

Facultatif

System.Management.Automation.SwitchParameter

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.

Pour visualiser les types d’entrées acceptés par cette cmdlet, consultez la rubrique Types d’entrée et de sortie de la cmdlet d’Exchange Management Shell. Si le champ Type d’entrée pour une cmdlet est vide, la cmdlet n’accepte pas les données d’entrée.

Pour visualiser les types de retours, également appelés types de sorties, acceptés par cette cmdlet, consultez la rubrique Types d’entrée et de sortie de la cmdlet d’Exchange Management Shell. Si le champ Type de sortie est vide, la cmdlet ne renvoie pas de données.

 
Afficher: