Add-EntraDirectoryRoleMember

Módulo:
Microsoft.Entra.DirectoryManagement Module v1.3

Agrega un miembro a un rol de directorio.

Sintaxis

Default (valor predeterminado) 

Add-EntraDirectoryRoleMember

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

Description

El Add-EntraDirectoryRoleMember cmdlet agrega un miembro a un rol de Microsoft Entra ID.

En escenarios delegados, el usuario que ha iniciado sesión debe tener un rol de Microsoft Entra compatible o un rol personalizado con los permisos necesarios. Los roles mínimos necesarios para esta operación son:

  • Administrador de roles con privilegios

Ejemplos

Ejemplo 1: Agregar un miembro a un rol de 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

En este ejemplo se agrega un miembro a un rol de directorio.

  • DirectoryRoleId el parámetro especifica el identificador del rol de directorio al que se agrega el miembro. Use el comando Get-EntraDirectoryRole para recuperar los detalles del rol de directorio.
  • MemberIdel parámetro especifica el identificador de Microsoft Entra ID objeto que se va a asignar como propietario, administrador o miembro.

Parámetros

-DirectoryRoleId

Especifica el identificador de un rol de directorio en Microsoft Entra ID.

Propiedades de parámetro

Tipo:System.String
Valor predeterminado:None
Admite caracteres comodín:False
DontShow:False
Alias:ObjectId (identificador de objeto)

Conjuntos de parámetros

(All)
Posición:Named
Obligatorio:True
Valor de la canalización:True
Valor de la canalización por nombre de propiedad:True
Valor de los argumentos restantes:False

-MemberId

Especifica el identificador del objeto Microsoft Entra ID que se va a asignar como propietario, administrador o miembro.

Propiedades de parámetro

Tipo:System.String
Valor predeterminado:None
Admite caracteres comodín:False
DontShow:False
Alias:RefObjectId

Conjuntos de parámetros

(All)
Posición:Named
Obligatorio:True
Valor de la canalización:True
Valor de la canalización por nombre de propiedad:True
Valor de los argumentos restantes:False

CommonParameters

Este cmdlet admite los parámetros comunes: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction y -WarningVariable. Para obtener más información, vea about_CommonParameters.