Update-SafeList (RTM)

S’applique à : Exchange Server 2007

Dernière rubrique modifiée : 2008-06-17

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> [-DomainController <Fqdn>] [-Type <SafeSenders | SafeRecipients | Both>]

Description détaillée

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

• 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 Server 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
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 Application Mode (ADAM) locale.
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. Important : 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.

Types d'entrées

Types de retours

Erreurs

Exceptions

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.

Attention :
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