Get-MsolRoleMember

  • Referencia
Módulo:
MSOnline

Obtiene miembros de un rol.

Sintaxis

Get-MsolRoleMember
   [-RoleObjectId <Guid>]
   [-MemberObjectTypes <String[]>]
   [-SearchString <String>]
   [-MaxResults <Int32>]
   [-TenantId <Guid>]
   [<CommonParameters>]
Get-MsolRoleMember
   [-RoleObjectId <Guid>]
   [-MemberObjectTypes <String[]>]
   [-SearchString <String>]
   [-All]
   [-TenantId <Guid>]
   [<CommonParameters>]

Description

El cmdlet Get-MsolRoleMember obtiene miembros del rol especificado.

Ejemplos

Ejemplo 1: Obtener miembros de un rol

PS C:\> $Role = Get-MsolRole -RoleName "%Role Name%"
PS C:\> $RoleMembers = Get-MsolRoleMember -RoleObjectId $Role.ObjectId

Este comando devuelve todos los miembros del rol especificado. El comando almacena los resultados en la variable $RoleMembers.

Parámetros

-All

Indica que este cmdlet devuelve todos los resultados que encuentra. No especifique este parámetro y el parámetro MaxResults .

Tipo:SwitchParameter
Posición:Named
Valor predeterminado:None
Requerido:True
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-MaxResults

Especifica el número máximo de resultados que devuelve este cmdlet. El valor predeterminado es 250.

Tipo:Int32
Posición:Named
Valor predeterminado:250
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-MemberObjectTypes

Especifica una matriz de tipos de objeto miembro.

Tipo:String[]
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-RoleObjectId

Especifica el identificador único del rol del que se van a quitar los miembros.

Tipo:Guid
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-SearchString

Especifica una cadena. Este cmdlet devuelve objetos con un nombre para mostrar o una dirección de correo electrónico que comienzan con esta cadena. Cadena en la que se va a buscar.

Tipo:String
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-TenantId

Especifica el identificador único del inquilino en el que se va a realizar la operación. El valor predeterminado es el inquilino del usuario actual. Este parámetro solo se aplica a los usuarios asociados.

Tipo:Guid
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:True
Aceptar caracteres comodín:False

Salidas

Microsoft.Online.Administation.RoleMember

Este cmdlet devuelve objetos de miembro de rol que contienen la siguiente información:

  • DisplayName. El nombre para mostrar del miembro del rol.

  • EmailAddress. Dirección de correo electrónico del miembro del rol.

  • IsLicensed. Indica si el usuario tiene licencia o no.

  • LastDirSyncTime. La fecha y la hora en la que se sincronizó el miembro por última vez.

  • Idobjeto. El identificador único del miembro.

  • OverallProvisioningStatus. El estado de aprovisionamiento de este usuario.

  • RoleMemberType. Tipo de miembro de rol. Actualmente solo se admite "User".

  • ValidationStatus. Indica si este miembro del grupo tiene errores o no.