Add-UnifiedGroupLinks
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 organization 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 Azure identité managée. Vous pouvez utiliser Microsoft Graph à la place. Pour plus d’informations, consultez Type de ressource de groupe.
À l’aide de cette applet de commande, seuls les membres du groupe peuvent être propriétaires du groupe. Ajoutez des utilisateurs en tant que membres avant de les ajouter en tant que propriétaires. Cette limitation ne s’applique pas aux portails de gestion web où vous pouvez ajouter des non-membres en tant que propriétaires de groupe. Les utilisateurs invités ne peuvent jamais être propriétaires de groupes.
Pour plus d’informations sur les jeux de paramètres dans la section Syntaxe ci-après, voir Syntaxe da la cmdlet Exchange.
Syntaxe
Default (Par défaut)
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 cet article répertorie tous les paramètres de l’applet de commande, il se peut que vous n’ayez pas accès à certains paramètres s’ils ne sont pas inclus dans les autorisations qui vous sont 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
Applicable : Exchange Online, module complémentaire de sécurité intégré pour les boîtes aux lettres locales
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-*) comportent 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.
Propriétés du paramètre
| Type: | SwitchParameter |
| Valeur par défaut: | None |
| Prend en charge les caractères génériques: | False |
| DontShow: | False |
| Alias: | Cf |
Jeux de paramètres
(All)
| Position: | Named |
| Obligatoire: | False |
| Valeur du pipeline: | False |
| Valeur du pipeline par nom de propriété: | False |
| Valeur des arguments restants: | False |
-Identity
Applicable : Exchange Online, module complémentaire de sécurité intégré pour les boîtes aux lettres locales
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
Propriétés du paramètre
| Type: | UnifiedGroupIdParameter |
| Valeur par défaut: | None |
| Prend en charge les caractères génériques: | False |
| DontShow: | False |
Jeux de paramètres
(All)
| Position: | 1 |
| Obligatoire: | True |
| Valeur du pipeline: | True |
| Valeur du pipeline par nom de propriété: | True |
| Valeur des arguments restants: | False |
-Links
Applicable : Exchange Online, module complémentaire de sécurité intégré pour les boîtes aux lettres locales
Le paramètre Links spécifie les destinataires à ajouter au groupe Microsoft 365. Pour spécifier si ces destinataires sont des membres, des propriétaires ou des abonnés, vous devez utiliser le 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 reçoivent 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).
Remarque : À l’aide de cette applet de commande, seuls les membres du groupe peuvent être propriétaires du groupe. Ajoutez des utilisateurs en tant que membres avant de les ajouter en tant que propriétaires. Cette limitation ne s’applique pas aux portails de gestion web où vous pouvez ajouter des non-membres en tant que propriétaires de groupe. Les utilisateurs invités ne peuvent jamais être propriétaires de groupes.
Propriétés du paramètre
| Type: | RecipientIdParameter[] |
| Valeur par défaut: | None |
| Prend en charge les caractères génériques: | False |
| DontShow: | False |
Jeux de paramètres
(All)
| Position: | Named |
| Obligatoire: | True |
| Valeur du pipeline: | False |
| Valeur du pipeline par nom de propriété: | False |
| Valeur des arguments restants: | False |
-LinkType
Applicable : Exchange Online, module complémentaire de sécurité intégré pour les boîtes aux lettres locales
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 existants du groupe qui reçoivent des notifications d’événements de conversation et de calendrier de la part 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é).
Vous devez utiliser ce paramètre avec le paramètre Links.
Remarque : À l’aide de cette applet de commande, seuls les membres du groupe peuvent être propriétaires du groupe. Ajoutez des utilisateurs en tant que membres avant de les ajouter en tant que propriétaires. Cette limitation ne s’applique pas aux portails de gestion web où vous pouvez ajouter des non-membres en tant que propriétaires de groupe. Les utilisateurs invités ne peuvent jamais être propriétaires de groupes.
Propriétés du paramètre
| Type: | LinkType |
| Valeur par défaut: | None |
| Prend en charge les caractères génériques: | False |
| DontShow: | False |
Jeux de paramètres
(All)
| Position: | Named |
| Obligatoire: | True |
| Valeur du pipeline: | False |
| Valeur du pipeline par nom de propriété: | False |
| Valeur des arguments restants: | False |
-WhatIf
Applicable : Exchange Online, module complémentaire de sécurité intégré pour les boîtes aux lettres locales
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.
Propriétés du paramètre
| Type: | SwitchParameter |
| Valeur par défaut: | None |
| Prend en charge les caractères génériques: | False |
| DontShow: | False |
| Alias: | Wi |
Jeux de paramètres
(All)
| Position: | Named |
| Obligatoire: | False |
| Valeur du pipeline: | False |
| Valeur du pipeline par nom de propriété: | False |
| Valeur des arguments restants: | False |
CommonParameters
Cette applet de commande prend en charge les paramètres courants : -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction et -WarningVariable. Pour plus d’informations, consultez about_CommonParameters.