다음을 통해 공유

MS 그래프 그룹 및 사용자

MS Graph 그룹 및 사용자 커넥터는 Microsoft Entra ID 그룹, 멤버(사용자) 및 라이선스 세부 정보를 검색하는 데 도움이 됩니다.

이 커넥터는 다음 제품 및 지역에서 사용할 수 있습니다.

서비스 클래스 Regions
Copilot Studio Premium 다음을 제외한 모든 Power Automate 지역 :
     - 미국 정부(GCC)
     - 미국 정부(GCC High)
     - 21Vianet에서 운영하는 중국 클라우드
     - 미국 국방부(DoD)
논리 앱 스탠다드 다음을 제외한 모든 Logic Apps 지역 :
     - Azure Government 지역
     - Azure 중국 지역
     - 미국 국방부(DoD)
Power Apps Premium 다음을 제외한 모든 Power Apps 지역 :
     - 미국 정부(GCC)
     - 미국 정부(GCC High)
     - 21Vianet에서 운영하는 중국 클라우드
     - 미국 국방부(DoD)
Power Automate Premium 다음을 제외한 모든 Power Automate 지역 :
     - 미국 정부(GCC)
     - 미국 정부(GCC High)
     - 21Vianet에서 운영하는 중국 클라우드
     - 미국 국방부(DoD)
연락처
이름 Jay Jani, Microsoft
전자 메일 jayjani@microsoft.com
커넥터 메타데이터
게시자 Jay Jani
웹 사이트 https://graph.microsoft.com
개인 정보 보호 정책 https://privacy.microsoft.com/en-us/privacystatement
카테고리 IT 작업; 데이터

연결을 만드는 중

커넥터는 다음 인증 유형을 지원합니다.
기본값 연결을 만들기 위한 매개 변수입니다. 모든 지역 공유할 수 없음

기본값

적용 가능: 모든 지역

연결을 만들기 위한 매개 변수입니다.

공유 가능한 연결이 아닙니다. 전원 앱이 다른 사용자와 공유되면 다른 사용자에게 새 연결을 명시적으로 만들라는 메시지가 표시됩니다.

제한 한도

Name 호출 갱신 기간
연결당 API 호출 100 60초

동작

구독된 SKU 나열

조직의 구독 라이선스 계획 SKU에 대한 세부 정보
그룹 속성 가져오기

Microsoft Entra ID 그룹의 속성 및 관계 검색
멤버 그룹 가져오기

사용자에 대한 그룹 멤버 자격(멤버)
멤버 라이선스 세부 정보 가져오기

그룹 멤버(사용자)의 라이선스 세부 정보 검색
사용자 나열

조직의 모든 사용자 검색(Microsoft Entra ID 테넌트)
직접 그룹 구성원 나열

개수가 있는 그룹의 직접 멤버 검색
표시 이름 검색별 그룹 나열

그룹의 표시 이름을 검색하여 그룹 검색

구독된 SKU 나열

작업 ID:
ListSubscribedSkus

조직의 구독 라이선스 계획 SKU에 대한 세부 정보

반환

Name 경로 형식 Description
Odata 컨텍스트
 @odata.context string

Odata.context 링크입니다.
value
 value array of object

value
기능 상태
 value.capabilityStatus string

SKU의 기능 상태
사용된 단위
 value.consumedUnits integer

이미 사용된 SKU 단위는 몇 대인가요?
아이디
 value.id string

아이디
SKU ID
 value.skuId string

SKU의 전역 고유 식별자
SKU 부품 번호
 value.skuPartNumber string

SKU의 이름
적용 대상
 value.appliesTo string

SKU는 누구에게 적용됩니까?
활성화됨
 value.prepaidUnits.enabled integer

사용 단위
일시 중단됨
 value.prepaidUnits.suspended integer

일시 중단된 단위
경고
 value.prepaidUnits.warning integer

경고 단위
servicePlans
 value.servicePlans array of object

servicePlans
servicePlanId
 value.servicePlans.servicePlanId string

servicePlanId
servicePlanName
 value.servicePlans.servicePlanName string

servicePlanName
프로비저닝 상태
 value.servicePlans.provisioningStatus string

프로비저닝 상태
적용 대상:
 value.servicePlans.appliesTo string

적용 대상:

그룹 속성 가져오기

작업 ID:
GetGroupProperties

Microsoft Entra ID 그룹의 속성 및 관계 검색

매개 변수

Name 키 필수 형식 Description
Microsoft Entra ID 그룹의 개체 ID
 group-id True string

Microsoft Entra ID 그룹의 개체 ID

반환

Name 경로 형식 Description
Odata 컨텍스트
 @odata.context string

Odata.context 링크입니다.
아이디
 id string

그룹의 개체 ID
삭제된 날짜 시간
 deletedDateTime string

그룹의 삭제 날짜 시간
Classification
 classification string

분류
만든 날짜 시간
 createdDateTime string

그룹의 생성 날짜 시간
creationOptions
 creationOptions array of string

그룹의 옵션을 만들었습니다.
Description
 description string

description
표시 이름
 displayName string

그룹의 표시 이름
만료 날짜 시간
 expirationDateTime string

그룹의 만료 날짜 시간
groupTypes
 groupTypes array of string

그룹의 그룹 형식입니다.
역할에 할당할 수 있습니다.
 isAssignableToRole string

이 그룹에 역할을 할당할 수 있나요?
우편
 mail string

그룹의 전자 메일
메일 사용
 mailEnabled boolean

그룹 전자 메일을 사용할 수 있나요?
메일 닉 이름
 mailNickname string

그룹의 전자 메일 닉 이름
멤버 자격 규칙
 membershipRule string

멤버 자격 평가에 사용되는 규칙입니다.
멤버 자격 규칙 처리 상태
 membershipRuleProcessingState string

멤버 자격 평가에 사용되는 규칙의 처리 상태입니다.
OnPremises 도메인 이름
 onPremisesDomainName string

온-프레미스 디렉터리에서 동기화된 dnsDomainName이라고도 하는 온-프레미스 domainFQDN을 포함합니다.
OnPremises 마지막 동기화 날짜 시간
 onPremisesLastSyncDateTime string

테넌트가 온-프레미스 디렉터리와 마지막으로 동기화된 시간 및 날짜입니다.
OnPremises NetBios 이름
 onPremisesNetBiosName string

온-프레미스 서버에 대한 네트워킹 서비스의 이름입니다.
OnPremises Sam 계정 이름
 onPremisesSamAccountName string

온-프레미스 디렉터리의 Sam 계정 이름입니다.
OnPremises 보안 식별자
 onPremisesSecurityIdentifier string

온-프레미스 보안 식별자입니다.
OnPremises 동기화 사용
 onPremisesSyncEnabled boolean

True이면 그룹에 대해 온-프레미스 동기화를 사용할 수 있습니다.
기본 설정 데이터 위치
 preferredDataLocation string

그룹의 기본 설정 데이터 위치입니다.
기본 설정 언어
 preferredLanguage string

Microsoft Entra ID에 구성된 기본 설정 언어입니다.
프록시 주소들
 proxyAddresses array of string

그룹의 프록시 주소입니다.
갱신된 날짜 시간
 renewedDateTime string

그룹의 갱신된 날짜 시간입니다.
resourceBehaviorOptions
 resourceBehaviorOptions array of string

그룹의 리소스 동작 옵션입니다.
resourceProvisioningOptions
 resourceProvisioningOptions array of string

그룹의 리소스 프로비저닝 옵션입니다.
보안 사용
 securityEnabled boolean

그룹이 보안을 사용하도록 설정되어 있는지를 나타냅니다.
보안 식별자
 securityIdentifier string

그룹의 보안 식별자입니다.
Theme
 theme string

Microsoft Entra ID 그룹의 테마입니다.
가시성
 visibility string

그룹의 표시 유형입니다.
onPremisesProvisioningErrors
 onPremisesProvisioningErrors array of string

그룹의 온-프레미스 프로비저닝 오류입니다.

멤버 그룹 가져오기

작업 ID:
GetMemberGroups

사용자에 대한 그룹 멤버 자격(멤버)

매개 변수

Name 키 필수 형식 Description
Microsoft Entra ID 멤버(사용자)의 개체 ID
 member-id True string

Microsoft Entra ID 멤버(사용자)의 개체 ID
보안 사용 전용(true/false)
 securityEnabledOnly True boolean

보안이 설정된 그룹만 검색하시겠습니까?

반환

Name 경로 형식 Description
Odata 컨텍스트
 @odata.context string

Odata.context 링크입니다.
value
 value array of string

value

멤버 라이선스 세부 정보 가져오기

작업 ID:
GetMemberLicenseDetails

그룹 멤버(사용자)의 라이선스 세부 정보 검색

매개 변수

Name 키 필수 형식 Description
Microsoft Entra ID 멤버(사용자)의 개체 ID
 id True string

Microsoft Entra ID 멤버(사용자)의 개체 ID
데이터 요소 선택(열)
 $select string

데이터 요소 선택(열)

반환

Name 경로 형식 Description
Odata 컨텍스트
 @odata.context string

Odata.context 링크입니다.
value
 value array of object

value
아이디
 value.id string

아이디
SKU ID
 value.skuId string

SKU의 ID입니다.
SKU 부품 번호
 value.skuPartNumber string

SKU의 이름
servicePlans
 value.servicePlans array of object

servicePlans
servicePlanId
 value.servicePlans.servicePlanId string

servicePlanId
servicePlanName
 value.servicePlans.servicePlanName string

servicePlanName
프로비저닝 상태
 value.servicePlans.provisioningStatus string

프로비저닝 상태
적용 대상:
 value.servicePlans.appliesTo string

적용 대상:

사용자 나열

작업 ID:
ListUsers

조직의 모든 사용자 검색(Microsoft Entra ID 테넌트)

반환

Name 경로 형식 Description
@odata.context
 @odata.context string

Odata.context 링크입니다.
value
 value array of object

value
businessPhones
 value.businessPhones array of string

businessPhones
표시 이름
 value.displayName string

사용자의 전체 이름
이름 (주어진 이름)
 value.givenName string

사용자의 이름
직위
 value.jobTitle string

사용자의 직호
우편
 value.mail string

사용자의 전자 메일
휴대폰(Mobile Phone)
 value.mobilePhone string

사용자의 휴대폰
Office 위치
 value.officeLocation string

사용자의 사무실 위치
기본 설정 언어
 value.preferredLanguage string

사용자의 기본 설정 언어
Surname
 value.surname string

사용자의 성
사용자 주 이름
 value.userPrincipalName string

사용자의 주체 이름
아이디
 value.id string

사용자의 개체 ID

직접 그룹 구성원 나열

작업 ID:
ListDirectGroupMembers

개수가 있는 그룹의 직접 멤버 검색

매개 변수

Name 키 필수 형식 Description
Microsoft Entra ID 그룹의 개체 ID
 group-id True string

Microsoft Entra ID 그룹의 개체 ID
필터링 기준
 $filter string

필터링 기준
데이터 요소(열) 선택
 $select string

검색할 열 선택

반환

Name 경로 형식 Description
Odata 컨텍스트
 @odata.context string

Odata.context 링크입니다.
Odata Count
 @odata.count integer

@odata.count
value
 value array of object

value
Odata 형식
 value.@odata.type string

@odata.type
표시 이름
 value.displayName string

멤버의 전체 이름
사용자 주 이름
 value.userPrincipalName string

멤버의 사용자 계정 이름
아이디
 value.id string

멤버의 개체 ID
직위
 value.jobTitle string

직책
메일 닉 이름
 value.mailNickname string

구성원의 전자 메일 닉 이름
우편
 value.mail string

구성원의 전자 메일
이름 (주어진 이름)
 value.givenName string

멤버의 이름
Surname
 value.surname string

멤버의 성
businessPhones
 value.businessPhones array of string

businessPhones
휴대폰(Mobile Phone)
 value.mobilePhone string

휴대전화
Office 위치
 value.officeLocation string

officeLocation
기본 설정 언어
 value.preferredLanguage string

Microsoft Entra ID에 구성된 기본 설정 언어입니다.

표시 이름 검색별 그룹 나열

작업 ID:
ListGroupsByDisplayNameSearch

그룹의 표시 이름을 검색하여 그룹 검색

매개 변수

Name 키 필수 형식 Description
표시 이름별 검색
 $search string

Microsoft Entra ID 그룹의 표시 이름에서 키워드로 검색

반환

Name 경로 형식 Description
Odata 컨텍스트
 @odata.context string

Odata.context 링크입니다.
그룹 수
 @odata.count integer

@odata.count
value
 value array of object

value
아이디
 value.id string

그룹의 개체 ID
삭제된 날짜 시간
 value.deletedDateTime string

그룹 삭제 날짜 및 시간
Classification
 value.classification string

그룹의 분류
만든 날짜 시간
 value.createdDateTime string

그룹 생성 날짜 및 시간
creationOptions
 value.creationOptions array of

그룹의 옵션을 만들었습니다.
Description
 value.description string

그룹에 대한 설명
표시 이름
 value.displayName string

그룹의 표시 이름
만료 날짜 시간
 value.expirationDateTime string

그룹의 만료 날짜 시간
groupTypes
 value.groupTypes array of string

그룹의 그룹 형식입니다.
역할에 할당할 수 있습니다.
 value.isAssignableToRole string

이 그룹에 역할을 할당할 수 있나요?
우편
 value.mail string

그룹의 전자 메일
메일 사용
 value.mailEnabled boolean

그룹 전자 메일을 사용할 수 있나요?
메일 닉 이름
 value.mailNickname string

그룹의 전자 메일 닉 이름
멤버 자격 규칙
 value.membershipRule string

멤버 자격 평가에 사용되는 규칙입니다.
멤버 자격 규칙 처리 상태
 value.membershipRuleProcessingState string

멤버 자격 평가에 사용되는 규칙의 처리 상태입니다.
OnPremises 도메인 이름
 value.onPremisesDomainName string

온-프레미스 디렉터리에서 동기화된 dnsDomainName이라고도 하는 온-프레미스 domainFQDN을 포함합니다.
OnPremises 마지막 동기화 날짜 시간
 value.onPremisesLastSyncDateTime string

테넌트가 온-프레미스 디렉터리와 마지막으로 동기화된 시간 및 날짜입니다.
OnPremises NetBios 이름
 value.onPremisesNetBiosName string

온-프레미스 서버에 대한 네트워킹 서비스의 이름입니다.
OnPremises Sam 계정 이름
 value.onPremisesSamAccountName string

온-프레미스 디렉터리의 Sam 계정 이름입니다.
OnPremises 보안 식별자
 value.onPremisesSecurityIdentifier string

온-프레미스 보안 식별자입니다.
OnPremises 동기화 사용
 value.onPremisesSyncEnabled boolean

True이면 그룹에 대해 온-프레미스 동기화를 사용할 수 있습니다.
기본 설정 데이터 위치
 value.preferredDataLocation string

그룹의 기본 설정 데이터 위치입니다.
기본 설정 언어
 value.preferredLanguage string

Microsoft Entra ID에 구성된 기본 설정 언어입니다.
프록시 주소들
 value.proxyAddresses array of string

그룹의 프록시 주소입니다.
갱신된 날짜 시간
 value.renewedDateTime string

그룹의 갱신된 날짜 시간입니다.
resourceBehaviorOptions
 value.resourceBehaviorOptions array of

그룹의 리소스 동작 옵션입니다.
resourceProvisioningOptions
 value.resourceProvisioningOptions array of string

그룹의 리소스 프로비저닝 옵션입니다.
보안 사용
 value.securityEnabled boolean

그룹이 보안을 사용하도록 설정되어 있는지를 나타냅니다.
보안 식별자
 value.securityIdentifier string

그룹의 보안 식별자입니다.
Theme
 value.theme string

Microsoft Entra ID 그룹의 테마입니다.
가시성
 value.visibility string

그룹의 표시 유형입니다.
onPremisesProvisioningErrors
 value.onPremisesProvisioningErrors array of

그룹의 온-프레미스 프로비저닝 오류입니다.