Partager via

Get-DynamicDistributionGroup (RTM)

  • Article

 

S’applique à : Exchange Server 2007

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

La cmdlet Get-DynamicDistributionGroup permet d'extraire les paramètres d'un groupe de distribution dynamique existant.

Syntaxe

Get-DynamicDistributionGroup [-Identity <DynamicGroupIdParameter>] [-Credential <PSCredential>] [-DomainController <Fqdn>] [-ManagedBy <GeneralRecipientIdParameter>] [-OrganizationalUnit <OrganizationalUnitIdParameter>] [-ReadFromDomainController <SwitchParameter>] [-ResultSize <Unlimited>] [-SortBy <String>]

Get-DynamicDistributionGroup [-Credential <PSCredential>] [-DomainController <Fqdn>] [-Filter <String>] [-ManagedBy <GeneralRecipientIdParameter>] [-OrganizationalUnit <OrganizationalUnitIdParameter>] [-ReadFromDomainController <SwitchParameter>] [-ResultSize <Unlimited>] [-SortBy <String>]

Get-DynamicDistributionGroup [-Anr <String>] [-Credential <PSCredential>] [-DomainController <Fqdn>] [-ManagedBy <GeneralRecipientIdParameter>] [-OrganizationalUnit <OrganizationalUnitIdParameter>] [-ReadFromDomainController <SwitchParameter>] [-ResultSize <Unlimited>] [-SortBy <String>]

Description détaillée

Vous pouvez utiliser des groupes de distribution pour créer des listes de distribution et des groupes de sécurité de messagerie pour attribuer des autorisations à des ressources partagées. Vous ne pouvez utiliser des groupes de distribution qu'avec des applications électroniques (telles que Microsoft Exchange) pour envoyer des messages électroniques à des ensembles d'utilisateurs. La cmdlet Get-DynamicDistributionGroup permet d'extraire les paramètres d'un groupe de distribution dynamique existant dans le service d'annuaire Active Directory.

Pour exécuter la cmdlet Get-DynamicDistributionGroup, vous devez utiliser un compte auquel a été délégué :

  • le rôle Administrateur Affichage seul d'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

Anr

Facultatif

System.String

Le paramètre Anr indique que l'argument sera résolu à l'aide d'une résolution de nom ambigu (ANR).

Credential

Facultatif

System.Management.Automation.PSCredential

Le paramètre Credential indique les noms de domaine et d'utilisateur du compte utilisé pour lire Active Directory.

DomainController

Facultatif

Microsoft.Exchange.Data.Fqdn

Pour spécifier le nom de domaine complet (FQDN) du contrôleur de domaine qui extrait des données depuis Active Directory, incluez le paramètre DomainController dans la commande.

Filter

Facultatif

System.String

Le paramètre Filter indique le filtre OPath utilisé pour filtrer des destinataires.

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

Identity

Facultatif

Microsoft.Exchange.Configuration.Tasks.DynamicGroupIdParameter

Le paramètre Identity du groupe de distribution prend l'une des formes suivantes :

  • GUID

  • Nom unique

  • Nom d'utilisateur principal (UPN)

  • LegacyExchangeDN

  • Domaine\Nom de compte

  • Alias

  • Adresse SMTP (Simple Mail Transfer Protocol) principale

ManagedBy

Facultatif

Microsoft.Exchange.Configuration.Tasks.GeneralRecipientIdParameter

Le paramètre ManagedBy indique le nom unique (DN) de l'utilisateur ou du contact qui gère le groupe.

OrganizationalUnit

Facultatif

Microsoft.Exchange.Configuration.Tasks.OrganizationalUnitIdParameter

Le paramètre OrganizationalUnit limite les résultats à un conteneur d'unités d'organisation (UO) spécifique.

ReadFromDomainController

Facultatif

System.Management.Automation.SwitchParameter

Le paramètre ReadFromDomainController spécifie que les informations utilisateur sont lues à partir d'un contrôleur de domaine dans le domaine de l'utilisateur. Si vous définissez la portée du destinataire pour inclure tous les destinataires de la forêt et si vous n'utilisez pas ce paramètre, il est possible que les informations utilisateur soient lues à partir d'un catalogue global avec des informations obsolètes. Si vous utilisez ce paramètre, plusieurs lectures peuvent être nécessaires pour obtenir les informations.

> [!Note] > Par défaut, la portée du destinataire est définie sur le domaine qui héberge vos serveurs Exchange.

ResultSize

Facultatif

Microsoft.Exchange.Data.Unlimited

Le paramètre ResultSize indique le nombre maximal d'objets destinataire qui seront retournés.

SortBy

Facultatif

System.String

L'attribut SortBy permet de trier les résultats.

Types d'entrées

Types de retours

Erreurs

Erreur Description

 

Exceptions

Exceptions Description

Exemple

L'exemple de code suivant illustre la commande Get-DynamicDistributionGroup. Dans cet exemple, la commande Get-DynamicDistributionGroup extrait le groupe de distribution dynamique Marketing et canalise l’objet vers la commande Format-List pour afficher les informations concernant le groupe de distribution dynamique.

Get-DynamicDistributionGroup -Identity "Marketing" | Format-List