Partager via


Update-SafeList

 

S’applique à : Exchange Server 2007 SP3, Exchange Server 2007 SP2, Exchange Server 2007 SP1

Dernière rubrique modifiée : 2008-07-18

La cmdlet Update-SafeList permet de mettre à jour les données d'agrégation de listes fiables dans le service d'annuaire Active Directory. Les données d'agrégation de listes fiables sont utilisées pour le filtrage du courrier indésirable dans Microsoft Exchange Server 2007. EdgeSync réplique les données d'agrégation de listes fiables sur des ordinateurs sur lesquels le rôle serveur de transport Edge est installé.

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 Office Outlook, puis les hache et les écrit dans l'objet utilisateur correspondant dans Active Directory. 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.

Vous pouvez utiliser le paramètre Type pour spécifier si vous voulez mettre à jour la liste des expéditeurs approuvés ou la liste des destinataires approuvés de l'utilisateur Outlook ou les deux. Toutefois, seules les données de la liste des expéditeurs approuvés sont utilisées par la fonction d'agrégation des listes fiables qui n'agit pas sur les données de la liste des destinataires approuvés. C'est pourquoi, afin de réduire la surcharge de stockage et de réplication dans Active Directory, il n'est pas recommandé d'exécuter le paramètre Type avec les valeurs SafeRecipients ou Both dans Exchange 2007. La valeur par défaut du paramètre Type est SafeSenders.

Pour plus d'informations sur le fonctionnement de l'agrégation de listes fiables, consultez la rubrique Agrégation de listes fiables.

Syntaxe

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

Description détaillée

Pour exécuter la cmdlet Update-SafeList, vous devez utiliser un compte auquel ont été délégués :

  • le rôle Administrateurs Affichage seul d'Exchange ;

  • le rôle Administrateur des destinataires Exchange.

Pour plus d'informations sur les autorisations, la délégation de rôles et les droits requis pour administrer Exchange 2007, consultez la rubrique Considérations relatives aux autorisations.

Paramètres

Paramètre Obligatoire Type Description

Identity

Obligatoire

Microsoft.Exchange.Configuration.Tasks.MailboxIdParameter

Ce paramètre permet de spécifier la boîte aux lettres d'utilisateur Outlook à partir de laquelle vous voulez collecter des données d'agrégation de listes fiables. Les entrées valides pour ce paramètre incluent les valeurs suivantes :

  • GUID

  • Nom unique

  • Domaine\Compte

  • UPN

  • LegacyExchangeDN

  • SmtpAddress

  • Alias

Confirm

Facultatif

System.Management.Automation.SwitchParameter

Le paramètre Confirm suspend le traitement par la commande et vous demande de confirmer les actions que la commande va exécuter avant de continuer le traitement. Il n'est pas nécessaire de spécifier une valeur pour le paramètre Confirm.

DomainController

Facultatif

Microsoft.Exchange.Data.Fqdn

Pour spécifier le nom de domaine complet (FQDN) du contrôleur de domaine qui écrit ce changement de configuration dans Active Directory, incluez le paramètre DomainController dans la commande. Le paramètre DomainController n'est pas pris en charge sur les ordinateurs sur lesquels le rôle serveur de transport Edge est installé. Le rôle serveur de transport Edge écrit uniquement sur l'instance Active Directory ADAM locale.

IncludeDomains

Facultatif

System.Management.Automation.SwitchParameter

Ce paramètre permet d'inclure les domaines de l'expéditeur spécifiés par les utilisateurs dans Outlook dans les listes fiables regroupées. 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

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

importantImportant :
Dans Exchange 2007, 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 paramètre WhatIf donne pour instruction à la commande de simuler les actions qu'elle va appliquer à l'objet. Grâce au paramètre WhatIf, vous pouvez afficher des changements potentiels sans devoir les appliquer. Il n'est pas nécessaire de spécifier une valeur pour le paramètre WhatIf.

Types d'entrées

Types de retours

Erreurs

Erreur Description

  

 

Exceptions

Exceptions Description

 

 

Exemple

Le premier exemple montre comment mettre à jour les données de la liste des expéditeurs approuvés pour un utilisateur, KimA, en utilisant la cmdlet Update-SafeList.

Le deuxième exemple montre comment mettre à jour toutes les données de listes fiables pour tous les utilisateurs de boîte aux lettres au sein 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. C'est pourquoi, pour extraire toutes les boîtes aux lettres de votre organisation Exchange, vous devez définir la valeur de $AdminSessionAdSettings.ViewEntireForest sur $True. Ensuite, vous pouvez exécuter la cmdlet Get-Mailbox et canaliser sa sortie vers la cmdlet Update-Safelist pour mettre à jour toutes les données de listes fiables de tous les utilisateurs de boîte aux lettres au sein de votre organisation Exchange.

CautionAttention :
Lorsque vous modifiez la valeur de $AdminSessionAdSettings.ViewEntireForest, la nouvelle valeur est conservée jusqu'à ce que vous fermiez la session Exchange Management Shell en cours. Il est recommandé de définir $AdminSessionAdSettings.ViewEntireForest sur $False juste après avoir exécuté la tâche visant à éviter de modifier ou d'extraire involontairement des objets hors de la portée souhaitée.
Update-Safelist -Identity KimA

AdminSessionAdSettings.ViewEntireForest = $True
get-mailbox -ResultSize Unlimited | where {$_.RecipientType -eq [Microsoft.Exchange.Data.Directory.Recipient.RecipientType]::UserMailbox } | update-safelist