MS Graph 群組和使用者

MS Graph 群組和使用者連接器可協助擷取 Microsoft Entra ID 群組、成員（使用者）和授權詳細資料

此連接器適用於以下產品和區域：

服務	Class	Regions
副駕駛工作室	進階	除下列區域外的所有 Power Automate 區域： - 美國政府（GCC） - 美國政府（海灣合作委員會高中） - 由 21Vianet 營運的中國雲 - 美國國防部（DoD）
邏輯應用程式	標準	所有 Logic Apps 區域，但下列區域除外： - Azure Government 區域 - Azure 中國區域 - 美國國防部（DoD）
Power Apps	進階	除下列區域外的所有 Power Apps 區域： - 美國政府（GCC） - 美國政府（海灣合作委員會高中） - 由 21Vianet 營運的中國雲 - 美國國防部（DoD）
Power Automate（自動化服務）	進階	除下列區域外的所有 Power Automate 區域： - 美國政府（GCC） - 美國政府（海灣合作委員會高中） - 由 21Vianet 營運的中國雲 - 美國國防部（DoD）

連絡人
名稱	傑伊·賈尼，Microsoft
Email	jayjani@microsoft.com

連接器中繼資料
Publisher	傑伊·賈尼
網站	`https://graph.microsoft.com`
隱私策略	https://privacy.microsoft.com/en-us/privacystatement
類別	IT運營;資料

正在建立連線

連接器支援下列驗證類型：


預設值	建立連線的參數。	所有區域	不可共享

預設

適用：所有地區

建立連線的參數。

這不是可共用的連線。如果 Power App 與其他使用者共用，系統會明確提示其他使用者建立新連線。

節流限制

名稱	呼叫	續約期間
每個連線的 API 呼叫	100	60 秒

動作

依顯示名稱搜尋列出群組	透過搜尋群組的顯示名稱來擷取群組
列出使用者	擷取組織中的所有使用者（Microsoft Entra ID 租用戶）
列出已訂閱的 SKU	組織訂閱授權方案 SKU 的詳細資料
列出直接群組成員	擷取具有計數的群組的直接成員
取得成員群組	使用者（成員）的群組成員資格
取得會員授權詳細資料	擷取群組成員（使用者）的授權詳細資料
取得群組屬性	擷取 Microsoft Entra ID 群組的屬性和關聯性

依顯示名稱搜尋列出群組

作業識別碼：: ListGroupsByDisplayNameSearch

透過搜尋群組的顯示名稱來擷取群組

參數

名稱	機碼	必要	類型	Description
依顯示名稱搜尋	$search		string	依 Microsoft Entra ID 群組顯示名稱中的關鍵字搜尋

傳回

名稱	路徑	類型	Description
Odata 內容	@odata.context	string	Odata.context 連結。
組數	@odata.count	integer	@odata.count
value	value	array of object	value
ID	value.id	string	群組的物件識別碼
刪除日期時間	value.deletedDateTime	string	群組刪除的日期和時間
Classification	value.classification	string	組別分類
建立日期時間	value.createdDateTime	string	建立群組的日期和時間
創建選項	value.creationOptions	array of	創建了組的選項。
Description	value.description	string	群組說明
顯示名稱	value.displayName	string	群組的顯示名稱
到期日期時間	value.expirationDateTime	string	群組的到期日期時間
群組類型	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	包含內部部署網域 FQDN，也稱為從內部部署目錄同步處理的 dnsDomainName。
OnPremises 上次同步處理日期時間	value.onPremisesLastSyncDateTime	string	租用戶上次與內部部署目錄同步的時間和日期。
OnPremises NetBios 名稱	value.onPremisesNetBiosName	string	內部部署伺服器的網路服務名稱。
OnPremises Sam 帳戶名稱	value.onPremisesSamAccountName	string	內部部署目錄的 Sam 帳戶名稱。
OnPremises 安全性識別碼	value.onPremisesSecurityIdentifier	string	內部部署安全性識別碼。
已啟用內部部署同步	value.onPremisesSyncEnabled	boolean	如果已為群組啟用內部部署同步處理，則為 True。
偏好的資料位置	value.preferredDataLocation	string	群組的偏好資料位置。
首選語言	value.preferredLanguage	string	Microsoft Entra ID 中設定的慣用語言。
代理地址	value.proxyAddresses	array of string	群組的 Proxy 位址。
更新日期時間	value.renewedDateTime	string	群組的更新日期時間。
resourceBehaviorOptions	value.resourceBehaviorOptions	array of	群組的資源行為選項。
resourceProvisioning選項	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	組的內部部署配置錯誤。

列出使用者

作業識別碼：: ListUsers

擷取組織中的所有使用者（Microsoft Entra ID 租用戶）

傳回

名稱	路徑	類型	Description
@odata.上下文	@odata.context	string	Odata.context 連結。
value	value	array of object	value
商務電話	value.businessPhones	array of string	商務電話
顯示名稱	value.displayName	string	使用者的全名
名字	value.givenName	string	使用者的名字
職稱	value.jobTitle	string	使用者的職稱
郵件	value.mail	string	使用者的電子郵件
行動電話	value.mobilePhone	string	使用者的手機
辦公地點	value.officeLocation	string	使用者的辦公地點
首選語言	value.preferredLanguage	string	使用者的偏好語言
Surname	value.surname	string	使用者的姓氏
使用者主體名稱	value.userPrincipalName	string	用戶的主體名稱
ID	value.id	string	使用者的物件識別碼

列出已訂閱的 SKU

作業識別碼：: ListSubscribedSkus

組織訂閱授權方案 SKU 的詳細資料

傳回

名稱	路徑	類型	Description
Odata 內容	@odata.context	string	Odata.context 連結。
value	value	array of object	value
功能狀態	value.capabilityStatus	string	SKU 的功能狀態
消耗單位	value.consumedUnits	integer	已經消耗了多少個 SKU 單位？
ID	value.id	string	識別碼
SKU 識別碼	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	警告單位
服務計劃	value.servicePlans	array of object	服務計劃
servicePlanId	value.servicePlans.servicePlanId	string	servicePlanId
servicePlanName	value.servicePlans.servicePlanName	string	servicePlanName
provisioning狀態	value.servicePlans.provisioningStatus	string	provisioning狀態
應用到	value.servicePlans.appliesTo	string	應用到

列出直接群組成員

作業識別碼：: ListDirectGroupMembers

擷取具有計數的群組的直接成員

參數

名稱	機碼	必要	類型	Description
Microsoft Entra ID 群組的物件識別碼	group-id	True	string	Microsoft Entra ID 群組的物件識別碼
篩選依據	$filter		string	篩選依據
資料點（欄）選擇	$select		string	選取要擷取的資料行

傳回

名稱	路徑	類型	Description
Odata 內容	@odata.context	string	Odata.context 連結。
Odata 計數	@odata.count	integer	@odata.count
value	value	array of object	value
Odata 類型	value.@odata.type	string	@odata.type
顯示名稱	value.displayName	string	會員全名
使用者主體名稱	value.userPrincipalName	string	成員的使用者主體名稱
ID	value.id	string	成員的物件識別碼
職稱	value.jobTitle	string	職位名稱
郵件暱稱	value.mailNickname	string	會員的電子郵件暱稱
郵件	value.mail	string	會員電子郵件
名字	value.givenName	string	會員的名字
Surname	value.surname	string	會員姓氏
商務電話	value.businessPhones	array of string	商務電話
行動電話	value.mobilePhone	string	手機
辦公地點	value.officeLocation	string	辦公室地點
首選語言	value.preferredLanguage	string	Microsoft Entra ID 中設定的慣用語言。

取得成員群組

作業識別碼：: GetMemberGroups

使用者（成員）的群組成員資格

參數

名稱	機碼	必要	類型	Description
Microsoft Entra ID 成員（使用者）的物件識別碼	member-id	True	string	Microsoft Entra ID 成員（使用者）的物件識別碼
僅啟用安全性（true/false）	securityEnabledOnly	True	boolean	您是否只想擷取已啟用安全性的群組？

傳回

名稱	路徑	類型	Description
Odata 內容	@odata.context	string	Odata.context 連結。
value	value	array of string	value

取得會員授權詳細資料

作業識別碼：: GetMemberLicenseDetails

擷取群組成員（使用者）的授權詳細資料

參數

名稱	機碼	必要	類型	Description
Microsoft Entra ID 成員（使用者）的物件識別碼	id	True	string	Microsoft Entra ID 成員（使用者）的物件識別碼
資料點（欄）的選擇	$select		string	資料點（欄）的選擇

傳回

名稱	路徑	類型	Description
Odata 內容	@odata.context	string	Odata.context 連結。
value	value	array of object	value
ID	value.id	string	識別碼
SKU 識別碼	value.skuId	string	SKU 的識別碼。
SKU 零件編號	value.skuPartNumber	string	SKU 的名稱
服務計劃	value.servicePlans	array of object	服務計劃
servicePlanId	value.servicePlans.servicePlanId	string	servicePlanId
servicePlanName	value.servicePlans.servicePlanName	string	servicePlanName
provisioning狀態	value.servicePlans.provisioningStatus	string	provisioning狀態
應用到	value.servicePlans.appliesTo	string	應用到

取得群組屬性

作業識別碼：: GetGroupProperties

擷取 Microsoft Entra ID 群組的屬性和關聯性

參數

名稱	機碼	必要	類型	Description
Microsoft Entra ID 群組的物件識別碼	group-id	True	string	Microsoft Entra ID 群組的物件識別碼

傳回

名稱	路徑	類型	Description
Odata 內容	@odata.context	string	Odata.context 連結。
ID	id	string	群組的物件識別碼
刪除日期時間	deletedDateTime	string	群組的刪除日期時間
Classification	classification	string	分類
建立日期時間	createdDateTime	string	群組的建立日期時間
創建選項	creationOptions	array of string	創建了組的選項。
Description	description	string	描述
顯示名稱	displayName	string	群組的顯示名稱
到期日期時間	expirationDateTime	string	群組的到期日期時間
群組類型	groupTypes	array of string	群組的群組類型。
可指派給角色	isAssignableToRole	string	可以將角色指派給此群組嗎？
郵件	mail	string	群組的電子郵件
郵件已啟用	mailEnabled	boolean	是否啟用群組電子郵件？
郵件暱稱	mailNickname	string	群組的電子郵件暱稱
會員規則	membershipRule	string	用於成員資格評估的規則。
成員資格規則處理狀態	membershipRuleProcessingState	string	用於成員資格評估之規則的處理狀態。
OnPremises 網域名稱	onPremisesDomainName	string	包含內部部署網域 FQDN，也稱為從內部部署目錄同步處理的 dnsDomainName。
OnPremises 上次同步處理日期時間	onPremisesLastSyncDateTime	string	租用戶上次與內部部署目錄同步的時間和日期。
OnPremises NetBios 名稱	onPremisesNetBiosName	string	內部部署伺服器的網路服務名稱。
OnPremises Sam 帳戶名稱	onPremisesSamAccountName	string	內部部署目錄的 Sam 帳戶名稱。
OnPremises 安全性識別碼	onPremisesSecurityIdentifier	string	內部部署安全性識別碼。
已啟用內部部署同步	onPremisesSyncEnabled	boolean	如果已為群組啟用內部部署同步處理，則為 True。
偏好的資料位置	preferredDataLocation	string	群組的偏好資料位置。
首選語言	preferredLanguage	string	Microsoft Entra ID 中設定的慣用語言。
代理地址	proxyAddresses	array of string	群組的 Proxy 位址。
更新日期時間	renewedDateTime	string	群組的更新日期時間。
resourceBehaviorOptions	resourceBehaviorOptions	array of string	群組的資源行為選項。
resourceProvisioning選項	resourceProvisioningOptions	array of string	群組的資源佈建選項。
已啟用安全性	securityEnabled	boolean	指出群組是否已啟用安全性。
安全性標識碼	securityIdentifier	string	群組的安全性識別碼。
Theme	theme	string	Microsoft Entra ID 群組的主題。
可見度	visibility	string	群組的可見性。
onPremisesProvisioningErrors	onPremisesProvisioningErrors	array of string	組的內部部署配置錯誤。

共用方式為