Get-DistributionGroup (RTM)
S’applique à : Exchange Server 2007
Dernière rubrique modifiée : 2008-02-27
La cmdlet Get-DistributionGroup permet de lancer une interrogation sur des groupes de distribution existants.
Syntaxe
Get-DistributionGroup [-Identity <DistributionGroupIdParameter>] [-Credential <PSCredential>] [-DomainController <Fqdn>] [-ManagedBy <GeneralRecipientIdParameter>] [-OrganizationalUnit <OrganizationalUnitIdParameter>] [-ReadFromDomainController <SwitchParameter>] [-RecipientTypeDetails <RecipientTypeDetails[]>] [-ResultSize <Unlimited>] [-SortBy <String>]
Get-DistributionGroup [-Credential <PSCredential>] [-DomainController <Fqdn>] [-Filter <String>] [-ManagedBy <GeneralRecipientIdParameter>] [-OrganizationalUnit <OrganizationalUnitIdParameter>] [-ReadFromDomainController <SwitchParameter>] [-RecipientTypeDetails <RecipientTypeDetails[]>] [-ResultSize <Unlimited>] [-SortBy <String>]
Get-DistributionGroup [-Anr <String>] [-Credential <PSCredential>] [-DomainController <Fqdn>] [-ManagedBy <GeneralRecipientIdParameter>] [-OrganizationalUnit <OrganizationalUnitIdParameter>] [-ReadFromDomainController <SwitchParameter>] [-RecipientTypeDetails <RecipientTypeDetails[]>] [-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 Exchange) pour envoyer des messages électroniques à des ensembles d'utilisateurs. Vous pouvez utiliser la commande Get-DistributionGroup pour lancer une interrogation sur des groupes de distribution existants.
Pour exécuter la cmdlet Get-DistributionGroup, 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 Microsoft 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 le service d'annuaire 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.DistributionGroupIdParameter |
Le paramètre Identity du groupe de distribution prend l'une des formes suivantes :
|
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. |
RecipientTypeDetails |
Facultatif |
Microsoft.Exchange.Data.Directory.Recipient.RecipientTypeDetails[] |
Le paramètre RecipientTypeDetails spécifie le type des destinataires renvoyés. Les types de destinataires dans Microsoft Exchange Server 2007 sont divisés en types et sous-types de destinataires. Chaque type de destinataire contient toutes les propriétés de tous les sous-types. Par exemple, le type UserMailbox représente un compte d'utilisateur dans Active Directory avec une boîte aux lettres associée. Comme il y a plusieurs types de boîtes aux lettres, chaque type est identifié par le paramètre RecipientTypeDetails. Par exemple, une boîte aux lettres de salle de conférence a le paramètre RecipientTypeDetails défini sur ConferenceRoomMailbox, tandis qu'une boîte aux lettres d'utilisateur a le paramètre RecipientTypeDetails défini sur UserMailbox. Pour cette commande, les détails de type de destinataire disponible sont les suivants :
|
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-DistributionGroup. Dans cet exemple, la commande Get-DistributionGroup extrait le groupe Distribution Group1 et canalise l’objet à la commande Format-List pour afficher les informations concernant le groupe de distribution.
Get-DistributionGroup -Identity "Distribution Group1" | Format-List