Add-EntraDirectoryRoleMember

Lägger till en medlem i en katalogroll.

Syntax

Default (Standard)

Add-EntraDirectoryRoleMember

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

Description

Cmdleten Add-EntraDirectoryRoleMember lägger till en medlem i en Microsoft Entra ID roll.

I delegerade scenarier måste den inloggade användaren ha antingen en Microsoft Entra roll som stöds eller en anpassad roll med nödvändiga behörigheter. De minsta roller som krävs för den här åtgärden är:

  • Privilegierad rolladministratör

Exempel

Exempel 1: Lägga till en medlem i en Microsoft Entra ID roll

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

Det här exemplet lägger till en medlem i en katalogroll.

  • DirectoryRoleId parameter anger ID för katalogrollen som medlemmen läggs till i. Använd kommandot Get-EntraDirectoryRole för att hämta information om katalogrollen.
  • MemberIdparameter anger ID för Microsoft Entra ID objekt som ska tilldelas som ägare/chef/medlem.

Parametrar

-DirectoryRoleId

Anger ID för en katalogroll i Microsoft Entra ID.

Parameteregenskaper

Typ:System.String
Standardvärde:None
Stöder jokertecken:False
DontShow:False
Alias:Objekt-ID

Parameteruppsättningar

(All)
Position:Named
Obligatorisk:True
Värde från pipeline:True
Värde från pipeline efter egenskapsnamn:True
Värde från återstående argument:False

-MemberId

Anger ID:t för det Microsoft Entra ID objekt som ska tilldelas som ägare/chef/medlem.

Parameteregenskaper

Typ:System.String
Standardvärde:None
Stöder jokertecken:False
DontShow:False
Alias:RefObjectId

Parameteruppsättningar

(All)
Position:Named
Obligatorisk:True
Värde från pipeline:True
Värde från pipeline efter egenskapsnamn:True
Värde från återstående argument:False

CommonParameters

Den här cmdleten stöder vanliga parametrar: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction och -WarningVariable. Mer information finns i about_CommonParameters.