Update-EOPDistributionGroupMember

 

S’applique à :Exchange Online Protection

Dernière rubrique modifiée :2016-04-06

Cette cmdlet est disponible uniquement dans Exchange Online Protection.

La cmdlet Update-EOPDistributionGroupMember permet d’ajouter ou de supprimer des membres dans les groupes de distribution et les groupes de sécurité à extension messagerie dans la version autonome de MicrosoftExchange Online Protection (EOP). Cette cmdlet n’est pas disponible avec les services CAL Exchange Enterprise (EOP Premium). Dans EOP Premium, utilisez la cmdlet Update-DistributionGroupMember.

noteRemarque :
De manière générale, les clients Exchange Online Protection (EOP) autonomes qui disposent également d’organisations Active Directory locales utilisent la synchronisation d’annuaires pour créer des utilisateurs et des groupes dans EOP. Toutefois, si vous ne pouvez pas utiliser la synchronisation d’annuaires, vous pouvez utiliser les cmdlets pour créer et gérer les utilisateurs et les groupes dans EOP.
importantImportant :
Cette cmdlet utilise une méthode de traitement par lots qui se traduit par un retard de propagation de quelques minutes avant que les résultats de la cmdlet ne soient visibles.

Pour plus d'informations sur les jeux de paramètres dans la section Syntaxe ci-après, voir SyntaxeSyntaxe de cmdlet Exchange.

Update-EOPDistributionGroupMember -Identity <DistributionGroupIdParameter> [-ExternalDirectoryObjectId <String>] [-Members <String[]>]

Cet exemple remplace les membres actuels du groupe de distribution « Security Team» par Kitty Petersen et Tyson Fawcett.

Update-EOPDistributionGroupMember -Identity "Security Team" -Members @("Kitty Petersen","Tyson Fawcett")

Cet exemple ajoute un nouvel utilisateur, à savoir Tyson Fawcett, au groupe de distribution nommé « Security Team», tout en conservant les membres actuels du groupe. Les objets membres actuels sont récupérés dans une collection, la collection est filtrée pour extraire les noms, l’utilisateur « Tyson Fawcett » est ajouté et la liste des noms mise à jour remplace la composition actuelle du groupe de distribution.

$CurrentMemberObjects = Get-DistributionGroupMember "Security Team"
$CurrentMemberNames = $CurrentMemberObjects | % {$_.name}
$CurrentMemberNames += "Tyson Fawcett"
Update-EOPDistributionGroupMember -Identity "Security Team" -Members $CurrentMemberNames

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 et de sécurité et groupes de distribution  » dans la rubrique Autorisations des fonctionnalités dans EOP.

 

Paramètre Obligatoire Type Description

Identity

Obligatoire

Microsoft.Exchange.Configuration.Tasks.DistributionGroupIdParameter

Le paramètre Identity spécifie le groupe de distribution ou le groupe de sécurité à extension messagerie à mettre à jour. Vous pouvez utiliser n’importe quelle valeur qui identifie de manière unique le groupe.

Par exemple :

  • Nom

  • Nom complet

  • Alias

  • Nom unique

  • Nom unique canonique

  • Adresse de messagerie

  • GUID

ExternalDirectoryObjectId

Facultatif

System.String

Ce paramètre est réservé à l’usage interne chez Microsoft.

Members

Facultatif

System.String[]

Le paramètre Members spécifie la liste des destinataires (objets à extension messagerie) dans le groupe de distribution ou le groupe de sécurité à extension messagerie. Dans Exchange Online Protection, les types de destinataires valides sont les suivants :

  • Utilisateurs de messagerie

  • Groupes de distribution

  • Groupes de sécurité à extension messagerie

Vous pouvez utiliser une valeur quelconque qui identifie le destinataire.

Par exemple :

  • Nom

  • Nom complet

  • Alias

  • Nom unique

  • Nom unique canonique

  • Adresse de messagerie

  • GUID

Pour remplacer les membres actuels du groupe par les destinataires que vous indiquez, utilisez la syntaxe @("<recipient1>","<recipient2>"...). Pour ajouter de nouveaux membres au groupe sans supprimer les membres existants, suivez l’exemple 2 de la section Exemples.

Pour visualiser les types d’entrées acceptés par cette cmdlet, consultez la rubrique Types d’entrée et de sortie de la cmdlet d’Exchange Management Shell. 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 retours, également appelés types de sorties, acceptés par cette cmdlet, consultez la rubrique Types d’entrée et de sortie de la cmdlet d’Exchange Management Shell. Si le champ Type de sortie est vide, la cmdlet ne renvoie pas de données.

 
Afficher: