Get-MsolRoleMember

  • Referencia
Módulo:
MSOnline

Obtiene los miembros de un rol.

Syntax

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 .

Type:SwitchParameter
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-MaxResults

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

Type:Int32
Position:Named
Default value:250
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-MemberObjectTypes

Especifica una matriz de tipos de objeto miembro.

Type:String[]
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-RoleObjectId

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

Type:Guid
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-SearchString

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

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters: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.

Type:Guid
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

Salidas

Microsoft.Online.Administation.RoleMember

Este cmdlet devuelve objetos 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.

  • GeneralProvisioningStatus. 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.