Set-GlobalAddressList

 

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-GlobalAddressList permet de modifier les attributs du service d'annuaire Active Directory pour une liste d'adresses globale (LAG).

Syntaxe

Set-GlobalAddressList -Identity <GlobalAddressListIdParameter> [-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>]] [-DomainController <Fqdn>] [-ForceUpgrade <SwitchParameter>] [-IncludedRecipients <Nullable>] [-Name <String>] [-RecipientFilter <String>] [-UseRusServer <String>] [-WhatIf [<SwitchParameter>]]

Set-GlobalAddressList [-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>]] [-DomainController <Fqdn>] [-ForceUpgrade <SwitchParameter>] [-IncludedRecipients <Nullable>] [-Instance <GlobalAddressList>] [-Name <String>] [-RecipientFilter <String>] [-UseRusServer <String>] [-WhatIf [<SwitchParameter>]]

Description détaillée

La cmdlet Set-GlobalAddressList modifie les propriétés d'une LAG.

Pour exécuter la cmdlet Set-GlobalAddressList, 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.

Paramètres

Paramètre Obligatoire Type Description

Identity

Obligatoire

Microsoft.Exchange.Configuration.Tasks.GlobalAddressListIdParameter

Le paramètre Identity permet de spécifier le GUID, le nom unique ou le nom de liste d'adresses globale (LAG) représentant une liste d'adresses spécifique. Vous pouvez inclure le chemin en utilisant le format Path\GlobalAddressListName.

Vous pouvez omettre l'étiquette de paramètre Identity de façon à ne fournir que le nom de LAG ou le GUID.

ConditionalCompany

Facultatif

Microsoft.Exchange.Data.MultiValuedProperty

Le paramètre ConditionalCompany permet de spécifier une société. 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

Ce paramètre spécifie des attributs personnalisés. Vous pouvez les utiliser pour stocker des informations supplémentaires. 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

Ce paramètre spécifie des attributs personnalisés. Vous pouvez les utiliser pour stocker des informations supplémentaires. 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

Ce paramètre spécifie des attributs personnalisés. Vous pouvez les utiliser pour stocker des informations supplémentaires. 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

Ce paramètre spécifie des attributs personnalisés. Vous pouvez les utiliser pour stocker des informations supplémentaires. 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

Ce paramètre spécifie des attributs personnalisés. Vous pouvez les utiliser pour stocker des informations supplémentaires. 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

Ce paramètre spécifie des attributs personnalisés. Vous pouvez les utiliser pour stocker des informations supplémentaires. 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

Ce paramètre spécifie des attributs personnalisés. Vous pouvez les utiliser pour stocker des informations supplémentaires. 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

Ce paramètre spécifie des attributs personnalisés. Vous pouvez les utiliser pour stocker des informations supplémentaires. 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

Ce paramètre spécifie des attributs personnalisés. Vous pouvez les utiliser pour stocker des informations supplémentaires. 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

Ce paramètre spécifie des attributs personnalisés. Vous pouvez les utiliser pour stocker des informations supplémentaires. 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

Ce paramètre spécifie des attributs personnalisés. Vous pouvez les utiliser pour stocker des informations supplémentaires. 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

Ce paramètre spécifie des attributs personnalisés. Vous pouvez les utiliser pour stocker des informations supplémentaires. 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

Ce paramètre spécifie des attributs personnalisés. Vous pouvez les utiliser pour stocker des informations supplémentaires. 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

Ce paramètre spécifie des attributs personnalisés. Vous pouvez les utiliser pour stocker des informations supplémentaires. 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

Ce paramètre spécifie des attributs personnalisés. Vous pouvez les utiliser pour stocker des informations supplémentaires. 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 permet de spécifier un département. Toutes les LAG ayant un attribut department correspondant à la valeur que vous entrez pour ce paramètre sont incluses. 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 définit l'état ou la province pour la liste d'adresses globale. Il prend plusieurs valeurs sous forme de 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.

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.

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 LAG créée dans Microsoft Exchange Server 2003 ou Exchange 2000 Server. Vous ne pouvez pas gérer une LAG 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é pour créer la 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 OR 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.GlobalAddressList

Le paramètre Instance permet de transmettre un objet entier à la commande à traiter. Il est principalement utilisé dans les scripts où un objet entier doit être transmis à la commande.

Name

Facultatif

System.String

Le paramètre Name spécifie le nouveau nom pour la liste d'adresses globale.

RecipientFilter

Facultatif

System.String

Le paramètre RecipientFilter spécifie un filtre pour les destinataires à inclure dans la LAG. Vous ne pouvez pas utiliser ce paramètre si vous utilisez l'un des paramètres de filtrage suivants :

  • ConditionalCompany

  • ConditionalDepartment

  • IncludedRecipients

  • ConditionalStateorProvince

Vous devez utiliser ce paramètre ou l'un des paramètres de filtrage précités.

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

Dans cet exemple, la commande Set-GlobalAddressList permet d'attribuer un nouveau nom, GALwithNewName, à la LAG dont le GUID est 96d0c505-eba8-4103-ad4f-577a1bf4ad7b.

Set-GlobalAddressList 96d0c505-eba8-4103-ad4f-577a1bf4ad7b -Name GALwithNewName