New-DynamicDistributionGroup (RTM)

Article
09/30/2014

S’applique à : Exchange Server 2007

Dernière rubrique modifiée : 2007-10-23

La cmdlet New-DynamicDistributionGroup permet de créer un groupe de distribution dynamique.

Syntaxe

New-DynamicDistributionGroup -Name <String> -IncludedRecipients <Nullable> -OrganizationalUnit <OrganizationalUnitIdParameter> [-Alias <String>] [-ConditionalCompany <MultiValuedProperty>] [-ConditionalCustomAttribute1 <String>] [-ConditionalCustomAttribute10 <String>] [-ConditionalCustomAttribute11 <String>] [-ConditionalCustomAttribute12 <String>] [-ConditionalCustomAttribute13 <String>] [-ConditionalCustomAttribute14 <String>] [-ConditionalCustomAttribute15 <String>] [-ConditionalCustomAttribute2 <String>] [-ConditionalCustomAttribute3 <String>] [-ConditionalCustomAttribute4 <String>] [-ConditionalCustomAttribute5 <String>] [-ConditionalCustomAttribute6 <String>] [-ConditionalCustomAttribute7 <String>] [-ConditionalCustomAttribute8 <String>] [-ConditionalCustomAttribute9 <String>] [-ConditionalDepartment <MultiValuedProperty>] [-ConditionalStateOrProvince <MultiValuedProperty>] [-DisplayName <String>] [-DomainController <Fqdn>] [-RecipientContainer <OrganizationalUnitIdParameter>] [-TemplateInstance <PSObject>]

New-DynamicDistributionGroup -Name <String> -OrganizationalUnit <OrganizationalUnitIdParameter> -RecipientFilter <String> [-Alias <String>] [-DisplayName <String>] [-DomainController <Fqdn>] [-RecipientContainer <OrganizationalUnitIdParameter>] [-TemplateInstance <PSObject>]

Description détaillée

Un groupe de distribution dynamique interroge des objets à extension messagerie du service d'annuaire Active Directory et crée l'appartenance au groupe sur la base des résultats. L'appartenance au groupe est recalculée chaque fois qu'un message électronique est envoyé au groupe. Les filtres de requête fournis par Exchange sont limités à une combinaison des paramètres suivants :

ConditionalCompany
ConditionalCustomAttribute N (où N est une valeur comprise entre 1 et 15)
ConditionalDepartment
ConditionalStateOrProvince
IncludedRecipients

Vous pouvez également créer une requête personnalisée en utilisant le paramètre RecipientFilter.

Pour exécuter la cmdlet New-DynamicDistributionGroup, 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
IncludedRecipients	Obligatoire	System.Nullable	Le paramètre IncludedRecipients filtre les types de destinataires qui sont utilisés pour créer le groupe de distribution dynamique. Vous ne pouvez pas utiliser le paramètre IncludedRecipients si le paramètre RecipientFilter est spécifié. Les valeurs disponibles pour le paramètre IncludedRecipients sont AllRecipients, MailboxUsers, Resources, MailContacts, MailGroups, Mail Users et None. 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é.
Name	Obligatoire	System.String	Le paramètre Name spécifie le nom du groupe de distribution dynamique. Si le paramètre DisplayName n'est pas spécifié, la valeur de Name est également utilisée pour DisplayName. 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 dynamique 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 dynamique dans la console de gestion Exchange et dans la liste d'adresses globale (LAG) Exchange.
OrganizationalUnit	Obligatoire	Microsoft.Exchange.Configuration.Tasks.OrganizationalUnitIdParameter	Le paramètre OrganizationalUnit spécifie où créer le groupe de distribution dynamique dans Active Directory en utilisant une syntaxe de nom canonique.
RecipientFilter	Obligatoire	System.String	Le paramètre RecipientFilter filtre les destinataires à extension messagerie qui sont utilisés pour créer le groupe de distribution dynamique. Vous ne pouvez pas utiliser le paramètre RecipientFilter si l'un des paramètres suivants est spécifié : IncludedRecipients ConditionalCompany ConditionalCustomAttribute N (où N est une valeur comprise entre 1 et 15) ConditionalDepartment ConditionalStateOrProvince RecipientFilter utilise une syntaxe `OPath` pour interroger Active Directory et filtrer les destinataires. Pour plus d'informations sur les propriétés filtrables, consultez la rubrique Propriétés filtrables pour le paramètre -RecipientFilter.
Alias	Facultatif	System.String	Le paramètre Alias spécifie l'alias du groupe de distribution dynamique. La valeur du paramètre Alias permet de générer l'adresse de messagerie SMTP (Simple Mail Transfer Protocol) principale pour le groupe de distribution dynamique. La valeur du paramètre Alias ne peut pas contenir d'espaces. Si le paramètre Alias n'est pas spécifié, la valeur du paramètre Name est utilisée pour le paramètre Alias, après conversion des espaces contenues dans le paramètre Name en caractères de soulignement (_).
ConditionalCompany	Facultatif	Microsoft.Exchange.Data.MultiValuedProperty	Le paramètre ConditionalCompany filtre les utilisateurs de boîte aux lettres ou les contacts à extension messagerie qui sont utilisés pour créer le groupe de distribution dynamique. Lorsque plusieurs valeurs du paramètre ConditionalCompany sont séparées par des virgules, l'opérateur booléen OR est appliqué.
ConditionalCustomAttribute1	Facultatif	System.String	Le paramètre ConditionalCustomAttribute1 spécifie des attributs personnalisés. Vous pouvez les utiliser pour stocker des informations supplémentaires.
ConditionalCustomAttribute10	Facultatif	System.String	Le paramètre ConditionalCustomAttribute10 spécifie des attributs personnalisés. Vous pouvez les utiliser pour stocker des informations supplémentaires.
ConditionalCustomAttribute11	Facultatif	System.String	Le paramètre ConditionalCustomAttribute11 spécifie des attributs personnalisés. Vous pouvez les utiliser pour stocker des informations supplémentaires.
ConditionalCustomAttribute12	Facultatif	System.String	Le paramètre ConditionalCustomAttribute12 spécifie des attributs personnalisés. Vous pouvez les utiliser pour stocker des informations supplémentaires.
ConditionalCustomAttribute13	Facultatif	System.String	Le paramètre ConditionalCustomAttribute13 spécifie des attributs personnalisés. Vous pouvez les utiliser pour stocker des informations supplémentaires.
ConditionalCustomAttribute14	Facultatif	System.String	Le paramètre ConditionalCustomAttribute14 spécifie des attributs personnalisés. Vous pouvez les utiliser pour stocker des informations supplémentaires.
ConditionalCustomAttribute15	Facultatif	System.String	Le paramètre ConditionalCustomAttribute15 spécifie des attributs personnalisés. Vous pouvez les utiliser pour stocker des informations supplémentaires.
ConditionalCustomAttribute2	Facultatif	System.String	Le paramètre ConditionalCustomAttribute2 spécifie des attributs personnalisés. Vous pouvez les utiliser pour stocker des informations supplémentaires.
ConditionalCustomAttribute3	Facultatif	System.String	Le paramètre ConditionalCustomAttribute3 spécifie des attributs personnalisés. Vous pouvez les utiliser pour stocker des informations supplémentaires.
ConditionalCustomAttribute4	Facultatif	System.String	Le paramètre ConditionalCustomAttribute4 spécifie des attributs personnalisés. Vous pouvez les utiliser pour stocker des informations supplémentaires.
ConditionalCustomAttribute5	Facultatif	System.String	Le paramètre ConditionalCustomAttribute5 spécifie des attributs personnalisés. Vous pouvez les utiliser pour stocker des informations supplémentaires.
ConditionalCustomAttribute6	Facultatif	System.String	Le paramètre ConditionalCustomAttribute6 spécifie des attributs personnalisés. Vous pouvez les utiliser pour stocker des informations supplémentaires.
ConditionalCustomAttribute7	Facultatif	System.String	Le paramètre ConditionalCustomAttribute7 spécifie des attributs personnalisés. Vous pouvez les utiliser pour stocker des informations supplémentaires.
ConditionalCustomAttribute8	Facultatif	System.String	Le paramètre ConditionalCustomAttribute8 spécifie des attributs personnalisés. Vous pouvez les utiliser pour stocker des informations supplémentaires.
ConditionalCustomAttribute9	Facultatif	System.String	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 filtre les utilisateurs de boîte aux lettres ou les contacts à extension messagerie qui sont utilisés pour créer le groupe de distribution dynamique. Vous ne pouvez pas utiliser le paramètre ConditionalDepartment si le paramètre RecipientFilter est spécifié. Lorsque plusieurs valeurs du paramètre ConditionalDepartment sont séparées par des virgules, l'opérateur booléen OR est appliqué.
ConditionalStateOrProvince	Facultatif	Microsoft.Exchange.Data.MultiValuedProperty	Le paramètre ConditionalStateOrProvince filtre les utilisateurs de boîte aux lettres ou les contacts à extension messagerie qui sont utilisés pour créer le groupe de distribution dynamique. Vous ne pouvez pas utiliser le paramètre ConditionalStateOrProvince si le paramètre RecipientFilter est spécifié. Lorsque plusieurs valeurs du paramètre ConditionalStateOrProvince sont séparées par des virgules, l'opérateur booléen OR est appliqué.
DisplayName	Facultatif	System.String	Le paramètre DisplayName spécifie le nom du groupe de distribution dynamique dans la console de gestion Exchange et dans la liste d'adresses globale (LAG) Exchange. Si le paramètre DisplayName n'est pas spécifié, la valeur de 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.
RecipientContainer	Facultatif	Microsoft.Exchange.Configuration.Tasks.OrganizationalUnitIdParameter	Le paramètre RecipientContainer filtre les destinataires qui sont utilisés pour créer le groupe de distribution dynamique sur la base de leur emplacement dans Active Directory. La valeur de RecipientContainer peut être le nom canonique d'une unité d'organisation (UO) ou d'un domaine. Si aucune valeur n'est spécifiée pour RecipientContainer , le filtre de recherche par défaut est l'emplacement du groupe de distribution dynamique dans Active Directory. Cet emplacement est spécifié à l'aide du paramètre OrganizationalUnit.
TemplateInstance	Facultatif	System.Management.Automation.PSObject	Quand un objet existant est fourni au paramètre TemplateInstance, la commande utilise la configuration de l'objet pour créer une copie de celui-ci.

Types d'entrées

Types de retours

Erreurs

Erreur	Description

Exceptions

Exceptions	Description

Exemple

L'exemple de code suivant présente l'utilisation de la cmdlet New-DynamicDistributionGroup.

Le premier exemple crée un groupe de distribution dynamique nommé « Marketing Group » dans le conteneur Utilisateurs dans le domaine Contoso.com. Le groupe de distribution dynamique « Marketing Group » contient tous les utilisateurs de boîte aux lettres ou contacts à extension messagerie figurant dans le domaine Contoso.com, qui ont un champ Service contenant le terme « Marketing » ou « Sales ».

Le deuxième exemple utilise le paramètre RecipientFilter pour créer un groupe de distribution dynamique nommé « Pacific Northwest » dans le conteneur Utilisateurs dans le domaine Contoso.com. Le groupe de distribution dynamique « Pacific Northwest » contient tous les utilisateurs de boîte aux lettres figurant dans le domaine Contoso.com, qui ont un champ Département/Région contenant le terme « Washington » ou « Oregon ».

New-DynamicDistributionGroup -Name "Marketing Group" -Alias "Marketing_Group" -IncludedRecipients "MailboxUsers,MailContacts" -OrganizationalUnit "Contoso.com/Users" -ConditionalDepartment "Marketing","Sales" -RecipientContainer "Contoso.com"
New-DynamicDistributionGroup -Name "Pacific Northwest" -Alias "Pacific_Northwest" -OrganizationalUnit "Contoso.com/Users" -RecipientFilter {((RecipientType -eq 'UserMailbox') -and ((StateOrProvince -eq 'Washington' -or StateOrProvince -eq 'Oregon')))} -RecipientContainer "Contoso.com"

Share via