Get-MsolRoleMember

Získá členy role.

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

Rutina Get-MsolRoleMember získá členy zadané role.

Příklady

Příklad 1: Získání členů role

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

Tento příkaz vrátí všechny členy zadané role. Příkaz uloží výsledky do proměnné $RoleMembers.

Parametry

-All

Označuje, že tato rutina vrátí všechny výsledky, které najde. Tento parametr a parametr MaxResults nezadávejte.

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

-MaxResults

Určuje maximální počet výsledků, které tato rutina vrátí. Výchozí hodnota je 250.

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

-MemberObjectTypes

Určuje pole typů objektů členů.

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

-RoleObjectId

Určuje jedinečné ID role, ze které chcete odebrat členy.

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

-SearchString

Určuje řetězec. Tato rutina vrací objekty se zobrazovaným názvem nebo e-mailovou adresou, které začínají tímto řetězcem. Řetězec, na který chcete hledat.

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

-TenantId

Určuje jedinečné ID tenanta, na kterém se má provést operace. Výchozí hodnota je tenant aktuálního uživatele. Tento parametr se vztahuje pouze na uživatele partnera.

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

Výstupy

Microsoft.Online.Administation.RoleMember

Tato rutina vrací členské objekty role, které obsahují následující informace:

  • Displayname. Zobrazovaný název člena role.

  • Emailaddress. E-mailová adresa člena role.

  • IsLicensed. Bez ohledu na to, jestli je uživatel licencovaný.

  • LastDirSyncTime. Datum a čas poslední synchronizace tohoto člena.

  • Objectid. Jedinečné ID člena.

  • OverallProvisioningStatus. Stav zřizování tohoto uživatele.

  • RoleMemberType. Typ člena role. V současné době se podporuje pouze uživatel.

  • ValidationStatus. Bez ohledu na to, jestli u tohoto člena skupiny dojde k nějakým chybám.