Delen via

Get-MsolRoleMember

  • Referentie
Module:
MSOnline

Hiermee haalt u leden van een rol op.

Syntaxis

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

De cmdlet Get-MsolRoleMember haalt leden van de opgegeven rol op.

Voorbeelden

Voorbeeld 1: Leden van een rol ophalen

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

Met deze opdracht worden alle leden van de opgegeven rol geretourneerd. Met de opdracht worden de resultaten opgeslagen in de variabele $RoleMembers.

Parameters

-All

Geeft aan dat deze cmdlet alle resultaten retourneert die worden gevonden. Geef deze parameter en de parameter MaxResults niet op .

Type:SwitchParameter
Position:Named
Default value:None
Vereist:True
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-MaxResults

Hiermee geeft u het maximum aantal resultaten dat deze cmdlet retourneert. De standaardwaarde is 250.

Type:Int32
Position:Named
Default value:250
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-MemberObjectTypes

Hiermee geeft u een matrix van lidobjecttypen op.

Type:String[]
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-RoleObjectId

Hiermee geeft u de unieke id op van de rol waaruit leden moeten worden verwijderd.

Type:Guid
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-SearchString

Hiermee geeft u een tekenreeks op. Deze cmdlet retourneert objecten met een weergavenaam of e-mailadres die beginnen met deze tekenreeks. De tekenreeks waarop moet worden gezocht.

Type:String
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-TenantId

Hiermee geeft u de unieke id van de tenant op waarop de bewerking moet worden uitgevoerd. De standaardwaarde is de tenant van de huidige gebruiker. Deze parameter is alleen van toepassing op partnergebruikers.

Type:Guid
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:True
Jokertekens accepteren:False

Uitvoerwaarden

Microsoft.Online.Administation.RoleMember

Deze cmdlet retourneert rollidobjecten die de volgende informatie bevatten:

  • Displayname. De weergavenaam van het rollid.

  • Emailaddress. Het e-mailadres van het rollid.

  • IsLicensed. Of de gebruiker al dan niet een licentie heeft.

  • LastDirSyncTime. De datum en tijd waarop dit lid voor het laatst is gesynchroniseerd.

  • ObjectId. De unieke id van het lid.

  • OverallProvisioningStatus. De inrichtingsstatus van deze gebruiker.

  • RoleMemberType. Het type rollid. Momenteel wordt alleen 'Gebruiker' ondersteund.

  • ValidationStatus. Of er fouten zijn met dit groepslid of niet.