Sdílet prostřednictvím

Get-MsolRoleMember

  • Reference
Modul:
MSOnline

Získá členy role.

Syntaxe

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. Nezadávejte tento parametr a parametr MaxResults .

Typ:SwitchParameter
Position:Named
Default value:None
Vyžadováno:True
Přijmout vstup kanálu:False
Přijmout zástupné znaky:False

-MaxResults

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

Typ:Int32
Position:Named
Default value:250
Vyžadováno:False
Přijmout vstup kanálu:False
Přijmout zástupné znaky:False

-MemberObjectTypes

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

Typ:String[]
Position:Named
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:False
Přijmout zástupné znaky:False

-RoleObjectId

Určuje jedinečné ID role, ze které se mají členové odebírat.

Typ:Guid
Position:Named
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:False
Přijmout zástupné znaky:False

-SearchString

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

Typ:String
Position:Named
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:False
Přijmout zástupné znaky:False

-TenantId

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

Typ:Guid
Position:Named
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:True
Přijmout zástupné znaky:False

Výstupy

Microsoft.Online.Administation.RoleMember

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

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

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

  • IsLicensed. Určuje, jestli má uživatel licenci.

  • 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ě je podporován pouze uživatel.

  • ValidationStatus. Jestli u tohoto člena skupiny došlo k nějakým chybám.