Add-EntraGroupMember

Module:
Microsoft.Entra.Groups Module v1.3

Ajoutez un membre à un groupe de sécurité ou de Microsoft 365.

Syntaxe

Default (Par défaut) 

Add-EntraGroupMember

    -GroupId <String>
    -MemberId <String>
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

Description

L’applet Add-EntraGroupMember de commande ajoute un membre à un groupe de sécurité ou de Microsoft 365.

New-EntraGroupMember et Add-EntraGroupMembership sont des alias de Add-EntraGroupMember.

Dans les scénarios délégués, l’utilisateur connecté a besoin d’un rôle Microsoft Entra pris en charge ou d’un rôle personnalisé avec l’autorisationmicrosoft.directory/groups/members/update. Les rôles minimaux requis pour cette opération, à l’exclusion des groupes assignables aux rôles, sont les suivants :

  • Propriétaires de groupes
  • Rédacteurs d'annuaires
  • Administrateur de groupes
  • Administrateur d’utilisateurs

Exemples

Exemple 1: Ajouter un membre à un groupe

Connect-Entra -Scopes 'GroupMember.ReadWrite.All'
$group = Get-EntraGroup -Filter "DisplayName eq 'Contoso Marketing Group'"
$user = Get-EntraUser -UserId 'SawyerM@contoso.com'
Add-EntraGroupMember -GroupId $group.Id -MemberId $user.Id

Cet exemple montre comment ajouter un membre à un groupe.

  • -GroupId - Spécifie l’identificateur unique (ID d’objet) du groupe auquel vous souhaitez ajouter un membre.
  • -MemberId - Spécifie l’identificateur unique (ID d’objet) du membre à ajouter au groupe. Vous pouvez ajouter des utilisateurs, des groupes de sécurité, des groupes de Microsoft 365, des appareils, des principaux de service et des contacts organisationnels aux groupes de sécurité. Seuls les utilisateurs peuvent être ajoutés à des groupes Microsoft 365.

Exemple 2 : Ajouter des membres en fonction des résultats de recherche à un groupe

Connect-Entra -Scopes 'GroupMember.ReadWrite.All'
$group = Get-EntraGroup -Filter "DisplayName eq 'Sales and Marketing'"
Get-EntraUser -Filter "startsWith(displayName,'Updated User')" |
    Add-EntraGroupMember -GroupId $group.Id

Cet exemple montre comment ajouter des membres en fonction d’un résultat de recherche à un groupe.

  • -GroupId - Spécifie l’identificateur unique (ID d’objet) du groupe auquel vous souhaitez ajouter un membre.

Exemple 3 : Synchroniser les utilisateurs d’un groupe à un autre

Connect-Entra -Scopes 'GroupMember.ReadWrite.All'
$group = Get-EntraGroup -Filter "DisplayName eq 'Sales and Marketing'"
Get-EntraGroupMember -GroupId "source-group-id" |
    Add-EntraGroupMember -GroupId $group.Id

Cet exemple montre comment synchroniser les membres du groupe cible source vers un nouveau groupe.

  • -GroupId - Spécifie l’identificateur unique (ID d’objet) du groupe auquel vous souhaitez ajouter un membre.

Paramètres

-GroupId

Spécifie l’ID d’un groupe dans Microsoft Entra ID.

Propriétés du paramètre

Type:System.String
Valeur par défaut:None
Prend en charge les caractères génériques:False
DontShow:False
Alias:Identifiant d'objet (ObjectId)

Jeux de paramètres

(All)
Position:Named
Obligatoire:True
Valeur du pipeline:True
Valeur du pipeline par nom de propriété:True
Valeur des arguments restants:False

-MemberId

Spécifie l’identificateur unique (ID d’objet) du membre à ajouter au groupe. Vous pouvez ajouter des utilisateurs, des groupes de sécurité, des groupes de Microsoft 365, des appareils, des principaux de service et des contacts organisationnels aux groupes de sécurité. Seuls les utilisateurs peuvent être ajoutés à des groupes Microsoft 365.

Propriétés du paramètre

Type:System.String
Valeur par défaut:None
Prend en charge les caractères génériques:False
DontShow:False
Alias:RefObjectId

Jeux de paramètres

(All)
Position:Named
Obligatoire:True
Valeur du pipeline:True
Valeur du pipeline par nom de propriété:True
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.