Update-SafeList

 

S’applique à :Exchange Server 2016

Dernière rubrique modifiée :2016-03-31

Cette cmdlet est disponible uniquement dans Exchange Server 2016 sur site.

La cmdlet Update-SafeList permet de mettre à jour les données d'agrégation de listes fiables dans Active Directory. Les données d’agrégation de listes fiables sont utilisées pour le filtrage du courrier indésirable intégré dans Microsoft Exchange. EdgeSync réplique ces données sur les serveurs de transport Edge dans le réseau de périmètre.

Update-SafeList -Identity <MailboxIdParameter> [-Confirm [<SwitchParameter>]] [-DomainController <Fqdn>] [-EnsureJunkEmailRule <SwitchParameter>] [-IncludeDomains <SwitchParameter>] [-Type <SafeSenders | SafeRecipients | Both | BlockedSenders | All>] [-WhatIf [<SwitchParameter>]]

Cet exemple met à jour les données la liste des expéditeurs approuvés pour l'utilisateur unique kim@contoso.com.

Update-Safelist kim@contoso.com

Cet exemple met à jour les données de listes fiables de toutes les boîtes aux lettres utilisateur de votre organisation Exchange. Par défaut, Exchange Management Shell est configuré pour extraire ou modifier des objets résidant dans le domaine dans lequel réside le serveur Exchange. Par conséquent, pour récupérer toutes les boîtes aux lettres de votre organisation Exchange, vous devez tout d'abord définir l'étendue de l'environnement de ligne de commande à la forêt entière à l'aide de la cmdlet Set-AdServerSettings. Pour plus d'informations, voir Set-AdServerSettings.

Set-AdServerSettings -ViewEntireForest $true
Get-Mailbox -ResultSize Unlimited -RecipientTypeDetails UserMailbox | Update-Safelist

La cmdlet Update-SafeList lit les données d’agrégation de listes fiables stockées dans une boîte aux lettres d’utilisateur Microsoft Outlook, puis procède au hachage et à l’écriture des données dans l’objet utilisateur correspondant dans Active Directory. La commande compare l’attribut binaire créé à une valeur stockée sur l’attribut. Si les deux valeurs sont identiques, la commande ne met pas à jour la valeur d’attribut de l’utilisateur avec les données d’agrégation de listes fiables. Les données d'agrégation de listes fiables contiennent les listes des expéditeurs approuvés et des destinataires approuvés de l'utilisateur Outlook.

Tenez compte du trafic réseau et de réplication que vous pouvez générer lors de l’exécution de la cmdlet Update-SafeList. Si vous exécutez la commande sur plusieurs boîtes aux lettres utilisant intensément les listes fiables, le volume de trafic généré peut être considérable. Si vous exécutez la commande sur plusieurs boîtes aux lettres, nous vous recommandons de le faire en dehors des heures de pointe et de travail.

Des autorisations doivent vous être attribuées avant de pouvoir exécuter cette cmdlet. Bien que tous les paramètres de cette cmdlet soient répertoriés dans cette rubrique, 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 voir les autorisations qui vous sont nécessaires, voir Entrée « Agrégation de listes fiables » dans la rubrique Autorisations de flux de messagerie.

 

Paramètre Obligatoire Type Description

Identity

Obligatoire

Microsoft.Exchange.Configuration.Tasks.MailboxIdParameter

Le paramètre Identity permet de spécifier la boîte aux lettres à partir de laquelle vous voulez collecter des données d’agrégation de listes fiables.

Ce paramètre accepte les valeurs suivantes :

  • Alias

    Exemple : JPhillips

  • Canonical DN

    Exemple : Atlanta.Corp.Contoso.Com/Users/JPhilips

  • Display Name

    Exemple : Jeff Philips

  • Distinguished Name (DN)

    Exemple : CN = JPhillips, CN = Users, DC = Atlanta, DC = Corp, DC = contoso, DC = com

  • Domain\Account

    Exemple : Atlanta\JPhillips

  • GUID

    Exemple : fb456636-fe7d-4d58-9d15-5af57d0354c2

  • Immutable ID

    Exemple : fb456636-fe7d-4d58-9d15-5af57d0354c2@contoso.com

  • Legacy Exchange DN

    Exemple : /o=Contoso/ou=AdministrativeGroup/cn=Recipients/cn=JPhilips

  • SMTP Address

    Exemple : Jeff.Phillips@contoso.com

  • User Principal Name

    Exemple : JPhillips@contoso.com

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.

DomainController

Facultatif

Microsoft.Exchange.Data.Fqdn

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.

EnsureJunkEmailRule

Facultatif

System.Management.Automation.SwitchParameter

Le paramètre EnsureJunkEmailRule spécifie si l’activation de la règle de courrier indésirable pour la boîte aux lettres doit être forcée si la règle n’est pas déjà activée.

noteRemarque :
La règle de courrier indésirable peut uniquement être créée une fois que l’utilisateur s’est connecté à la boîte aux lettres. Si l’utilisateur n’a jamais ouvert de session sur la boîte aux lettres, ce paramètre ne peut pas activer la règle de courrier indésirable.

IncludeDomains

Facultatif

System.Management.Automation.SwitchParameter

Le commutateur IncludeDomains spécifie si les domaines de l’expéditeur spécifiés par les utilisateurs d’Outlook dans les données d’agrégation de listes fiables doivent être inclus. Par défaut, les domaines spécifiés par les expéditeurs ne sont pas inclus.

Dans la plupart des cas, il n'est pas recommandé d'inclure des domaines car les utilisateurs risquent d'inclure des domaines de fournisseurs de services Internet (ISP) de premier plan, qui pourraient involontairement fournir des adresses susceptibles d'être utilisées ou falsifiées par des expéditeurs de courrier indésirable.

Type

Facultatif

Microsoft.Exchange.Management.RecipientTasks.UpdateType

Le paramètre Type permet de spécifier la liste générée par l’utilisateur qui est mise à jour vers l’objet utilisateur. Les valeurs valides pour ce paramètre sont SafeSenders, SafeRecipients et Both. La valeur par défaut est SafeSenders.

importantImportant :
La fonction d’agrégation de listes fiables n’agit pas sur les données de la liste des destinataires approuvés. Il n'est pas recommandé d'exécuter le paramètre Type avec les valeurs SafeRecipients ou Both.

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: