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 i 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 .

Tipo:SwitchParameter
Posizione:Named
Valore predefinito:None
Necessario:True
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-MaxResults

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

Tipo:Int32
Posizione:Named
Valore predefinito:250
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-MemberObjectTypes

Specifica una matrice di tipi di oggetto membro.

Tipo:String[]
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-RoleObjectId

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

Tipo:Guid
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly: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 su cui eseguire la ricerca.

Tipo:String
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly: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.

Tipo:Guid
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:True
Accettare caratteri jolly:False

Output

Microsoft.Online.Administation.RoleMember

Questo cmdlet restituisce oggetti membro 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.

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