Partager via

Set-DistributionGroup (RTM)

  • Article

 

S’applique à : Exchange Server 2007

Dernière rubrique modifiée : 2007-06-05

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>] [-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>] [-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>] [-WindowsEmailAddress <SmtpAddress>]

Set-DistributionGroup [-AcceptMessagesOnlyFrom <RecipientIdParameter[]>] [-AcceptMessagesOnlyFromDLMembers <RecipientIdParameter[]>] [-Alias <String>] [-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>] [-Instance <DistributionGroup>] [-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>] [-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 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 et les contacts à extension messagerie qui peuvent envoyer des messages électroniques à ce groupe de distribution. 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 utilisateurs de boîte aux lettres et de tous les contacts à messagerie activée.

AcceptMessagesOnlyFromDLMembers

Facultatif

Microsoft.Exchange.Configuration.Tasks.RecipientIdParameter[]

Le paramètre AcceptMessagesOnlyFromDLMembers spécifie les groupes de distribution qui 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 groupes de distribution.

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.

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.

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.MailboxOrMailUserIdParameter[]

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.

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é.

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)

  • Ko (kilo-octets)

  • Mo (mégaoctets)

  • Go (gigaoctets)

  • To (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)

  • Ko (kilo-octets)

  • Mo (mégaoctets)

  • Go (gigaoctets)

  • To (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é. Ce jeu de caractères limité comprend les caractères ASCII 26 à 126 inclus.

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.

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"