Set-AddressList

Article
09/30/2014

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

Dernière rubrique modifiée : 2009-05-12

La cmdlet Set-AddressList permet de modifier une liste d'adresses existante.

Syntaxe

Set-AddressList -Identity <AddressListIdParameter> [-ConditionalCompany <MultiValuedProperty>] [-ConditionalCustomAttribute1 <MultiValuedProperty>] [-ConditionalCustomAttribute10 <MultiValuedProperty>] [-ConditionalCustomAttribute11 <MultiValuedProperty>] [-ConditionalCustomAttribute12 <MultiValuedProperty>] [-ConditionalCustomAttribute13 <MultiValuedProperty>] [-ConditionalCustomAttribute14 <MultiValuedProperty>] [-ConditionalCustomAttribute15 <MultiValuedProperty>] [-ConditionalCustomAttribute2 <MultiValuedProperty>] [-ConditionalCustomAttribute3 <MultiValuedProperty>] [-ConditionalCustomAttribute4 <MultiValuedProperty>] [-ConditionalCustomAttribute5 <MultiValuedProperty>] [-ConditionalCustomAttribute6 <MultiValuedProperty>] [-ConditionalCustomAttribute7 <MultiValuedProperty>] [-ConditionalCustomAttribute8 <MultiValuedProperty>] [-ConditionalCustomAttribute9 <MultiValuedProperty>] [-ConditionalDepartment <MultiValuedProperty>] [-ConditionalStateOrProvince <MultiValuedProperty>] [-Confirm [<SwitchParameter>]] [-DisplayName <String>] [-DomainController <Fqdn>] [-ForceUpgrade <SwitchParameter>] [-IncludedRecipients <Nullable>] [-Name <String>] [-RecipientFilter <String>] [-UseRusServer <String>] [-WhatIf [<SwitchParameter>]]

Set-AddressList [-ConditionalCompany <MultiValuedProperty>] [-ConditionalCustomAttribute1 <MultiValuedProperty>] [-ConditionalCustomAttribute10 <MultiValuedProperty>] [-ConditionalCustomAttribute11 <MultiValuedProperty>] [-ConditionalCustomAttribute12 <MultiValuedProperty>] [-ConditionalCustomAttribute13 <MultiValuedProperty>] [-ConditionalCustomAttribute14 <MultiValuedProperty>] [-ConditionalCustomAttribute15 <MultiValuedProperty>] [-ConditionalCustomAttribute2 <MultiValuedProperty>] [-ConditionalCustomAttribute3 <MultiValuedProperty>] [-ConditionalCustomAttribute4 <MultiValuedProperty>] [-ConditionalCustomAttribute5 <MultiValuedProperty>] [-ConditionalCustomAttribute6 <MultiValuedProperty>] [-ConditionalCustomAttribute7 <MultiValuedProperty>] [-ConditionalCustomAttribute8 <MultiValuedProperty>] [-ConditionalCustomAttribute9 <MultiValuedProperty>] [-ConditionalDepartment <MultiValuedProperty>] [-ConditionalStateOrProvince <MultiValuedProperty>] [-Confirm [<SwitchParameter>]] [-DisplayName <String>] [-DomainController <Fqdn>] [-ForceUpgrade <SwitchParameter>] [-IncludedRecipients <Nullable>] [-Instance <AddressList>] [-Name <String>] [-RecipientFilter <String>] [-UseRusServer <String>] [-WhatIf [<SwitchParameter>]]

Description détaillée

Pour exécuter la cmdlet Set-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 Microsoft Exchange Server 2007, consultez la rubrique Considérations relatives aux autorisations.

Si vous voulez utiliser la console de gestion Exchange pour gérer les listes d'adresses créées dans Exchange Server 2003 ou Exchange 2000 Server, procédez comme suit :

Mettez à jour l'attribut de version de la liste d'adresses à l'aide du paramètre ForceUpgrade.
Modifiez le filtre destinataire à l'aide soit du paramètre RecipientFilter, soit de l'un des paramètres de filtre suivants :
- ConditionalCompany
- ConditionalDepartment
- ConditionalStateOrProvince
- IncludedRecipients

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.
ConditionalCompany	Facultatif	Microsoft.Exchange.Data.MultiValuedProperty	Le paramètre ConditionalCompany est un filtre permettant de spécifier une société. Tous les destinataires ayant un attribut company correspondant à la valeur que vous entrez pour ce paramètre sont inclus dans la liste d'adresses que vous modifiez. Vous pouvez utiliser plusieurs valeurs sous la forme d'une liste délimitée par des virgules. Vous devez utiliser le paramètre IncludedRecipients si vous utilisez un paramètre Conditional. Vous ne pouvez pas utiliser ce paramètre si vous utilisez le paramètre RecipientFilter.
ConditionalCustomAttribute1	Facultatif	Microsoft.Exchange.Data.MultiValuedProperty	Le paramètre ConditionalCustomAttribute1 spécifie des attributs personnalisés. Les attributs personnalisés permettent d’ajouter des informations supplémentaires dans la liste d’adresses grâce auxquelles vous pouvez trier ou grouper les listes d’adresses. Vous devez utiliser le paramètre IncludedRecipients si vous utilisez un paramètre Conditional. Vous ne pouvez pas utiliser ce paramètre si vous utilisez le paramètre RecipientFilter.
ConditionalCustomAttribute10	Facultatif	Microsoft.Exchange.Data.MultiValuedProperty	Le paramètre ConditionalCustomAttribute10 spécifie des attributs personnalisés. Les attributs personnalisés permettent d’ajouter des informations supplémentaires dans la liste d’adresses grâce auxquelles vous pouvez trier ou grouper les listes d’adresses. Vous devez utiliser le paramètre IncludedRecipients si vous utilisez un paramètre Conditional. Vous ne pouvez pas utiliser ce paramètre si vous utilisez le paramètre RecipientFilter.
ConditionalCustomAttribute11	Facultatif	Microsoft.Exchange.Data.MultiValuedProperty	Le paramètre ConditionalCustomAttribute11 spécifie des attributs personnalisés. Les attributs personnalisés permettent d’ajouter des informations supplémentaires dans la liste d’adresses grâce auxquelles vous pouvez trier ou grouper les listes d’adresses. Vous devez utiliser le paramètre IncludedRecipients si vous utilisez un paramètre Conditional. Vous ne pouvez pas utiliser ce paramètre si vous utilisez le paramètre RecipientFilter.
ConditionalCustomAttribute12	Facultatif	Microsoft.Exchange.Data.MultiValuedProperty	Le paramètre ConditionalCustomAttribute12 spécifie des attributs personnalisés. Les attributs personnalisés permettent d’ajouter des informations supplémentaires dans la liste d’adresses grâce auxquelles vous pouvez trier ou grouper les listes d’adresses. Vous devez utiliser le paramètre IncludedRecipients si vous utilisez un paramètre Conditional. Vous ne pouvez pas utiliser ce paramètre si vous utilisez le paramètre RecipientFilter.
ConditionalCustomAttribute13	Facultatif	Microsoft.Exchange.Data.MultiValuedProperty	Le paramètre ConditionalCustomAttribute13 spécifie des attributs personnalisés. Les attributs personnalisés permettent d’ajouter des informations supplémentaires dans la liste d’adresses grâce auxquelles vous pouvez trier ou grouper les listes d’adresses. Vous devez utiliser le paramètre IncludedRecipients si vous utilisez un paramètre Conditional. Vous ne pouvez pas utiliser ce paramètre si vous utilisez le paramètre RecipientFilter.
ConditionalCustomAttribute14	Facultatif	Microsoft.Exchange.Data.MultiValuedProperty	Le paramètre ConditionalCustomAttribute14 spécifie des attributs personnalisés. Les attributs personnalisés permettent d’ajouter des informations supplémentaires dans la liste d’adresses grâce auxquelles vous pouvez trier ou grouper les listes d’adresses. Vous devez utiliser le paramètre IncludedRecipients si vous utilisez un paramètre Conditional. Vous ne pouvez pas utiliser ce paramètre si vous utilisez le paramètre RecipientFilter.
ConditionalCustomAttribute15	Facultatif	Microsoft.Exchange.Data.MultiValuedProperty	Le paramètre ConditionalCustomAttribute15 spécifie des attributs personnalisés. Les attributs personnalisés permettent d’ajouter des informations supplémentaires dans la liste d’adresses grâce auxquelles vous pouvez trier ou grouper les listes d’adresses. Vous devez utiliser le paramètre IncludedRecipients si vous utilisez un paramètre Conditional. Vous ne pouvez pas utiliser ce paramètre si vous utilisez le paramètre RecipientFilter.
ConditionalCustomAttribute2	Facultatif	Microsoft.Exchange.Data.MultiValuedProperty	Le paramètre ConditionalCustomAttribute2 spécifie des attributs personnalisés. Les attributs personnalisés permettent d’ajouter des informations supplémentaires dans la liste d’adresses grâce auxquelles vous pouvez trier ou grouper les listes d’adresses. Vous devez utiliser le paramètre IncludedRecipients si vous utilisez un paramètre Conditional. Vous ne pouvez pas utiliser ce paramètre si vous utilisez le paramètre RecipientFilter.
ConditionalCustomAttribute3	Facultatif	Microsoft.Exchange.Data.MultiValuedProperty	Le paramètre ConditionalCustomAttribute3 spécifie des attributs personnalisés. Les attributs personnalisés permettent d’ajouter des informations supplémentaires dans la liste d’adresses grâce auxquelles vous pouvez trier ou grouper les listes d’adresses. Vous devez utiliser le paramètre IncludedRecipients si vous utilisez un paramètre Conditional. Vous ne pouvez pas utiliser ce paramètre si vous utilisez le paramètre RecipientFilter.
ConditionalCustomAttribute4	Facultatif	Microsoft.Exchange.Data.MultiValuedProperty	Le paramètre ConditionalCustomAttribute4 spécifie des attributs personnalisés. Les attributs personnalisés permettent d’ajouter des informations supplémentaires dans la liste d’adresses grâce auxquelles vous pouvez trier ou grouper les listes d’adresses. Vous devez utiliser le paramètre IncludedRecipients si vous utilisez un paramètre Conditional. Vous ne pouvez pas utiliser ce paramètre si vous utilisez le paramètre RecipientFilter.
ConditionalCustomAttribute5	Facultatif	Microsoft.Exchange.Data.MultiValuedProperty	Le paramètre ConditionalCustomAttribute5 spécifie des attributs personnalisés. Les attributs personnalisés permettent d’ajouter des informations supplémentaires dans la liste d’adresses grâce auxquelles vous pouvez trier ou grouper les listes d’adresses. Vous devez utiliser le paramètre IncludedRecipients si vous utilisez un paramètre Conditional. Vous ne pouvez pas utiliser ce paramètre si vous utilisez le paramètre RecipientFilter.
ConditionalCustomAttribute6	Facultatif	Microsoft.Exchange.Data.MultiValuedProperty	Le paramètre ConditionalCustomAttribute6 spécifie des attributs personnalisés. Les attributs personnalisés permettent d’ajouter des informations supplémentaires dans la liste d’adresses grâce auxquelles vous pouvez trier ou grouper les listes d’adresses. Vous devez utiliser le paramètre IncludedRecipients si vous utilisez un paramètre Conditional. Vous ne pouvez pas utiliser ce paramètre si vous utilisez le paramètre RecipientFilter.
ConditionalCustomAttribute7	Facultatif	Microsoft.Exchange.Data.MultiValuedProperty	Le paramètre ConditionalCustomAttribute7 spécifie des attributs personnalisés. Les attributs personnalisés permettent d’ajouter des informations supplémentaires dans la liste d’adresses grâce auxquelles vous pouvez trier ou grouper les listes d’adresses. Vous devez utiliser le paramètre IncludedRecipients si vous utilisez un paramètre Conditional. Vous ne pouvez pas utiliser ce paramètre si vous utilisez le paramètre RecipientFilter.
ConditionalCustomAttribute8	Facultatif	Microsoft.Exchange.Data.MultiValuedProperty	Le paramètre ConditionalCustomAttribute8 spécifie des attributs personnalisés. Les attributs personnalisés permettent d’ajouter des informations supplémentaires dans la liste d’adresses grâce auxquelles vous pouvez trier ou grouper les listes d’adresses. Vous devez utiliser le paramètre IncludedRecipients si vous utilisez un paramètre Conditional. Vous ne pouvez pas utiliser ce paramètre si vous utilisez le paramètre RecipientFilter.
ConditionalCustomAttribute9	Facultatif	Microsoft.Exchange.Data.MultiValuedProperty	Le paramètre ConditionalCustomAttribute9 spécifie des attributs personnalisés. Les attributs personnalisés permettent d’ajouter des informations supplémentaires dans la liste d’adresses grâce auxquelles vous pouvez trier ou grouper les listes d’adresses. Vous devez utiliser le paramètre IncludedRecipients si vous utilisez un paramètre Conditional. Vous ne pouvez pas utiliser ce paramètre si vous utilisez le paramètre RecipientFilter.
ConditionalDepartment	Facultatif	Microsoft.Exchange.Data.MultiValuedProperty	Le paramètre ConditionalDepartment est un filtre permettant de spécifier un service. Tous les destinataires ayant un attribut department correspondant à la valeur que vous entrez pour ce paramètre sont inclus dans la liste d'adresses. Vous pouvez utiliser plusieurs valeurs sous la forme d'une liste délimitée par des virgules. Vous devez utiliser le paramètre IncludedRecipients si vous utilisez un paramètre Conditional. Vous ne pouvez pas utiliser ce paramètre si vous utilisez le paramètre RecipientFilter.
ConditionalStateOrProvince	Facultatif	Microsoft.Exchange.Data.MultiValuedProperty	Le paramètre ConditionalStateOrProvince est un filtre permettant de spécifier un état ou un département. Tous les destinataires ayant un attribut ConditionalStateOrProvince correspondant à la valeur que vous entrez pour ce paramètre sont inclus dans la liste d'adresses. Vous pouvez utiliser plusieurs valeurs sous la forme d'une liste délimitée par des virgules. Vous devez utiliser le paramètre IncludedRecipients si vous utilisez un paramètre Conditional. Vous ne pouvez pas utiliser ce paramètre si vous utilisez le paramètre RecipientFilter.
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.
DisplayName	Facultatif	System.String	Le paramètre DisplayName spécifie le nom complet souhaité de la liste d'adresses.
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 le service d'annuaire Active Directory, incluez le paramètre DomainController dans la commande.
ForceUpgrade	Facultatif	System.Management.Automation.SwitchParameter	Le paramètre ForceUpgrade supprime la confirmation suivante : « Pour enregistrer les modifications apportées à l'objet, ce dernier doit être mis à niveau vers la version actuelle d'Exchange. Après la mise à niveau, cet objet ne pourra plus être géré par une version antérieure du Gestionnaire système Exchange. Voulez-vous continuer la mise à niveau et enregistrer l'objet ? » Cette confirmation intervient lorsque vous mettez à jour une liste d'adresses créée dans Microsoft Exchange Server 2003 ou Exchange 2000 Server. Vous ne pouvez pas gérer une liste d'adresses Exchange 2003 ou Exchange 2000 à l'aide de la console de gestion Exchange tant que vous n'avez pas mis à jour la version de l'objet et modifié le filtre des destinataires à l'aide du paramètre RecipientFilter ou IncludedRecipients.
IncludedRecipients	Facultatif	System.Nullable	Le paramètre IncludedRecipients filtre les types de destinataire utilisés pour créer la liste d'adresses globales (LAG). Les valeurs disponibles pour le paramètre IncludedRecipients sont AllRecipients, MailboxUsers, Resources, Contacts et MailGroups. La valeur AllRecipients ne peut être utilisée qu'isolément. Lorsque plusieurs valeurs du paramètre IncludedRecipients sont séparées par des virgules, l'opérateur booléen OU est appliqué. Vous devez utiliser ce paramètre si vous utilisez l'un des paramètres Conditional. Vous ne pouvez pas utiliser ce paramètre si vous utilisez le paramètre RecipientFilter.
Instance	Facultatif	Microsoft.Exchange.Data.Directory.Management.AddressList	Le paramètre Instance est rarement utilisé par les administrateurs qui utilisent la ligne de commande. Il est inclus dans la table des paramètres à laquelle les développeurs peuvent se référer.
Name	Facultatif	System.String	Le paramètre Name spécifie un nouveau nom pour la liste d'adresses. Le nom ne peut pas comprendre plus de 64 caractères et ne peut pas inclure de retour chariot ni de barre oblique inverse (\).
RecipientFilter	Facultatif	System.String	Le paramètre RecipientFilter spécifie un filtre pour les destinataires à inclure dans la liste d'adresses. Vous ne pouvez pas utiliser ce paramètre si vous utilisez l'un des paramètres de filtre suivants : ConditionalCompany ConditionalDepartment ConditionalStateOrProvince IncludedRecipients RecipientContainer Pour plus d'informations sur les propriétés filtrables, consultez la rubrique Propriétés filtrables pour le paramètre -RecipientFilter.
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

Le premier exemple montre comment modifier le nom d'une liste d'adresses existante.

Le deuxième exemple montre comment modifier le type des destinataires et le département des destinataires qui seront inclus dans la liste d'adresses existante nommée MyAddressList2. MyAddressList2 étant une liste d'adresses d'Exchange 2003, cette commande met également à niveau cette liste d'adresses.

Set-AddressList -Identity "All Users\Sales\building4" -Name building9
Set-Addresslist -Identity c3fffd8e-026b-41b9-88c4-8c21697ac8ac -IncludedRecipients UserMailbox -ConditionalDepartment Sales -ForceUpgrade:$true

La commande 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 Get-AddressList pour obtenir une liste d'adresses spécifique, puis canaliser la sortie directement vers Set-AddressList.

Partager via