Update-Recipient
S’applique à : Exchange Server 2007 SP3, Exchange Server 2007 SP2, Exchange Server 2007 SP1
Dernière rubrique modifiée : 2007-07-18
La cmdlet Update-Recipient permet d'ajouter les attributs Microsoft Exchange Server 2007 aux objets destinataires créés par l'agent de gestion de synchronisation de liste d'adresses globale (LAG) dans le gestionnaire Identity Lifecycle Manager (ILM) 2007. Les objets destinataires modifiés à l'aide de cette cmdlet doivent résider sur un serveur Exchange 2007.
Syntaxe
Update-Recipient -Identity <RecipientIdParameter> [-Confirm [<SwitchParameter>]] [-Credential <PSCredential>] [-DomainController <Fqdn>] [-Server <ServerIdParameter>] [-WhatIf [<SwitchParameter>]]
Description détaillée
À cause des fusions et des achats ou des exigences légales, les clients peuvent avoir besoin de déployer Exchange dans plusieurs topologies de forêts Exchange. Ces déploiements requièrent la synchronisation des objets destinataires au sein des forêts de service d'annuaire Active Directory disparates. Pour plus d'informations sur les topologies de forêts Exchangemultiples, consultez la rubrique Planification d'une organisation Exchange complexe.
Microsoft fournit l'agent de gestion de synchronisation de LAG pour synchroniser les objets destinataires. La version de l'agent de gestion de synchronisation de LAG incluse dans le serveur Microsoft Identity Integration Server (MIIS) 2003 a été conçue pour fonctionner avec Exchange Server 2003 et utiliser le service de mise à jour de destinataire (RUS). Parce que le RUS est une fonction obsolète qui n'est plus requise pour Exchange 2007, le nouvel agent de gestion de synchronisation de LAG inclus dans ILM 2007 est conçu pour fonctionner sans le RUS.
Dans le processus de synchronisation, l'agent de gestion de synchronisation de LAG de ILM 2007 crée des objets destinataires dans les deux forêts Active Directory. Après la création des destinataires, l'agent de gestion utilise la cmdlet Update-Recipient pour ajouter les attributs requis par Exchange 2007 afin d'achever la mise en service de ces destinataires.
Notes
Si vous utilisez MIIS 2003, vous devez exécuter différentes cmdlets pour achever la mise en service des contacts de messagerie créés par l'agent de gestion de synchronisation de LAG. Pour plus d'informations sur la mise en service de contacts de messagerie créés par MIIS 2003, consultez la rubrique Procédure de déploiement d'Exchange 2007 dans une topologie inter-forêts. La cmdlet Update-Recipient fournit une autre méthode plus efficace pour effectuer cela. Vous pouvez tout simplement exécuter la cmdlet Update-Recipient avec les objets destinataires créés par l'agent de gestion de synchronisation de LAG de MIIS 2003 GAL pour achever le processus de mise en service.
Pour exécuter la cmdlet Update-Recipient, vous devez utiliser un compte auquel a été délégué :
- 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.RecipientIdParameter |
Le paramètre Identity identifie le destinataire. Vous pouvez utiliser l'une des valeurs suivantes :
|
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. |
Credential |
Facultatif |
System.Management.Automation.PSCredential |
Le paramètre Credential spécifie le nom et le mot de passe d'utilisateur à utiliser pour accéder à Active Directory. En cas d'utilisation du paramètre Credential, la commande vous invite à taper le mot de passe du compte avant de continuer. |
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. |
Server |
Facultatif |
Microsoft.Exchange.Configuration.Tasks.ServerIdParameter |
Le paramètre Server spécifie le serveur sur lequel exécuter les opérations sélectionnées. |
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 renvois
Erreurs
| Erreur | Description |
|---|---|
|
Exemple
Le premier exemple présente l'utilisation de la cmdlet Update-Recipient pour ajouter les attributs Exchange 2007 au contact de messagerie représentant la boîte aux lettres de John Smith.
Le deuxième exemple présente la mise à jour de tous les contacts dans une unité d'organisation (UO). Cet exemple suppose que les destinataires sont synchronisés entre deux forêts, contoso.com et fabrikam.com, et que tous les destinataires synchronisés du domaine fabrikam.com sont enregistrés dans une UO spécifique appelée fabrikam.com Users dans le domaine contoso.com.
Update-Recipient -Identity "John Smith"
Get-MailContact -OrganizationalUnit "contoso.com/fabrikam.com Users" | Update-Recipient