Udostępnij za pośrednictwem


Get-MsolRoleMember

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 .

Typ:SwitchParameter
Position:Named
Domyślna wartość:None
Wymagane:True
Akceptowanie danych wejściowych potoku:False
Akceptowanie symboli wieloznacznych:False

-MaxResults

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

Typ:Int32
Position:Named
Domyślna wartość:250
Wymagane:False
Akceptowanie danych wejściowych potoku:False
Akceptowanie symboli wieloznacznych:False

-MemberObjectTypes

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

Typ:String[]
Position:Named
Domyślna wartość:None
Wymagane:False
Akceptowanie danych wejściowych potoku:False
Akceptowanie symboli wieloznacznych:False

-RoleObjectId

Określa unikatowy identyfikator roli, z której mają być usuwane elementy członkowskie.

Typ:Guid
Position:Named
Domyślna wartość:None
Wymagane:False
Akceptowanie danych wejściowych potoku:False
Akceptowanie symboli wieloznacznych:False

-SearchString

Określa ciąg. To polecenie cmdlet zwraca obiekty o nazwie wyświetlanej lub adresie e-mail rozpoczynającym się od tego ciągu. Ciąg do wyszukania.

Typ:String
Position:Named
Domyślna wartość:None
Wymagane:False
Akceptowanie danych wejściowych potoku:False
Akceptowanie symboli wieloznacznych:False

-TenantId

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

Typ:Guid
Position:Named
Domyślna wartość:None
Wymagane:False
Akceptowanie danych wejściowych potoku:True
Akceptowanie symboli wieloznacznych:False

Dane wyjściowe

Microsoft.Online.Administation.RoleMember

To polecenie cmdlet zwraca obiekty składowe roli, które zawierają następujące informacje:

  • Displayname. Nazwa wyświetlana elementu członkowskiego roli.

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

  • IsLicensed. Niezależnie od tego, czy użytkownik ma licencję.

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

  • Objectid. Unikatowy identyfikator elementu członkowskiego.

  • GeneralProvisioningStatus. Stan aprowizacji tego użytkownika.

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

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