Add-EntraDirectoryRoleMember

Moduł:
Microsoft.Entra.DirectoryManagement Module v1.3

Dodaje element członkowski do roli katalogu.

Składnia

Default (domyślnie) 

Add-EntraDirectoryRoleMember

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

Opis

Polecenie Add-EntraDirectoryRoleMember cmdlet dodaje element członkowski do roli Microsoft Entra ID.

W scenariuszach delegowanych zalogowany użytkownik musi mieć obsługiwaną rolę Microsoft Entra lub rolę niestandardową z niezbędnymi uprawnieniami. Minimalne role wymagane dla tej operacji to:

  • Administrator ról uprzywilejowanych

Przykłady

Przykład 1. Dodawanie członka do roli Microsoft Entra ID

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

W tym przykładzie element członkowski zostanie dodany do roli katalogu.

  • DirectoryRoleId parametr określa identyfikator roli katalogu, do której jest dodawany element członkowski. Użyj polecenia Get-EntraDirectoryRole, aby pobrać szczegóły roli katalogu.
  • MemberIdparametr określa identyfikator obiektu Microsoft Entra ID, który ma zostać przypisany jako właściciel/menedżer/członek.

Parametry

-DirectoryRoleId

Określa identyfikator roli katalogu w Microsoft Entra ID.

Właściwości parametru

Typ:System.String
Domyślna wartość:None
Obsługuje symbole wieloznaczne:False
DontShow:False
Aliasy:Identyfikator Obiektu

Zestawy parametrów

(All)
Position:Named
Obowiązkowe:True
Wartość z potoku:True
Wartość z potoku według nazwy właściwości:True
Wartość z pozostałych argumentów:False

-MemberId

Określa identyfikator obiektu Microsoft Entra ID, który ma zostać przypisany jako właściciel/menedżer/członek.

Właściwości parametru

Typ:System.String
Domyślna wartość:None
Obsługuje symbole wieloznaczne:False
DontShow:False
Aliasy:Identyfikator refObjectId

Zestawy parametrów

(All)
Position:Named
Obowiązkowe:True
Wartość z potoku:True
Wartość z potoku według nazwy właściwości:True
Wartość z pozostałych argumentów:False

CommonParameters

To polecenie cmdlet obsługuje typowe parametry: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction i -WarningVariable. Aby uzyskać więcej informacji, zobacz about_CommonParameters.