Update-AddressList
S’applique à : Exchange Server 2007 SP3, Exchange Server 2007 SP2, Exchange Server 2007 SP1
Dernière rubrique modifiée : 2009-05-12
La cmdlet Update-AddressList permet de mettre à jour les destinataires inclus dans la liste d'adresses que vous spécifiez.
Syntaxe
update-AddressList -Identity <AddressListIdParameter> [-Confirm [<SwitchParameter>]] [-DomainController <Fqdn>] [-UseRusServer <String>] [-WhatIf [<SwitchParameter>]]
Description détaillée
Pour exécuter la cmdlet Update-AddressList, vous devez utiliser un compte auquel a été délégué :
- le rôle Administrateur d'organisation 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.
En fonction de la taille de votre organisation Exchange, plusieurs heures peuvent être nécessaires pour effectuer cette opération.
Paramètres
| Paramètre | Obligatoire | Type | Description |
|---|---|---|---|
Identity |
Obligatoire |
Microsoft.Exchange.Configuration.Tasks.AddressListIdParameter |
Le paramètre Identity permet de spécifier le GUID, le nom unique ou le nom de liste d'adresses représentant une liste d'adresses spécifique. Vous pouvez également inclure le chemin d'accès en utilisant le format Chemin\Nom_liste_adresses. Vous pouvez omettre l'étiquette de paramètre Identity de façon à ne fournir que le nom de liste d'adresses ou le GUID. |
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 |
Ce paramètre spécifie le contrôleur de domaine à utiliser pour apporter les modifications aux destinataires de cette liste d'adresses dans Active Directory. |
UseRusServer |
Facultatif |
System.String |
> [!Note]
> Ce paramètre n'est disponible que dans Exchange 2007 SP2.
Le paramètre UseRusServer indique à la commande d'utiliser le serveur de boîtes aux lettres spécifié sur lequel le service de listes d'adresses est exécuté pour obtenir puis définir les attributs des boîtes aux lettres et des utilisateurs Active Directory. Le service de listes d'adresses est un composant du service Surveillance du système Exchange. Le service de listes d'adresses crée et gère les valeurs des attributs spécifiques d'Exchange dans Active Directory. Vous pouvez utiliser le service de listes d'adresses pour mettre à jour les objets destinataire dans un domaine à l'aide d'informations spécifiques telles que l'appartenance à une liste d'adresses et des adresses de messagerie. |
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
L'exemple suivant montre comment mettre à jour les destinataires de la liste d'adresses nommée « building4 » figurant dans le conteneur All Users\Sales.
Update-AddressList -Identity "All Users\Sales\building4"
La cmdlet Get-AddressList, canalisée vers Format-list, permet d'obtenir le GUID, le nom unique, ou le chemin et le nom d'une liste d'adresses existante. Vous pouvez également utiliser la cmdlet Get-AddressList pour obtenir une liste d'adresses existante spécifique, puis canaliser la sortie directement vers Update-AddressList.