Power Platform 庫存結構參考

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 StudioPower AppsPower Automate,並作為程式查詢中的 properties.powerPlatformConnectors 陣列。

以下資源類型會產生連接器資料:canvas 應用程式、模型驅動應用程式、雲端流程、代理流程、工作流程代理流程,以及 Copilot Studio 代理程式(包括 Microsoft 365 Copilot 代理建構器)。

對於流程(雲端流程、代理程式流程和工作流程代理程式流程),清查資料還會擷取啟動流程的連接器和作業,分別為 properties.triggerproperties.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 字串 應用程式的子類型: byocAppvibeApp byocApp 普遍可用

Note

子類型值分別對應至程式碼應用程式氛圍應用程式

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 普遍可用