Share via

Get-MsolRoleMember

  • Odwołanie
Moduł:
MSOnline

Pobiera członków roli.

Składnia

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>]

Opis

Polecenie cmdlet Get-MsolRoleMember pobiera członków określonej roli.

Przykłady

Przykład 1. Pobieranie członków roli

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

To polecenie zwraca wszystkie elementy członkowskie określonej roli. Polecenie przechowuje wyniki w zmiennej $RoleMembers.

Parametry

-All

Wskazuje, że to polecenie cmdlet zwraca wszystkie znalezione wyniki. Nie należy określać tego parametru i parametru MaxResults .

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

-MaxResults

Określa maksymalną liczbę wyników zwracanych przez to polecenie cmdlet. Wartość domyślna to 250.

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

-MemberObjectTypes

Określa tablicę typów obiektów członkowskich.

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

-RoleObjectId

Określa unikatowy identyfikator roli, z której mają zostać usunięte elementy członkowskie.

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

-SearchString

Określa ciąg. To polecenie cmdlet zwraca obiekty z nazwą wyświetlaną lub adresem e-mail rozpoczynającym się od tego ciągu. Ciąg do wyszukania.

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

-TenantId

Określa unikatowy identyfikator dzierżawy, w której ma być wykonywana operacja. Wartość domyślna to dzierżawa bieżącego użytkownika. Ten parametr ma zastosowanie tylko do użytkowników partnerów.

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

Dane wyjściowe

Microsoft.Online.Administation.RoleMember

To polecenie cmdlet zwraca obiekty członkowskie roli zawierające następujące informacje:

  • Displayname. Nazwa wyświetlana członka roli.

  • Emailaddress. Adres e-mail członka roli.

  • IsLicensed. Bez względu na to, czy użytkownik ma licencję.

  • LastDirSyncTime. Data i godzina ostatniej synchronizacji tego elementu członkowskiego.

  • Objectid. Unikatowy identyfikator elementu członkowskiego.

  • OverallProvisioningStatus. Stan aprowizacji tego użytkownika.

  • RoleMemberType. Typ członka roli. Obecnie obsługiwany jest tylko użytkownik.

  • Validationstatus. Niezależnie od tego, czy występują błędy dotyczące tego członka grupy.