Share via

Get-MsolRoleMember

  • Riferimento
Modulo:
MSOnline

Ottiene i membri di un ruolo.

Sintassi

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>]

Descrizione

Il cmdlet Get-MsolRoleMember ottiene membri del ruolo specificato.

Esempio

Esempio 1: Ottenere membri di un ruolo

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

Questo comando restituisce tutti i membri del ruolo specificato. Il comando archivia i risultati nella variabile $RoleMembers.

Parametri

-All

Indica che questo cmdlet restituisce tutti i risultati trovati. Non specificare questo parametro e il parametro MaxResults .

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

-MaxResults

Specifica il numero massimo di risultati restituiti dal cmdlet. Il valore predefinito è 250.

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

-MemberObjectTypes

Specifica una matrice di tipi di oggetti membro.

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

-RoleObjectId

Specifica l'ID univoco del ruolo da cui rimuovere i membri.

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

-SearchString

Specifica una stringa. Questo cmdlet restituisce oggetti con un nome visualizzato o un indirizzo di posta elettronica che iniziano con questa stringa. Stringa da cercare.

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

-TenantId

Specifica l'ID univoco del tenant in cui eseguire l'operazione. Il valore predefinito è il tenant dell'utente corrente. Questo parametro si applica solo agli utenti partner.

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

Output

Microsoft.Online.Administation.RoleMember

Questo cmdlet restituisce gli oggetti membro del ruolo che contengono le informazioni seguenti:

  • Displayname. nome visualizzato del membro del ruolo.

  • Emailaddress. indirizzo e-mail del membro del ruolo.

  • IsLicensed. indicazione se l'utente dispone di una licenza.

  • LastDirSyncTime. data e ora dell'ultima sincronizzazione dell'utente.

  • Objectid. ID univoco del membro.

  • GeneraleProvisioningStatus. stato di provisioning dell'utente.

  • RoleMemberType. Tipo di membro del ruolo. Attualmente è supportato solo "User".

  • ValidationStatus. indicazione dell'eventuale esistenza di errori con questo membro del gruppo.