Partager via


New-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 New-AddressList permet de créer une liste d'adresses et de l'appliquer à des destinataires.

Syntaxe

New-AddressList -Name <String> [-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>]] [-Container <AddressListIdParameter>] [-DisplayName <String>] [-DomainController <Fqdn>] [-IncludedRecipients <Nullable>] [-TemplateInstance <PSObject>] [-UseRusServer <String>] [-WhatIf [<SwitchParameter>]]

New-AddressList -Name <String> [-Confirm [<SwitchParameter>]] [-Container <AddressListIdParameter>] [-DisplayName <String>] [-DomainController <Fqdn>] [-RecipientFilter <String>] [-TemplateInstance <PSObject>] [-UseRusServer <String>] [-WhatIf [<SwitchParameter>]]

Description détaillée

Pour exécuter la cmdlet New-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.

Paramètres

Paramètre Obligatoire Type Description

Name

Obligatoire

System.String

Le paramètre Name spécifie le nom souhaité pour la nouvelle 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 (\).

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. Vous pouvez utiliser plusieurs valeurs sous la forme d'une liste délimitée par des virgules. Vous ne pouvez pas utiliser ce paramètre si vous utilisez le paramètre RecipientFilter. Vous devez utiliser soit le paramètre RecipientFilter, soit l'un des paramètres de filtre suivants :

  • ConditionalCompany

  • ConditionalDepartment

  • ConditionalStateOrProvince

  • IncludedRecipients

ConditionalCustomAttribute1

Facultatif

Microsoft.Exchange.Data.MultiValuedProperty

Le paramètre ConditionalCustomAttribute1 spécifie des attributs personnalisés. Vous pouvez les utiliser pour stocker des informations supplémentaires.

ConditionalCustomAttribute10

Facultatif

Microsoft.Exchange.Data.MultiValuedProperty

Le paramètre ConditionalCustomAttribute10 spécifie des attributs personnalisés. Vous pouvez les utiliser pour stocker des informations supplémentaires.

ConditionalCustomAttribute11

Facultatif

Microsoft.Exchange.Data.MultiValuedProperty

Le paramètre ConditionalCustomAttribute11 spécifie des attributs personnalisés. Vous pouvez les utiliser pour stocker des informations supplémentaires.

ConditionalCustomAttribute12

Facultatif

Microsoft.Exchange.Data.MultiValuedProperty

Le paramètre ConditionalCustomAttribute12 spécifie des attributs personnalisés. Vous pouvez les utiliser pour stocker des informations supplémentaires.

ConditionalCustomAttribute13

Facultatif

Microsoft.Exchange.Data.MultiValuedProperty

Le paramètre ConditionalCustomAttribute13 spécifie des attributs personnalisés. Vous pouvez les utiliser pour stocker des informations supplémentaires.

ConditionalCustomAttribute14

Facultatif

Microsoft.Exchange.Data.MultiValuedProperty

Le paramètre ConditionalCustomAttribute14 spécifie des attributs personnalisés. Vous pouvez les utiliser pour stocker des informations supplémentaires.

ConditionalCustomAttribute15

Facultatif

Microsoft.Exchange.Data.MultiValuedProperty

Le paramètre ConditionalCustomAttribute15 spécifie des attributs personnalisés. Vous pouvez les utiliser pour stocker des informations supplémentaires.

ConditionalCustomAttribute2

Facultatif

Microsoft.Exchange.Data.MultiValuedProperty

Le paramètre ConditionalCustomAttribute2 spécifie des attributs personnalisés. Vous pouvez les utiliser pour stocker des informations supplémentaires.

ConditionalCustomAttribute3

Facultatif

Microsoft.Exchange.Data.MultiValuedProperty

Le paramètre ConditionalCustomAttribute3 spécifie des attributs personnalisés. Vous pouvez les utiliser pour stocker des informations supplémentaires.

ConditionalCustomAttribute4

Facultatif

Microsoft.Exchange.Data.MultiValuedProperty

Le paramètre ConditionalCustomAttribute4 spécifie des attributs personnalisés. Vous pouvez les utiliser pour stocker des informations supplémentaires.

ConditionalCustomAttribute5

Facultatif

Microsoft.Exchange.Data.MultiValuedProperty

Le paramètre ConditionalCustomAttribute5 spécifie des attributs personnalisés. Vous pouvez les utiliser pour stocker des informations supplémentaires.

ConditionalCustomAttribute6

Facultatif

Microsoft.Exchange.Data.MultiValuedProperty

Le paramètre ConditionalCustomAttribute6 spécifie des attributs personnalisés. Vous pouvez les utiliser pour stocker des informations supplémentaires.

ConditionalCustomAttribute7

Facultatif

Microsoft.Exchange.Data.MultiValuedProperty

Le paramètre ConditionalCustomAttribute7 spécifie des attributs personnalisés. Vous pouvez les utiliser pour stocker des informations supplémentaires.

ConditionalCustomAttribute8

Facultatif

Microsoft.Exchange.Data.MultiValuedProperty

Le paramètre ConditionalCustomAttribute8 spécifie des attributs personnalisés. Vous pouvez les utiliser pour stocker des informations supplémentaires.

ConditionalCustomAttribute9

Facultatif

Microsoft.Exchange.Data.MultiValuedProperty

Le paramètre ConditionalCustomAttribute9 spécifie des attributs personnalisés. Vous pouvez les utiliser pour stocker des informations supplémentaires.

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 ne pouvez pas utiliser ce paramètre si vous utilisez le paramètre RecipientFilter. Vous devez utiliser soit le paramètre RecipientFilter, soit l'un des paramètres de filtre suivants :

  • ConditionalCompany

  • ConditionalDepartment

  • ConditionalStateOrProvince

  • IncludedRecipients

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 ne pouvez pas utiliser ce paramètre si vous utilisez le paramètre RecipientFilter. Vous devez utiliser soit le paramètre RecipientFilter, soit l'un des paramètres de filtre suivants :

  • ConditionalCompany

  • ConditionalDepartment

  • ConditionalStateOrProvince

  • IncludedRecipients

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.

Container

Facultatif

Microsoft.Exchange.Configuration.Tasks.AddressListIdParameter

Le paramètre Container spécifie l'identité de la liste d'adresses parent dans laquelle la liste d'adresses sera créée. Si aucune liste d'adresses parent n'est spécifiée, la liste d'adresses est créée dans la racine « All Address Lists ».

DisplayName

Facultatif

System.String

Le paramètre DisplayName spécifie le nom complet souhaité de la liste d'adresses. Si aucun nom complet n'est fourni, le nom de la liste d'adresses est utilisé comme nom complet.

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.

IncludedRecipients

Facultatif

System.Nullable

Le paramètre IncludedRecipients est un filtre permettant de spécifier le type de destinataire à inclure dans la liste d'adresses. Vous pouvez utiliser un ou plusieurs des types suivants :

  • Aucun

  • UserMail

  • Resources

  • MailGroups

  • MailContacts

  • AllRecipients

Vous ne pouvez pas utiliser ce paramètre si vous utilisez le paramètre RecipientFilter. Vous devez utiliser soit le paramètre RecipientFilter, soit l'un des paramètres de filtre suivants :

  • ConditionalCompany

  • ConditionalDepartment

  • ConditionalStateOrProvince

  • IncludedRecipients

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

Vous devez utiliser ce paramètre ou l'un des paramètres de filtre précédents.

Pour plus d'informations sur les propriétés filtrables, consultez la rubrique Propriétés filtrables pour le paramètre -RecipientFilter.

TemplateInstance

Facultatif

System.Management.Automation.PSObject

Quand un objet existant est fourni au paramètre TemplateInstance, la commande utilise la configuration de cet objet pour créer une copie exacte de celui-ci sur un serveur local ou cible.

UseRusServer

Facultatif

System.String

> [!Note] > Ce paramètre n'est disponible que dans Exchange Server 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 créer une liste d'adresses appelée MyAddressList. La liste d'adresses inclut les destinataires qui sont des utilisateurs de boîte aux lettres et pour lesquels le paramètre StateOrProvince est défini sur Washington ou Oregon.

Le second exemple montre comment créer une liste d'adresses nommée MyAddressList2 incluant des boîtes aux lettres dont le paramètre ConditionalStateOrProvince est défini sur Washington.

New-AddressList -Name MyAddressList -RecipientFilter {((RecipientType -eq 'UserMailbox') -and ((StateOrProvince -eq 'Washington') -or (StateOrProvince -eq 'Oregon')))}
New-AddressList -Name MyAddressList2 -ConditionalStateOrProvince Washington -IncludedRecipients MailboxUsers