Partager via

Add-UnifiedGroupLinks

  • Référence
Module:
ExchangePowerShell
S’applique à:
Exchange Online, Exchange Online Protection

Cette cmdlet est disponible uniquement dans le service cloud.

Utilisez l’applet de commande Add-UnifiedGroupLinks pour ajouter des membres, des propriétaires et des abonnés à Groupes Microsoft 365 dans votre organisation cloud. Pour supprimer des membres, des propriétaires et des abonnés, utilisez l’applet de commande Remove-UnifiedGroupLinks. Pour modifier d’autres propriétés de Groupes Microsoft 365, utilisez l’applet de commande Set-UnifiedGroup.

Remarque : Vous ne pouvez pas utiliser cette applet de commande pour modifier les membres, propriétaires ou abonnés du groupe Microsoft 365 si vous vous connectez à l’aide de l’authentification basée sur les certificats (également appelée authentification par certificat ou authentification d’application uniquement pour les scripts sans assistance) ou de l’identité managée Azure. Vous pouvez utiliser Microsoft Graph à la place. Pour plus d’informations, consultez Type de ressource de groupe.

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

Syntax

Add-UnifiedGroupLinks
   [-Identity] <UnifiedGroupIdParameter>
   -Links <RecipientIdParameter[]>
   -LinkType <LinkType>
   [-Confirm]
   [-WhatIf]
   [<CommonParameters>]

Description

Groupes Microsoft 365 sont des objets de groupe disponibles dans les services Microsoft 365.

Des autorisations doivent vous être attribuées avant de pouvoir exécuter cette cmdlet. Bien que cette rubrique répertorie tous les paramètres de cette cmdlet, 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 rechercher les autorisations requises pour exécuter une cmdlet ou un paramètre dans votre organisation, voir Find the permissions required to run any Exchange cmdlet.

Remarque : Seuls les membres peuvent être propriétaires d’un groupe. Vous devez donc d’abord ajouter un utilisateur en tant que membre avant de l’ajouter en tant que propriétaire. Les utilisateurs invités ne peuvent pas être propriétaires de groupes, même si les utilisateurs sont membres des groupes.

Exemples

Exemple 1

Add-UnifiedGroupLinks -Identity "Legal Department" -LinkType Members -Links chris@contoso.com,michelle@contoso.com

Cet exemple ajoute des membres chris@contoso.com et michelle@contoso.com au groupe Microsoft 365 nommé Service juridique.

Exemple 2

$users= Get-User -ResultSize unlimited | where {$_.Department -eq "Marketing" -AND $_.RecipientType -eq "UserMailbox"}

Add-UnifiedGroupLinks -Identity Marketing -LinkType members -Links ($users.UserPrincipalName)

Cet exemple montre comment ajouter des membres en bloc à un groupe Microsoft 365. Les boîtes aux lettres où l’attribut Department est « Marketing » sont ajoutées au groupe Microsoft 365 nommé Marketing.

Paramètres

-Confirm

Le commutateur Confirme spécifie s’il faut afficher ou masquer l’invite de confirmation. L’incidence de ce commutateur sur la cmdlet varie selon que la cmdlet requiert une confirmation avant de poursuivre.

  • Les applets de commande destructrices (par exemple, les applets de commande Remove-*) ont une pause intégrée qui vous oblige à accuser réception de la commande avant de continuer. Pour ces cmdlets, vous pouvez ignorer l’invite de confirmation à l’aide de cette syntaxe exacte : -Confirm:$false.
  • La plupart des autres applets de commande (par exemple, les applets de commande New-* et Set-*) n’ont pas de pause intégrée. Pour ces cmdlets, la spécification du commutateur Confirm sans valeur introduit une pause qui vous oblige à confirmer la commande avant de poursuivre.
Type:SwitchParameter
Aliases:cf
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Online, Exchange Online Protection

-Identity

Le paramètre Identity spécifie le groupe Microsoft 365 que vous souhaitez modifier. Vous pouvez utiliser n’importe quelle valeur qui identifie de façon unique le groupe Microsoft 365. Par exemple :

  • Nom
  • Alias
  • Nom unique
  • Nom unique
  • Nom unique canonique
  • GUID
Type:UnifiedGroupIdParameter
Position:1
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False
Applies to:Exchange Online, Exchange Online Protection

-Links

Le paramètre Links spécifie les destinataires à ajouter au groupe Microsoft 365. Vous spécifiez si ces destinataires sont des membres, des propriétaires ou des abonnés à l’aide du paramètre LinkType.

Vous pouvez utiliser une valeur quelconque qui identifie le destinataire. Par exemple :

  • Nom
  • Alias
  • Nom unique
  • Nom unique
  • Nom unique canonique
  • GUID

Vous pouvez entrer plusieurs valeurs séparées par des virgules. Si les valeurs contiennent des espaces ou requièrent des guillemets, utilisez la syntaxe suivante : "Value1","Value2",..."ValueN".

Vous devez utiliser ce paramètre avec le paramètre LinkType, ce qui signifie que les destinataires spécifiés recevront tous le même rôle dans le groupe Microsoft 365 (vous ne pouvez pas ajouter de destinataires avec des rôles différents dans la même commande).

Type:RecipientIdParameter[]
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Online, Exchange Online Protection

-LinkType

Le paramètre LinkType spécifie le rôle du destinataire dans le groupe Microsoft 365 que vous souhaitez ajouter. Les valeurs valides sont les suivantes :

  • Membres : participez à des conversations, créez des canaux Teams, collaborez sur des fichiers et modifiez le site SharePoint connecté.
  • Propriétaires : ajoutez ou supprimez des membres, supprimez des conversations, modifiez les paramètres d’équipe, supprimez l’équipe et contrôle total du site SharePoint connecté. Un groupe doit avoir au moins un propriétaire.
  • Abonnés : membres qui reçoivent des notifications de conversation et d’événements de calendrier du groupe. Tous les abonnés sont membres du groupe, mais tous les membres ne sont pas nécessairement abonnés (selon la valeur de la propriété AutoSubscribeNewMembers du groupe et le moment où le membre a été ajouté).

Dans PowerShell, tout propriétaire ou abonné que vous souhaitez ajouter au groupe doit également être membre.

Vous devez utiliser ce paramètre avec le paramètre LinkType.

Type:LinkType
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Online, Exchange Online Protection

-WhatIf

Le commutateur WhatIf simule les actions de la commande. Vous pouvez utiliser ce commutateur pour afficher les modifications qui se produiraient sans réellement appliquer ces modifications. Il n’est pas nécessaire de spécifier une valeur pour ce commutateur.

Type:SwitchParameter
Aliases:wi
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Online, Exchange Online Protection