Add-EntraDirectoryRoleMember

Modul:
Microsoft.Entra.DirectoryManagement Module v1.3

Fügt einer Verzeichnisrolle ein Mitglied hinzu.

Syntax

Default (Standard) 

Add-EntraDirectoryRoleMember

    -DirectoryRoleId <String>
    -MemberId <String>
    [<CommonParameters>]

Beschreibung

Das Add-EntraDirectoryRoleMember Cmdlet fügt einer Microsoft Entra ID Rolle ein Mitglied hinzu.

In delegierten Szenarien muss der angemeldete Benutzer entweder über eine unterstützte Microsoft Entra Rolle oder eine benutzerdefinierte Rolle mit den erforderlichen Berechtigungen verfügen. Die für diesen Vorgang erforderlichen Mindestrollen sind:

  • Administrator für privilegierte Rollen

Beispiele

Beispiel 1: Hinzufügen eines Mitglieds zu einer Microsoft Entra ID Rolle

Connect-Entra -Scopes 'RoleManagement.ReadWrite.Directory'
$directoryRole = Get-EntraDirectoryRole -Filter "DisplayName eq 'Helpdesk Administrator'"
$user = Get-EntraUser -UserId 'SawyerM@Contoso.com'
Add-EntraDirectoryRoleMember -DirectoryRoleId $directoryRole.Id -MemberId $user.Id

In diesem Beispiel wird einer Verzeichnisrolle ein Mitglied hinzugefügt.

  • DirectoryRoleId der Parameter gibt die ID der Verzeichnisrolle an, der das Mitglied hinzugefügt wird. Verwenden Sie den Befehl Get-EntraDirectoryRole, um die Details der Verzeichnisrolle abzurufen.
  • MemberIdder Parameter gibt die ID des Microsoft Entra ID Objekts an, das als Besitzer/Manager/Mitglied zugewiesen werden soll.

Parameter

-DirectoryRoleId

Gibt die ID einer Verzeichnisrolle 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 die ID des Microsoft Entra ID-Objekts an, das als Besitzer/Manager/Mitglied zugewiesen werden soll.

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.