.png)
Get-DynamicDistributionGroup
S’applique à : Exchange Server 2013, Exchange Online
Dernière rubrique modifiée : 2012-07-11
La cmdlet Get-DynamicDistributionGroup permet d'extraire les paramètres d'un groupe de distribution dynamique existant.
Pour plus d'informations sur les jeux de paramètres dans la section Syntaxe ci-après, voir Syntaxe.
Get-DynamicDistributionGroup [-ManagedBy <GeneralRecipientIdParameter>] <COMMON PARAMETERS>
Get-DynamicDistributionGroup [-Anr <String>] <COMMON PARAMETERS>
Get-DynamicDistributionGroup [-Identity <DynamicGroupIdParameter>] <COMMON PARAMETERS>
COMMON PARAMETERS: [-AccountPartition <AccountPartitionIdParameter>] [-Credential <PSCredential>] [-DomainController <Fqdn>] [-Filter <String>] [-IgnoreDefaultScope <SwitchParameter>] [-Organization <OrganizationIdParameter>] [-OrganizationalUnit <OrganizationalUnitIdParameter>] [-ReadFromDomainController <SwitchParameter>] [-ResultSize <Unlimited>] [-SortBy <String>]
Cet exemple extrait le groupe de distribution dynamique Marketing et canalise l'objet vers la commande Format-List, afin d'afficher les informations concernant le groupe de distribution dynamique.
Get-DynamicDistributionGroup -Identity "Marketing" | Format-List
Cet exemple extrait tous les groupes de distribution dynamique qui contiennent la chaîne « research » et canalise l’objet à la commande Format-Table, afin d’afficher les noms de groupe de distribution dynamique et les personnes qui les gèrent.
Get-DynamicDistributionGroup -Anr *research* | Format-Table Name, ManagedBy
Vous pouvez utiliser des groupes de distribution pour créer des listes de distribution de courrier électronique et des groupes de sécurité de messagerie pour attribuer des autorisations à des ressources partagées. Les groupes de distribution ne peuvent être utilisés qu’avec des applications de courrier électronique (telles que Microsoft Exchange pour envoyer des messages électroniques à des regroupements d’utilisateurs. La cmdlet Get-DynamicDistributionGroup permet d'extraire les paramètres d'un groupe de distribution dynamique existant dans Active Directory.
Des autorisations doivent vous être attribuées avant de pouvoir exécuter cette cmdlet. Bien que tous les paramètres de cette cmdlet soient répertoriés dans cette rubrique, il est possible que vous n’ayez pas accès à certains paramètres s’ils ne sont pas inclus dans les autorisations qui vous ont été attribuées. Pour voir les autorisations qui vous sont nécessaires, voir Entrée « Groupes de distribution dynamique » dans la rubrique Autorisations des destinataires.
| Paramètre | Obligatoire | Type | Description | ||
|---|---|---|---|---|---|
| AccountPartition | Facultatif | Microsoft.Exchange.Configuration.Tasks.AccountPartitionIdParameter | Ce paramètre est réservé à l’usage interne chez Microsoft. | ||
| Anr | Facultatif | System.String | Le paramètre Anr spécifie une chaîne sur laquelle une recherche de résolution de noms ANR (Ambiguous Name Resolution) peut porter. Vous pouvez spécifier une chaîne partielle et rechercher des objets ayant un attribut correspondant à cette chaîne. Les attributs par défaut recherchés sont :
| ||
| Credential | Facultatif | System.Management.Automation.PSCredential | Le paramètre Credential spécifie le nom d'utilisateur et le mot de passe à utiliser pour accéder à Active Directory. Ce paramètre requiert la création et la transmission d’un objet d’informations d’identification. L’objet d’informations d’identification est créé à l’aide de la cmdlet Get-Credential. Pour plus d’informations, consultez la rubrique Get-Credential. | ||
| DomainController | Facultatif | Microsoft.Exchange.Data.Fqdn | Le paramètre DomainController spécifie le nom de domaine complet du contrôleur de domaine qui récupère des données de Active Directory. | ||
| Filter | Facultatif | System.String | Le paramètre Filter indique le filtre OPath utilisé pour filtrer les destinataires. Pour plus d’informations sur les propriétés filtrables, voir Propriétés filtrables pour le paramètre -Filter. | ||
| Identity | Facultatif | Microsoft.Exchange.Configuration.Tasks.DynamicGroupIdParameter | Le paramètre Identity spécifie le groupe de distribution dynamique. Ce paramètre accepte les valeurs suivantes :
| ||
| IgnoreDefaultScope | Facultatif | System.Management.Automation.SwitchParameter | Le paramètre IgnoreDefaultScope donne pour instruction à la commande d’ignorer le paramétrage de la portée du destinataire par défaut pour la session Exchange Management Shell et d’utiliser l’ensemble de la forêt comme portée. Cela permet à la commande d’accéder à des objets Active Directory ne figurant pas actuellement dans la portée par défaut. L’utilisation du paramètre IgnoreDefaultScope introduit les restrictions suivantes :
| ||
| ManagedBy | Facultatif | Microsoft.Exchange.Configuration.Tasks.GeneralRecipientIdParameter | Le paramètre ManagedBy spécifie 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. Ce paramètre accepte les valeurs suivantes :
| ||
| Organization | Facultatif | Microsoft.Exchange.Configuration.Tasks.OrganizationIdParameter | Le paramètre Organization est réservé à l’usage interne chez Microsoft. | ||
| OrganizationalUnit | Facultatif | Microsoft.Exchange.Configuration.Tasks.OrganizationalUnitIdParameter | Le paramètre OrganizationalUnit limite les résultats à un conteneur d'unités d'organisation (OU) 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.
| ||
| ResultSize | Facultatif | Microsoft.Exchange.Data.Unlimited | Le paramètre ResultSize spécifie le nombre maximal d'objets destinataire à renvoyer. | ||
| SortBy | Facultatif | System.String | L'attribut SortBy permet de trier les résultats. |
Remarque : Pour visualiser les types d’entrées acceptées par cette cmdlet, voir Types d’entrée et de sortie de la cmdlet. Si le champ Type d’entrée pour une cmdlet est vide, la cmdlet n’accepte pas les données d’entrée.
Pour visualiser les types de retour, connus également en tant que types de sortie, acceptés par cette cmdlet, voir Types d’entrée et de sortie de la cmdlet. Si le champ Type de sortie est vide, la cmdlet ne retourne pas de données.
