Add-EntraGroupMember

Module:
Microsoft.Entra.Groups Module v1.3

Voeg een lid toe aan een beveiligings- of Microsoft 365 groep.

Syntax

Default (Standaard) 

Add-EntraGroupMember

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

Description

De Add-EntraGroupMember cmdlet voegt een lid toe aan een beveiligings- of Microsoft 365 groep.

New-EntraGroupMember en Add-EntraGroupMembership zijn aliassen van Add-EntraGroupMember.

In gedelegeerde scenario's heeft de aangemelde gebruiker een ondersteunde Microsoft Entra-rol of een aangepaste rol met de microsoft.directory/groups/members/update machtiging nodig. De minimale rollen die vereist zijn voor deze bewerking, met uitzondering van rollentoewijsbare groepen, zijn:

  • Groepseigenaren
  • Adreslijstschrijvers
  • Groepsbeheerder
  • Gebruikersbeheerder

Voorbeelden

Voorbeeld 1: Een lid toevoegen aan een groep

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

In dit voorbeeld ziet u hoe u een lid toevoegt aan een groep.

  • -GroupId - Hiermee geeft u de unieke id (object-id) van de groep waaraan u een lid wilt toevoegen.
  • -MemberId - Hiermee geeft u de unieke id (object-id) van het lid dat aan de groep moet worden toegevoegd. U kunt gebruikers, beveiligingsgroepen, Microsoft 365 groepen, apparaten, service-principals en organisatiecontactpersonen toevoegen aan beveiligingsgroepen. Alleen gebruikers kunnen worden toegevoegd aan Microsoft 365 groepen.

Voorbeeld 2: Leden toevoegen op basis van zoekresultaten aan een groep

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

In dit voorbeeld ziet u hoe u leden toevoegt op basis van een zoekresultaat aan een groep.

  • -GroupId - Hiermee geeft u de unieke id (object-id) van de groep waaraan u een lid wilt toevoegen.

Voorbeeld 3: Gebruikers van de ene groep naar een andere synchroniseren

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

In dit voorbeeld ziet u hoe u groepsleden synchroniseert van de brondoelgroep naar een nieuwe groep.

  • -GroupId - Hiermee geeft u de unieke id (object-id) van de groep waaraan u een lid wilt toevoegen.

Parameters

-GroupId

Hiermee geeft u de id van een groep in Microsoft Entra ID.

Parametereigenschappen

Type:System.String
Default value:None
Ondersteunt jokertekens:False
DontShow:False
Aliassen:ObjectId

Parametersets

(All)
Position:Named
Verplicht:True
Waarde uit pijplijn:True
Waarde uit pijplijn op eigenschapsnaam:True
Waarde van resterende argumenten:False

-MemberId

Hiermee geeft u de unieke id (object-id) van het lid dat aan de groep moet worden toegevoegd. U kunt gebruikers, beveiligingsgroepen, Microsoft 365 groepen, apparaten, service-principals en organisatiecontactpersonen toevoegen aan beveiligingsgroepen. Alleen gebruikers kunnen worden toegevoegd aan Microsoft 365 groepen.

Parametereigenschappen

Type:System.String
Default value:None
Ondersteunt jokertekens:False
DontShow:False
Aliassen:RefObjectId

Parametersets

(All)
Position:Named
Verplicht:True
Waarde uit pijplijn:True
Waarde uit pijplijn op eigenschapsnaam:True
Waarde van resterende argumenten:False

CommonParameters

Deze cmdlet ondersteunt de algemene parameters: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction en -WarningVariable. Zie about_CommonParametersvoor meer informatie.