New-DistributionGroup

  • Article

 

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-DistributionGroup permet de créer un groupe de distribution.

Syntaxe

New-DistributionGroup -Name <String> -SamAccountName <String> -Type <Distribution | Security> [-Alias <String>] [-Confirm [<SwitchParameter>]] [-DisplayName <String>] [-DomainController <Fqdn>] [-ManagedBy <GeneralRecipientIdParameter>] [-OrganizationalUnit <OrganizationalUnitIdParameter>] [-TemplateInstance <PSObject>] [-UseRusServer <String>] [-WhatIf [<SwitchParameter>]]

Description détaillée

La cmdlet New-DistributionGroup permet de créer des objets groupe Active Directory des types suivants :

  • Groupe de sécurité universel à extension messagerie

  • Groupe de distribution universel

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.

Pour exécuter la cmdlet New-DistributionGroup, vous devez utiliser un compte auquel ont été délégués :

  • le rôle Administrateur des destinataires Exchange ;

  • le rôle Opérateur de compte pour les conteneurs Active Directory applicables.

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

Name

Obligatoire

System.String

Ce paramètre spécifie le nom du nouveau groupe de distribution. La valeur spécifiée dans le paramètre Name est également utilisée pour DisplayName si le paramètre DisplayName n'est pas spécifié.

La valeur Name ne peut pas dépasser 64 caractères.

Si les valeurs de Name et de DisplayName diffèrent :

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

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

SamAccountName

Obligatoire

System.String

Ce paramètre spécifie le nom de l'objet pour des clients 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). Si le paramètre Alias n'est pas spécifié, les conditions suivantes sont vraies :

  • La valeur de SAMAccountName est utilisée comme valeur pour le paramètre Alias, les espaces étant converties en caractères de soulignement.

  • SAMAccountName, avec les espaces converties en caractères de soulignement, est utilisée pour générer l'adresse électronique SMTP (Simple Mail Transfer Protocol) principale de l'objet.

Type

Obligatoire

Microsoft.Exchange.Management.RecipientTasks.GroupType

Ce paramètre spécifie le type de groupe qui sera créé dans Active Directory. La portée du groupe est toujours universelle. Les valeurs valides sont Distribution ou Security.

Alias

Facultatif

System.String

Ce paramètre permet de spécifier l'alias du groupe de distribution. Le paramètre Alias permet ensuite de générer l'adresse électronique SMTP principale de l'objet. La valeur Alias ne peut pas contenir d'espaces. Si le paramètre Alias n'est pas spécifié, la valeur de SAMAccountName est utilisée pour générer l'adresse électronique SMTP principale, les espaces étant converties en caractères de soulignement.

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

Ce paramètre permet de spécifier le nom du groupe de distribution dans la console de gestion Exchange et dans la liste d'adresses globale Exchange. Si le paramètre DisplayName n'est pas spécifié, la valeur du paramètre Name est utilisée pour DisplayName.

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.

ManagedBy

Facultatif

Microsoft.Exchange.Configuration.Tasks.GeneralRecipientIdParameter

Ce paramètre permet de spécifier 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

OrganizationalUnit

Facultatif

Microsoft.Exchange.Configuration.Tasks.OrganizationalUnitIdParameter

Ce paramètre spécifie où créer le groupe de distribution dans Active Directory en utilisant une syntaxe de nom canonique.

TemplateInstance

Facultatif

System.Management.Automation.PSObject

Lorsqu'un objet existant est fourni pour ce paramètre, la cmdlet utilise l'objet pour créer une copie de celui-ci.

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

L'exemple de code suivant montre comment utiliser la cmdlet New-DistributionGroup pour créer un groupe de sécurité universel à extension messagerie ayant les paramètres suivants :

  • Le nom du groupe est « Managers ».

  • Le groupe sera créé dans le conteneur Users du domaine Contoso.com.

  • Le nom de compte SAM sera « Managers ».

  • Le type de groupe sera Security.

New-DistributionGroup -Name "Managers" -OrganizationalUnit "contoso.com/Users" -SAMAccountName "Managers" -Type "Security"