Power Platform inventory 透過 Azure Resource Graph 中的 PowerPlatformResources 資料表揭露資源資料。 本文說明該表格中可用的資源類型與欄位,讓您能建立針對性的查詢,並理解 Power Platform 庫存 體驗背後的資料模型。
關於如何程式化查詢資料表,請參閱 Power Platform 庫存 API。 完整 REST API 參考資料請參閱 Power Platform REST API 文件。
資源類型
表格中的 PowerPlatformResources 每個記錄都有一個 類型欄位來 識別資源類型。 下表列出所有支援的類型。
| 顯示名稱 |
type 數值 |
|---|---|
| 畫布應用程式 | microsoft.powerapps/canvasapps |
| 模型導向應用程式 | microsoft.powerapps/modeldrivenapps |
| 程式碼應用程式 | microsoft.powerapps/codeapps |
| 應用程式建構工具應用程式 | microsoft.powerapps/apps |
| 雲端流程 | microsoft.powerautomate/cloudflows |
| 代理程式流程 | microsoft.powerautomate/agentflows |
| 工作流程代理運行模式 | microsoft.powerautomate/m365agentflows |
| Copilot Studio 經紀人 | microsoft.copilotstudio/agents |
| Environments | microsoft.powerplatform/environments |
| 環境群組 | microsoft.powerplatform/environmentgroups |
共享資源欄位
PowerPlatformResources 表格中的所有資源類型都包含以下欄位。
| 使用者體驗名稱 | API 欄位路徑 | 數據類型 | Description | 範例 | 狀態 |
|---|---|---|---|---|---|
| 項目名稱 | properties.displayName |
字串 | 資源的顯示名稱。 | 費用報表應用程式 | 普遍可用 |
| 品項類型 | type |
字串 | 資源類型識別碼(參見 資源類型)。 | microsoft.powerapps/canvasapps |
普遍可用 |
| 品項識別碼 | name |
字串 | 資源的唯一標識碼。 | aaaa0000-bb11-2222-33cc-444444dddddd |
普遍可用 |
| Location | location |
字串 | 資源的地理區域。 | unitedstates |
普遍可用 |
| 建立時間 | properties.createdAt |
日期時間 | 資源創建的日期和時間。 | 2025-06-01T08:00:00Z |
普遍可用 |
| 由...創建 | properties.createdBy |
字串 | 建立該資源的使用者的物件 ID。 | aaaa0000-bb11-2222-33cc-444444dddddd |
普遍可用 |
Note
該 tenantId 欄位也可作為頂層 ARM 欄位,出現在每個資源記錄中。
連接器清單(預覽)
Power Platform 清單記錄每個資源所使用的連接器及其操作。 這些資料以 連接器 欄位的形式出現在 Power Platform 管理中心的庫存網格中。 統一的 Manage > Inventory 頁面,以及資源專屬檢視,分別位於 Copilot Studio、Power Apps 和 Power Automate,並作為程式查詢中的 properties.powerPlatformConnectors 陣列。
以下資源類型會產生連接器資料:canvas 應用程式、模型驅動應用程式、雲端流程、代理流程、工作流程代理流程,以及 Copilot Studio 代理程式(包括 Microsoft 365 Copilot 代理建構器)。
對於流程(雲端流程、代理程式流程和工作流程代理程式流程),清查資料還會擷取啟動流程的連接器和作業,分別為 properties.trigger 和 properties.triggerOperation。 這些欄位互補 powerPlatformConnectors,後者捕捉了在流程執行過程中所呼叫的連接器。
Schema
| API 欄位路徑 | 數據類型 | Description | 狀態 |
|---|---|---|---|
properties.powerPlatformConnectors |
陣列 | 資源所使用的連接器。 | Preview |
properties.powerPlatformConnectors[].connectorId |
字串 | 連接器的識別碼(例如, shared_sharepointonline) |
Preview |
properties.powerPlatformConnectors[].operations |
陣列 | 資源所呼叫的連接器上的操作。 | Preview |
properties.powerPlatformConnectors[].operations[].operationId |
字串 | 操作的識別碼(例如, GetItems) |
Preview |
範例
{
"type": "microsoft.powerapps/canvasapps",
"properties": {
"displayName": "Learning Resources App",
"powerPlatformConnectors": [
{
"connectorId": "shared_sharepointonline",
"operations": [
{ "operationId": "GetItems" },
{ "operationId": "PostItem" }
]
},
{
"connectorId": "shared_office365users",
"operations": [
{ "operationId": "MyProfile_V2" }
]
}
]
}
}
Note
Copilot Studio 代理程式會輸出每項作業的額外中繼資料,用來反映代理程式如何將連接器用作工具或知識來源。 詳情請參見 Microsoft Copilot Studio 代理人庫存結構。
已知的限制
- 表格式連接器不會回報作業結果。 綁定為資料來源的連接器(如 SharePoint、Dataverse、SQL Server 和 Excel Online)會出現在
powerPlatformConnectors,但會發射空的operations陣列。 - 內建的動作不會被捕捉。 Power Automate 內建的動作,如 HTTP 內建動作、控制動作和資料操作,並非連接器,且不會出現在
powerPlatformConnectors。 這種差異經常讓人感到困惑:透過 HTTP 內建動作呼叫外部服務的流程,不會顯示該呼叫的連接器。 - 程式應用程式、氛圍應用程式和應用程式建構器應用程式不在內。 只有本節列出的資源類型會發出連接器資料。
- 模型驅動應用程式很少回報連接器。 模型驅動應用程式很少直接呼叫連接器。 連接器資料僅在畫布頁面嵌入模型驅動應用程式時出現,且該頁面的連接器使用情況會被記錄在畫布頁面記錄中。
- 沒有連接器顯示名稱或分級資料。 此版本僅公開連接器 ID 與操作 ID。 顯示名稱、等級(標準/高級)和出版商資訊都不包含在內。
畫布應用程式
| API 欄位路徑 | 數據類型 | Description | 範例 | 狀態 |
|---|---|---|---|---|
properties.ownerId |
字串 | 資源擁有者的物件 ID。 | aaaa0000-bb11-2222-33cc-444444dddddd |
普遍可用 |
properties.environmentId |
字串 | 包含該資源的環境識別碼。 | aaaa0000-bb11-2222-33cc-444444dddddd |
普遍可用 |
properties.lastModifiedAt |
日期時間 | 應用程式最後修改的日期和時間。 | 2026-01-15T10:30:00Z |
普遍可用 |
properties.lastModifiedBy |
字串 | 上次修改應用程式之使用者的物件識別碼。 | aaaa0000-bb11-2222-33cc-444444dddddd |
普遍可用 |
properties.isQuarantined |
布林值 | 應用程式是否被隔離。 | false |
普遍可用 |
properties.powerPlatformConnectors |
陣列 | 應用程式使用的連接器和操作。 請參閱連接器庫存(預覽)。 | 詳見章節。 | Preview |
Note
這個 properties.isQuarantined 欄位可以透過 API 取得,但尚未在 Power Platform 管理中心的庫存體驗中顯示。
模型導向應用程式
| API 欄位路徑 | 數據類型 | Description | 範例 | 狀態 |
|---|---|---|---|---|
properties.ownerId |
字串 | 資源擁有者的物件 ID。 | aaaa0000-bb11-2222-33cc-444444dddddd |
普遍可用 |
properties.environmentId |
字串 | 包含該資源的環境識別碼。 | aaaa0000-bb11-2222-33cc-444444dddddd |
普遍可用 |
properties.lastModifiedAt |
日期時間 | 應用程式最後修改的日期和時間。 | 2026-01-15T10:30:00Z |
普遍可用 |
properties.lastModifiedBy |
字串 | 上次修改應用程式之使用者的物件識別碼。 | aaaa0000-bb11-2222-33cc-444444dddddd |
普遍可用 |
properties.isQuarantined |
布林值 | 應用程式是否被隔離。 | false |
普遍可用 |
properties.appModuleId |
字串 | Dataverse 應用程式模組 ID。 | aaaa0000-bb11-2222-33cc-444444dddddd |
普遍可用 |
properties.logicalName |
字串 | 應用程式的 Dataverse 邏輯名稱。 | contoso_expensereport |
普遍可用 |
properties.powerPlatformConnectors |
陣列 | 應用程式使用的連接器和操作。 請參閱連接器庫存(預覽)。 | 詳見章節。 | Preview |
Note
這個 properties.isQuarantined 欄位可以透過 API 取得,但尚未在 Power Platform 管理中心的庫存體驗中顯示。
Note
該 properties.powerPlatformConnectors 領域很少回傳模型驅動應用程式的資料,因為模型驅動應用程式不會直接使用連接器。 改為在畫布頁面記錄中擷取內嵌畫布頁面所使用的連接器。
程式碼應用程式
| API 欄位路徑 | 數據類型 | Description | 範例 | 狀態 |
|---|---|---|---|---|
properties.ownerId |
字串 | 資源擁有者的物件 ID。 | aaaa0000-bb11-2222-33cc-444444dddddd |
普遍可用 |
properties.environmentId |
字串 | 包含該資源的環境識別碼。 | aaaa0000-bb11-2222-33cc-444444dddddd |
普遍可用 |
properties.lastModifiedAt |
日期時間 | 應用程式最後修改的日期和時間。 | 2026-01-15T10:30:00Z |
普遍可用 |
properties.lastModifiedBy |
字串 | 上次修改應用程式之使用者的物件識別碼。 | aaaa0000-bb11-2222-33cc-444444dddddd |
普遍可用 |
properties.isQuarantined |
布林值 | 應用程式是否被隔離。 | false |
普遍可用 |
properties.subType |
字串 | 應用程式的子類型: byocApp 或 vibeApp。 |
byocApp |
普遍可用 |
Note
這個 properties.isQuarantined 欄位可以透過 API 取得,但尚未在 Power Platform 管理中心的庫存體驗中顯示。
應用程式建構工具應用程式
欲了解更多資訊,請參閱 應用程式建置器。
| API 欄位路徑 | 數據類型 | Description | 範例 | 狀態 |
|---|---|---|---|---|
properties.ownerId |
字串 | 資源擁有者的物件 ID。 | aaaa0000-bb11-2222-33cc-444444dddddd |
普遍可用 |
properties.environmentId |
字串 | 包含該資源的環境識別碼。 | aaaa0000-bb11-2222-33cc-444444dddddd |
普遍可用 |
properties.lastModifiedAt |
日期時間 | 應用程式最後修改的日期和時間。 | 2026-01-15T10:30:00Z |
普遍可用 |
properties.lastModifiedBy |
字串 | 上次修改應用程式之使用者的物件識別碼。 | aaaa0000-bb11-2222-33cc-444444dddddd |
普遍可用 |
properties.isQuarantined |
布林值 | 應用程式是否被隔離。 | false |
普遍可用 |
properties.subType |
字串 | 應用程式的子類型。 目前是 appBuilderApp. |
appBuilderApp |
普遍可用 |
Note
這個 properties.isQuarantined 欄位可以透過 API 取得,但尚未在 Power Platform 管理中心的庫存體驗中顯示。
雲端流程
| API 欄位路徑 | 數據類型 | Description | 範例 | 狀態 |
|---|---|---|---|---|
properties.ownerId |
字串 | 資源擁有者的物件 ID。 | aaaa0000-bb11-2222-33cc-444444dddddd |
普遍可用 |
properties.environmentId |
字串 | 包含該資源的環境識別碼。 | aaaa0000-bb11-2222-33cc-444444dddddd |
普遍可用 |
properties.lastModifiedAt |
日期時間 | 上次修改流程的日期與時間。 | 2026-01-15T10:30:00Z |
普遍可用 |
properties.lastModifiedBy |
字串 | 最後修改流程的使用者的物件 ID。 | aaaa0000-bb11-2222-33cc-444444dddddd |
普遍可用 |
properties.workflowEntityId |
字串 | Dataverse 工作流程實體 ID。 | aaaa0000-bb11-2222-33cc-444444dddddd |
普遍可用 |
properties.powerPlatformConnectors |
陣列 | 流程中使用的連接器與操作。 請參閱連接器庫存(預覽)。 | 詳見章節。 | Preview |
properties.trigger |
字串 | 啟動流程的連接器。 如果觸發程序並非根據連接器引發 (例如,定期或手動引發),則為空白。 | sharepointonline |
Preview |
properties.triggerOperation |
字串 | 啟動流程的操作。 | GetOnNewItems |
Preview |
代理程式流程
| API 欄位路徑 | 數據類型 | Description | 範例 | 狀態 |
|---|---|---|---|---|
properties.ownerId |
字串 | 資源擁有者的物件 ID。 | aaaa0000-bb11-2222-33cc-444444dddddd |
普遍可用 |
properties.environmentId |
字串 | 包含該資源的環境識別碼。 | aaaa0000-bb11-2222-33cc-444444dddddd |
普遍可用 |
properties.lastModifiedAt |
日期時間 | 上次修改流程的日期與時間。 | 2026-01-15T10:30:00Z |
普遍可用 |
properties.lastModifiedBy |
字串 | 最後修改流程的使用者的物件 ID。 | aaaa0000-bb11-2222-33cc-444444dddddd |
普遍可用 |
properties.workflowEntityId |
字串 | Dataverse 工作流程實體 ID。 | aaaa0000-bb11-2222-33cc-444444dddddd |
普遍可用 |
properties.powerPlatformConnectors |
陣列 | 流程中使用的連接器與操作。 請參閱連接器庫存(預覽)。 | 詳見章節。 | Preview |
properties.trigger |
字串 | 啟動流程的連接器。 如果觸發程序並非根據連接器引發 (例如,定期或手動引發),則為空白。 | sharepointonline |
Preview |
properties.triggerOperation |
字串 | 啟動流程的操作。 | GetOnNewItems |
Preview |
工作流程代理運行模式
| API 欄位路徑 | 數據類型 | Description | 範例 | 狀態 |
|---|---|---|---|---|
properties.ownerId |
字串 | 資源擁有者的物件 ID。 | aaaa0000-bb11-2222-33cc-444444dddddd |
普遍可用 |
properties.environmentId |
字串 | 包含該資源的環境識別碼。 | aaaa0000-bb11-2222-33cc-444444dddddd |
普遍可用 |
properties.lastModifiedAt |
日期時間 | 上次修改流程的日期與時間。 | 2026-01-15T10:30:00Z |
普遍可用 |
properties.lastModifiedBy |
字串 | 最後修改流程的使用者的物件 ID。 | aaaa0000-bb11-2222-33cc-444444dddddd |
普遍可用 |
properties.workflowEntityId |
字串 | Dataverse 工作流程實體 ID。 | aaaa0000-bb11-2222-33cc-444444dddddd |
普遍可用 |
properties.powerPlatformConnectors |
陣列 | 流程中使用的連接器與操作。 請參閱連接器庫存(預覽)。 | 詳見章節。 | Preview |
properties.trigger |
字串 | 啟動流程的連接器。 如果觸發程序並非根據連接器引發 (例如,定期或手動引發),則為空白。 | sharepointonline |
Preview |
properties.triggerOperation |
字串 | 啟動流程的操作。 | GetOnNewItems |
Preview |
Copilot Studio 經紀人
Copilot Studio 代理在共享欄位之外擁有豐富的屬性集合,包括核心屬性、身份屬性與配置屬性。 完整架構請參見 Microsoft Copilot Studio 代理人庫存架構。
Environments
欲了解更多環境資訊,請參閱 環境概述。
| API 欄位路徑 | 數據類型 | Description | 範例 | 狀態 |
|---|---|---|---|---|
properties.environmentType |
字串 | 環境類型:生產環境、預設、生產沙盒、試用環境、開發者環境或 Teams 的 Dataverse。 | Production |
普遍可用 |
properties.isManaged |
布林值 | 環境是否為 受管理環境。 | true |
普遍可用 |
properties.environmentGroup |
字串 | 環境群組的名稱 (如果已指派)。 | Finance |
普遍可用 |
properties.environmentGroupId |
字串 | 環境群組的識別碼(若已指派)。 | aaaa0000-bb11-2222-33cc-444444dddddd |
普遍可用 |
properties.lastModifiedAt |
日期時間 | 環境最後修改的日期與時間。 | 2026-01-15T10:30:00Z |
普遍可用 |
環境群組
欲了解更多資訊,請參閱 環境群組。
| API 欄位路徑 | 數據類型 | Description | 範例 | 狀態 |
|---|---|---|---|---|
properties.description |
字串 | 環境群組的描述。 | All finance team environments |
普遍可用 |
properties.lastModifiedAt |
日期時間 | 該團體最後修改的日期和時間。 | 2026-01-15T10:30:00Z |
普遍可用 |