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.