Add-EntraGroupMember

Modul:
Microsoft.Entra.Groups Module v1.3

Fügen Sie ein Mitglied zu einer Sicherheits- oder Microsoft 365 Gruppe hinzu.

Syntax

Default (Standard) 

Add-EntraGroupMember

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

Beschreibung

Das Add-EntraGroupMember Cmdlet fügt ein Mitglied zu einer Sicherheits- oder Microsoft 365 Gruppe hinzu.

New-EntraGroupMember und Add-EntraGroupMembership sind Aliase von Add-EntraGroupMember.

In delegierten Szenarien benötigt der angemeldete Benutzer eine unterstützte Microsoft Entra Rolle oder eine benutzerdefinierte Rolle mit der microsoft.directory/groups/members/update Berechtigung. Die für diesen Vorgang erforderlichen Mindestrollen, mit Ausnahme von rollenzuweisungsfähigen Gruppen, sind:

  • Gruppenbesitzer
  • Verzeichnisautoren
  • Gruppenadministrator
  • Benutzeradministrator

Beispiele

Beispiel 1: Hinzufügen eines Mitglieds zu einer Gruppe

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 diesem Beispiel wird das Hinzufügen eines Mitglieds zu einer Gruppe veranschaulicht.

  • -GroupId - Gibt den eindeutigen Bezeichner (Objekt-ID) der Gruppe an, der Sie ein Mitglied hinzufügen möchten.
  • -MemberId - Gibt den eindeutigen Bezeichner (Objekt-ID) des Mitglieds an, das der Gruppe hinzugefügt werden soll. Sie können Benutzern, Sicherheitsgruppen, Microsoft 365 Gruppen, Geräten, Dienstprinzipalen und Organisationskontakten Sicherheitsgruppen hinzufügen. Nur Benutzer können Microsoft 365 Gruppen hinzugefügt werden.

Beispiel 2: Hinzufügen von Mitgliedern basierend auf Suchergebnissen zu einer Gruppe

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 diesem Beispiel wird veranschaulicht, wie Mitglieder basierend auf einem Suchergebnis zu einer Gruppe hinzugefügt werden.

  • -GroupId - Gibt den eindeutigen Bezeichner (Objekt-ID) der Gruppe an, der Sie ein Mitglied hinzufügen möchten.

Beispiel 3: Synchronisieren von Benutzern aus einer Gruppe mit einer anderen

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 diesem Beispiel wird veranschaulicht, wie Gruppenmitglieder aus der Quellzielgruppe mit einer neuen Gruppe synchronisiert werden.

  • -GroupId - Gibt den eindeutigen Bezeichner (Objekt-ID) der Gruppe an, der Sie ein Mitglied hinzufügen möchten.

Parameter

-GroupId

Gibt die ID einer Gruppe in Microsoft Entra ID an.

Parametereigenschaften

Typ:System.String
Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False
Aliase:Objekt-ID

Parametersätze

(All)
Position:Named
Obligatorisch:True
Wert aus Pipeline:True
Wert aus Pipeline nach dem Eigenschaftsnamen:True
Wert aus verbleibenden Argumenten:False

-MemberId

Gibt den eindeutigen Bezeichner (Objekt-ID) des Elements an, das der Gruppe hinzugefügt werden soll. Sie können Benutzern, Sicherheitsgruppen, Microsoft 365 Gruppen, Geräten, Dienstprinzipalen und Organisationskontakten Sicherheitsgruppen hinzufügen. Nur Benutzer können Microsoft 365 Gruppen hinzugefügt werden.

Parametereigenschaften

Typ:System.String
Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False
Aliase:RefObjectId

Parametersätze

(All)
Position:Named
Obligatorisch:True
Wert aus Pipeline:True
Wert aus Pipeline nach dem Eigenschaftsnamen:True
Wert aus verbleibenden Argumenten:False

CommonParameters

Dieses Cmdlet unterstützt die allgemeinen Parameter -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction und -WarningVariable. Weitere Informationen findest du unter about_CommonParameters.