다음을 통해 공유


Get-MsolRoleMember

역할의 멤버를 가져옵니다.

구문

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

Get-MsolRoleMember cmdlet은 지정된 역할의 멤버를 가져옵니다.

예제

예제 1: 역할의 멤버 가져오기

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

이 명령은 지정된 역할의 모든 멤버를 반환합니다. 명령은 결과를 $RoleMembers 변수에 저장합니다.

매개 변수

-All

이 cmdlet이 찾은 모든 결과를 반환한다는 것을 나타냅니다. 이 매개 변수와 MaxResults 매개 변수를 지정하지 마세요.

형식:SwitchParameter
Position:Named
Default value:None
필수:True
파이프라인 입력 허용:False
와일드카드 문자 허용:False

-MaxResults

이 cmdlet이 반환하는 최대 결과 수를 지정합니다. 기본값은 250입니다.

형식:Int32
Position:Named
Default value:250
필수:False
파이프라인 입력 허용:False
와일드카드 문자 허용:False

-MemberObjectTypes

멤버 개체 형식의 배열을 지정합니다.

형식:String[]
Position:Named
Default value:None
필수:False
파이프라인 입력 허용:False
와일드카드 문자 허용:False

-RoleObjectId

멤버를 제거할 역할의 고유 ID를 지정합니다.

형식:Guid
Position:Named
Default value:None
필수:False
파이프라인 입력 허용:False
와일드카드 문자 허용:False

-SearchString

문자열을 지정합니다. 이 cmdlet은 이 문자열로 시작하는 표시 이름 또는 전자 메일 주소가 있는 개체를 반환합니다. 검색할 문자열입니다.

형식:String
Position:Named
Default value:None
필수:False
파이프라인 입력 허용:False
와일드카드 문자 허용:False

-TenantId

작업을 수행할 테넌트 고유 ID를 지정합니다. 기본값은 현재 사용자의 테넌트입니다. 이 매개 변수는 파트너 사용자에게만 적용됩니다.

형식:Guid
Position:Named
Default value:None
필수:False
파이프라인 입력 허용:True
와일드카드 문자 허용:False

출력

Microsoft.Online.Administation.RoleMember

이 cmdlet은 다음 정보를 포함하는 역할 멤버 개체를 반환합니다.

  • DisplayName. 역할 구성원의 표시 이름입니다.

  • Emailaddress. 역할 구성원의 전자 메일 주소입니다.

  • IsLicensed. 사용자의 라이선스 소유 여부입니다.

  • LastDirSyncTime. 이 구성원을 마지막으로 동기화한 날짜와 시간입니다.

  • Objectid. 구성원의 고유 ID입니다.

  • OverallProvisioningStatus. 이 사용자의 프로비저닝 상태입니다.

  • RoleMemberType. 역할 멤버의 유형입니다. 현재는 "User"만 지원됩니다.

  • ValidationStatus입니다. 이 그룹 구성원에게 오류가 발생했는지 여부입니다.