Dela via

Get-MsolRoleMember

  • Referens
Modul:
MSOnline

Hämtar medlemmar i en roll.

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

Cmdleten Get-MsolRoleMember hämtar medlemmar i den angivna rollen.

Exempel

Exempel 1: Hämta medlemmar i en roll

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

Det här kommandot returnerar alla medlemmar i den angivna rollen. Kommandot lagrar resultatet i variabeln $RoleMembers.

Parametrar

-All

Anger att den här cmdleten returnerar alla resultat som hittas. Ange inte den här parametern och parametern MaxResults .

Typ:SwitchParameter
Position:Named
Standardvärde:None
Obligatorisk:True
Godkänn pipeline-indata:False
Godkänn jokertecken:False

-MaxResults

Anger det maximala antalet resultat som den här cmdleten returnerar. Standardvärdet är 250.

Typ:Int32
Position:Named
Standardvärde:250
Obligatorisk:False
Godkänn pipeline-indata:False
Godkänn jokertecken:False

-MemberObjectTypes

Anger en matris med medlemsobjekttyper.

Typ:String[]
Position:Named
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:False
Godkänn jokertecken:False

-RoleObjectId

Anger det unika ID:t för rollen som medlemmar ska tas bort från.

Typ:Guid
Position:Named
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:False
Godkänn jokertecken:False

-SearchString

Anger en sträng. Den här cmdleten returnerar objekt med ett visningsnamn eller en e-postadress som börjar med den här strängen. Strängen som du vill söka efter.

Typ:String
Position:Named
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:False
Godkänn jokertecken:False

-TenantId

Anger det unika ID för klientorganisationen som åtgärden ska utföras på. Standardvärdet är den aktuella användarens klientorganisation. Den här parametern gäller endast för partneranvändare.

Typ:Guid
Position:Named
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:True
Godkänn jokertecken:False

Utdata

Microsoft.Online.Administation.RoleMember

Den här cmdleten returnerar rollmedlemsobjekt som innehåller följande information:

  • Displayname. Visningsnamnet för rollmedlemmen.

  • Emailaddress. E-postadressen till rollmedlemmen.

  • IsLicensed. Om användaren är licensierad eller inte.

  • LastDirSyncTime. Datum och tid då den här medlemmen senast synkroniserades.

  • Objectid. Medlemmens unika ID.

  • OverallProvisioningStatus. Etableringsstatus för den här användaren.

  • RoleMemberType. Typ av rollmedlem. För närvarande stöds endast "Användare".

  • ValidationStatus. Om det finns några fel med den här gruppmedlemmen eller inte.