Get-MsolRoleMember

  • Referentie
Module:
MSOnline

Hiermee haalt u leden van een rol op.

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

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 met deze cmdlet alle resultaten worden geretourneerd die worden gevonden. Geef deze parameter en de parameter MaxResults niet op.

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

-MaxResults

Hiermee geeft u het maximum aantal resultaten op dat door deze cmdlet wordt geretourneerd. De standaardwaarde is 250.

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

-MemberObjectTypes

Hiermee geeft u een matrix van lidobjecttypen.

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

-RoleObjectId

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

Type:Guid
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters: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
Required:False
Accept pipeline input:False
Accept wildcard characters: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
Required:False
Accept pipeline input:True
Accept wildcard characters: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 al dan niet fouten zijn met dit groepslid.