Set-DistributionGroup

  • Article

 

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

Dernière rubrique modifiée : 2010-10-20

La cmdlet Set-DistributionGroup permet de modifier les paramètres d'un groupe de distribution existant.

Syntaxe

Set-DistributionGroup -Identity <DistributionGroupIdParameter> [-AcceptMessagesOnlyFrom <RecipientIdParameter[]>] [-AcceptMessagesOnlyFromDLMembers <RecipientIdParameter[]>] [-Alias <String>] [-Confirm [<SwitchParameter>]] [-CreateDTMFMap <$true | $false>] [-CustomAttribute1 <String>] [-CustomAttribute10 <String>] [-CustomAttribute11 <String>] [-CustomAttribute12 <String>] [-CustomAttribute13 <String>] [-CustomAttribute14 <String>] [-CustomAttribute15 <String>] [-CustomAttribute2 <String>] [-CustomAttribute3 <String>] [-CustomAttribute4 <String>] [-CustomAttribute5 <String>] [-CustomAttribute6 <String>] [-CustomAttribute7 <String>] [-CustomAttribute8 <String>] [-CustomAttribute9 <String>] [-DisplayName <String>] [-DomainController <Fqdn>] [-EmailAddresses <ProxyAddressCollection>] [-EmailAddressPolicyEnabled <$true | $false>] [-ExpansionServer <String>] [-GrantSendOnBehalfTo <MailboxOrMailUserIdParameter[]>] [-HiddenFromAddressListsEnabled <$true | $false>] [-IgnoreDefaultScope <SwitchParameter>] [-ManagedBy <GeneralRecipientIdParameter>] [-MaxReceiveSize <Unlimited>] [-MaxSendSize <Unlimited>] [-Name <String>] [-PrimarySmtpAddress <SmtpAddress>] [-RejectMessagesFrom <RecipientIdParameter[]>] [-RejectMessagesFromDLMembers <RecipientIdParameter[]>] [-ReportToManagerEnabled <$true | $false>] [-ReportToOriginatorEnabled <$true | $false>] [-RequireSenderAuthenticationEnabled <$true | $false>] [-SamAccountName <String>] [-SendOofMessageToOriginatorEnabled <$true | $false>] [-SimpleDisplayName <String>] [-UMDtmfMap <MultiValuedProperty>] [-UseRusServer <String>] [-WhatIf [<SwitchParameter>]] [-WindowsEmailAddress <SmtpAddress>]

Set-DistributionGroup [-AcceptMessagesOnlyFrom <RecipientIdParameter[]>] [-AcceptMessagesOnlyFromDLMembers <RecipientIdParameter[]>] [-Alias <String>] [-Confirm [<SwitchParameter>]] [-CreateDTMFMap <$true | $false>] [-CustomAttribute1 <String>] [-CustomAttribute10 <String>] [-CustomAttribute11 <String>] [-CustomAttribute12 <String>] [-CustomAttribute13 <String>] [-CustomAttribute14 <String>] [-CustomAttribute15 <String>] [-CustomAttribute2 <String>] [-CustomAttribute3 <String>] [-CustomAttribute4 <String>] [-CustomAttribute5 <String>] [-CustomAttribute6 <String>] [-CustomAttribute7 <String>] [-CustomAttribute8 <String>] [-CustomAttribute9 <String>] [-DisplayName <String>] [-DomainController <Fqdn>] [-EmailAddresses <ProxyAddressCollection>] [-EmailAddressPolicyEnabled <$true | $false>] [-ExpansionServer <String>] [-GrantSendOnBehalfTo <MailboxOrMailUserIdParameter[]>] [-HiddenFromAddressListsEnabled <$true | $false>] [-IgnoreDefaultScope <SwitchParameter>] [-Instance <DistributionGroup>] [-ManagedBy <GeneralRecipientIdParameter>] [-MaxReceiveSize <Unlimited>] [-MaxSendSize <Unlimited>] [-Name <String>] [-PrimarySmtpAddress <SmtpAddress>] [-RejectMessagesFrom <RecipientIdParameter[]>] [-RejectMessagesFromDLMembers <RecipientIdParameter[]>] [-ReportToManagerEnabled <$true | $false>] [-ReportToOriginatorEnabled <$true | $false>] [-RequireSenderAuthenticationEnabled <$true | $false>] [-SamAccountName <String>] [-SendOofMessageToOriginatorEnabled <$true | $false>] [-SimpleDisplayName <String>] [-UMDtmfMap <MultiValuedProperty>] [-UseRusServer <String>] [-WhatIf [<SwitchParameter>]] [-WindowsEmailAddress <SmtpAddress>]

Description détaillée

Les groupes de distribution permettent de consolider des groupes de destinataires dans un point de contact unique pour les messages électroniques. Les groupes de distribution ne permettent pas d'attribuer des autorisations à des ressources réseau dans le service d'annuaire Active Directory. La cmdlet Set-DistributionGroup permet de remplacer des paramètres existants ou d'ajouter de nouveaux paramètres.

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

Paramètres

Paramètre Obligatoire Type Description

Identity

Obligatoire

Microsoft.Exchange.Configuration.Tasks.DistributionGroupIdParameter

Le paramètre Identity spécifie l'objet que vous voulez modifier. Le paramètre Identity peut prendre l'une des valeurs suivantes pour le groupe de distribution :

  • Nom unique

  • Nom canonique

  • GUID

  • Name

  • Nom complet

  • Alias

  • DN Exchange

  • Adresse SMTP (Simple Mail Transfer Protocol) principale

Vous ne pouvez pas utiliser le paramètre Identity si le paramètre Instance est spécifié.

AcceptMessagesOnlyFrom

Facultatif

Microsoft.Exchange.Configuration.Tasks.RecipientIdParameter[]

Le paramètre AcceptMessagesOnlyFrom spécifie les utilisateurs de boîte aux lettres, les utilisateurs de messagerie et les contacts de messagerie qui peuvent envoyer des messages électroniques à ce groupe de distribution dynamique. Vous pouvez également spécifier Microsoft Exchange comme destinataire valide pour ce paramètre. Si vous configurez un groupe de distribution pour n'accepter des messages que du destinataire Microsoft Exchange, ce contact ne reçoit que des messages générés par le système.

Le paramètre AcceptMessagesOnlyFrom peut prendre l'une des valeurs suivantes pour les expéditeurs valides :

  • Nom unique

  • Nom canonique

  • GUID

  • Name

  • Nom complet

  • Alias

  • DN Exchange

  • Adresse de messagerie SMTP principale

La valeur par défaut de ce paramètre est vide. Cela permet au groupe de distribution d'accepter des messages de tous les expéditeurs.

AcceptMessagesOnlyFromDLMembers

Facultatif

Microsoft.Exchange.Configuration.Tasks.RecipientIdParameter[]

Le paramètre AcceptMessagesOnlyFromDLMembers spécifie les groupes de distribution dont les membres peuvent envoyer des messages électroniques à ce groupe de distribution. Vous pouvez utiliser toutes les valeurs suivantes pour les groupes de distribution autorisés :

  • Nom unique

  • Nom canonique

  • GUID

  • Name

  • Nom complet

  • Nom unique Exchange hérité

  • Adresse de messagerie SMTP principale

La valeur par défaut de ce paramètre est vide. Cela permet au groupe de distribution d'accepter des messages de tous les expéditeurs.

Alias

Facultatif

System.String

Le paramètre Alias permet de spécifier l'alias de l'objet. La valeur du paramètre Alias ne peut pas contenir d'espaces.

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.

CreateDTMFMap

Facultatif

System.Boolean

Ce paramètre indique qu’une carte DTMF (multifréquence bi-tonalité) peut être créée pour le groupe de distribution.

CustomAttribute1

Facultatif

System.String

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

CustomAttribute10

Facultatif

System.String

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

CustomAttribute11

Facultatif

System.String

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

CustomAttribute12

Facultatif

System.String

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

CustomAttribute13

Facultatif

System.String

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

CustomAttribute14

Facultatif

System.String

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

CustomAttribute15

Facultatif

System.String

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

CustomAttribute2

Facultatif

System.String

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

CustomAttribute3

Facultatif

System.String

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

CustomAttribute4

Facultatif

System.String

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

CustomAttribute5

Facultatif

System.String

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

CustomAttribute6

Facultatif

System.String

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

CustomAttribute7

Facultatif

System.String

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

CustomAttribute8

Facultatif

System.String

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

CustomAttribute9

Facultatif

System.String

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

DisplayName

Facultatif

System.String

Le paramètre DisplayName permet de spécifier le nom du groupe de distribution dans la console de gestion Exchange et dans la liste d'adresses globale (LAG) Exchange.

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.

EmailAddresses

Facultatif

Microsoft.Exchange.Data.ProxyAddressCollection

Le paramètre EmailAddresses permet de spécifier l'alias de messagerie du groupe de distribution. Vous pouvez utiliser tous les types d'adresses de messagerie Microsoft Exchange Server 2007 valides. Vous pouvez spécifier plusieurs valeurs pour le paramètre EmailAddresses sous la forme d'une liste délimitée par des virgules.

importantImportant :
Exchange 2007 ne valide pas d'adresses personnalisées pour une mise en forme appropriée. Vous devez veiller à ce que l'adresse personnalisée que vous spécifiez soit conforme aux exigences de mise en forme pour ce type d'adresse. Comme les adresses X.400 sont considérées comme des adresses personnalisées dans Exchange 2007, elles ne sont pas non plus validées. C'est pourquoi, vous devez introduire la syntaxe correcte lors de la spécification d'une adresse X.400.

EmailAddressPolicyEnabled

Facultatif

System.Boolean

Le paramètre EmailAddressPolicyEnabled permet de contrôler l'application de stratégies d'adresse de messagerie à ce groupe de distribution. Les valeurs valides sont $true et $false. La valeur par défaut est $true. Par défaut, toutes les stratégies d'adresse de messagerie applicables sont appliquées à ce groupe de distribution.

ExpansionServer

Facultatif

System.String

La paramètre ExpansionServer spécifie le serveur Exchange utilisé pour étendre le groupe de distribution. Entrez le serveur d'extension comme une valeur DN Exchange héritée. Le comportement par défaut consiste à utiliser l'ordinateur Exchange Server 2003 ou le serveur Exchange 2007 le plus proche, sur lequel le rôle serveur de transport Hub est installé.

GrantSendOnBehalfTo

Facultatif

Microsoft.Exchange.Configuration.Tasks.RecipientIdParameter

Le paramètre GrantSendOnBehalfTo spécifie un utilisateur de boîte aux lettres qui peut expédier des messages à la place de ce groupe de distribution. Le paramètre GrantSendOnBehalfTo peut prendre l'une des valeurs suivantes :

  • Nom unique

  • GUID

  • Name

  • Nom complet

  • Nom canonique

  • Nom unique Exchange hérité

  • Alias

  • Adresse de messagerie SMTP principale

Par défaut, la valeur de GrantSendOnBehalfTo est vide. Cela signifie qu'aucun autre utilisateur de boîte aux lettres n'est autorisé à expédier des messages au nom de ce groupe de distribution.

HiddenFromAddressListsEnabled

Facultatif

System.Boolean

Le paramètre HiddenFromAddressListsEnabled permet de masquer le groupe de distribution dans toute liste d'adresses Exchange. Les valeurs valides sont $true et $false. La valeur par défaut est $false.

IgnoreDefaultScope

Facultatif

System.Management.Automation.SwitchParameter

Le paramètre IgnoreDefaultScope donne pour instruction à la commande d'ignorer le paramétrage de la portée du destinataire par défaut pour l'environnement de ligne de commande Exchange Management Shell et d'utiliser l'ensemble de la forêt comme portée. Cela permet à la commande d'accéder à des objets Active Directory ne figurant pas actuellement dans la portée par défaut. L'utilisation du paramètre IgnoreDefaultScope introduit les restrictions suivantes :

  • Vous ne pouvez pas utiliser le paramètre DomainController. La commande utilisera automatiquement un serveur de catalogue global approprié.

  • Vous ne pouvez utiliser le nom unique que pour le paramètre Identity. D'autres formes d'identification, telles qu'un alias ou un GUID, ne sont pas acceptées.

Instance

Facultatif

Microsoft.Exchange.Data.Directory.Management.DistributionGroup

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.

Vous ne pouvez pas utiliser le paramètre Instance si le paramètre Identity est spécifié.

ManagedBy

Facultatif

Microsoft.Exchange.Configuration.Tasks.GeneralRecipientIdParameter

Le paramètre ManagedBy spécifie le nom de l'utilisateur de boîte aux lettres, du groupe à extension messagerie ou du contact à extension messagerie qui s'affiche sous l'onglet Géré par de l'objet Active Directory. Vous pouvez utiliser toutes les valeurs suivantes pour ce paramètre :

  • Nom unique

  • Nom canonique

  • GUID

  • Name

  • Nom complet

  • Nom unique Exchange hérité

  • Adresse de messagerie SMTP principale

MaxReceiveSize

Facultatif

Microsoft.Exchange.Data.Unlimited

Le paramètre MaxReceiveSize permet de définir la taille maximale autorisée pour les messages électroniques adressés à ce groupe de distribution. Lorsque vous entrez une valeur, qualifiez-la à l'aide de l'une des unités suivantes :

  • B (octets)

  • KB (kilo-octets)

  • MB (mégaoctets)

  • GB (gigaoctets)

  • TB (téraoctets)

Les valeurs non qualifiées sont traitées comme des octets. Les valeurs valides sont comprises entre 0 et 2147482624 octets.

Par défaut, le paramètre MaxReceiveSize est défini sur unlimited.

MaxSendSize

Facultatif

Microsoft.Exchange.Data.Unlimited

Le paramètre MaxSendSize permet de spécifier la taille maximale autorisée pour les messages électroniques expédiés depuis ce groupe de distribution. Lorsque vous entrez une valeur, qualifiez-la à l'aide de l'une des unités suivantes :

  • B (octets)

  • KB (kilo-octets)

  • MB (mégaoctets)

  • GB (gigaoctets)

  • TB (téraoctets)

Les valeurs non qualifiées sont traitées comme des octets. Les valeurs valides sont comprises entre 0 et 2147482624 octets.

Par défaut, le paramètre MaxSendSize est défini sur unlimited.

Name

Facultatif

System.String

Le paramètre Name spécifie le nom du groupe de distribution. Le paramètre Name spécifie le nom du groupe de distribution dans Utilisateurs et ordinateurs Active Directory ainsi que dans le champ Nom de groupe dans la console de gestion Exchange.

PrimarySmtpAddress

Facultatif

Microsoft.Exchange.Data.SmtpAddress

Le paramètre PrimarySmtpAddress spécifie l'adresse de messagerie SMTP de retour principale pour le groupe de distribution. Ce paramètre n'a de signification que si le groupe de distribution a plusieurs adresses de messagerie SMTP.

RejectMessagesFrom

Facultatif

Microsoft.Exchange.Configuration.Tasks.RecipientIdParameter[]

Le paramètre RejectMessagesFrom spécifie les utilisateurs de boîte aux lettres et les contacts à extension messagerie qui ne peuvent pas envoyer de messages électroniques à ce groupe de distribution. Vous pouvez utiliser toutes les valeurs suivantes pour les expéditeurs proscrits :

  • Nom unique

  • Nom canonique

  • GUID

  • Name

  • Nom complet

  • Nom unique Exchange hérité

  • Adresse de messagerie SMTP principale

La valeur par défaut de ce paramètre est vide. Cela permet au groupe de distribution d'accepter des messages de tous les utilisateurs de boîte aux lettres et de tous les contacts à messagerie activée.

RejectMessagesFromDLMembers

Facultatif

Microsoft.Exchange.Configuration.Tasks.RecipientIdParameter[]

Le paramètre RejectMessagesFromDLMembers spécifie les groupes de distribution qui ne peuvent pas envoyer de messages électroniques à ce groupe de distribution. Vous pouvez utiliser toutes les valeurs suivantes pour les groupes de distribution proscrits :

  • Nom unique

  • Nom canonique

  • GUID

  • Name

  • Nom complet

  • Nom unique Exchange hérité

  • Adresse de messagerie SMTP principale

La valeur par défaut de ce paramètre est vide. Cela permet au groupe de distribution d'accepter des messages de tous les groupes de distribution.

ReportToManagerEnabled

Facultatif

System.Boolean

Le paramètre ReportToManagerEnabled permet d'envoyer des rapports de remise au gestionnaire du groupe de distribution. Les valeurs valides sont $true et $false. La valeur par défaut est $false.

ReportToOriginatorEnabled

Facultatif

System.Boolean

Le paramètre ReportToOriginatorEnabled permet d'envoyer des rapports de remise aux expéditeurs des messages électroniques envoyés à ce groupe de distribution. Les valeurs valides sont $true et $false. La valeur par défaut est $true.

RequireSenderAuthenticationEnabled

Facultatif

System.Boolean

Le paramètre RequireSenderAuthenticationEnabled requiert une remise de message électronique provenant d'expéditeurs authentifiés. Si la valeur est $true, les messages ne sont acceptés que s'ils proviennent d'expéditeurs authentifiés. Les valeurs valides sont $true et $false. La valeur par défaut est $true.

SamAccountName

Facultatif

System.String

Le paramètre SamAccountName spécifie le nom pour des clients de l'objet qui exécutent des systèmes d'exploitation plus anciens. Le paramètre SamAccountName est affiché dans Active Directory et dans la console de gestion Exchange dans le champ Nom de groupe (pré-Windows 2000).

SendOofMessageToOriginatorEnabled

Facultatif

System.Boolean

Le paramètre SendOofMessageToOriginatorEnabled permet de remettre des messages de notification d'absence du bureau aux expéditeurs des messages électroniques envoyés à ce groupe de distribution. Les valeurs valides sont $true ou $false. La valeur par défaut est $false.

SimpleDisplayName

Facultatif

System.String

Le paramètre SimpleDisplayName permet d'afficher une autre description de l'objet lorsque seul un jeu de caractères limité est autorisé. Le jeu de caractères limité comprend les caractères suivants :

abcdefghijklmnopqrstuvwxyzABCDEFGHIJKLMNOPQRSTUVWXYZ0123456789\"()+,-./:?

UMDtmfMap

Facultatif

Microsoft.Exchange.Data.MultiValuedProperty

Ce paramètre indique si vous voulez créer une carte DTMF définie par l'utilisateur pour le groupe de distribution à extension messagerie unifiée.

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.

WindowsEmailAddress

Facultatif

Microsoft.Exchange.Data.SmtpAddress

Le paramètre WindowsEmailAddress spécifie la valeur du champ Courrier électronique de l'objet Active Directory.

Types d'entrées

Types de retours

Erreurs

Erreur Description

 

 

Exceptions

Exceptions Description

 

 

Exemple

L'exemple de code suivant montre comment utiliser la cmdlet Set-DistributionGroup pour modifier le nom complet d'un groupe de distribution nommé « Accounting to Accounting Group ».

Set-DistributionGroup -Identity "Accounting" -DisplayName "Accounting Group"