Примеры запросов для инвентаризации Power Platform

Следующие примеры запросов выполняются к таблице PowerPlatformResources в Azure Resource Graph. Они охватывают подсчет ресурсов и распределение, обнаружение полей, поиск ресурсов и анализ использования соединителей. Общие сведения о инвентаризации Power Platform см. в разделе "Инвентаризация Power Platform". Сведения о схеме и полях см. в справочнике по схеме инвентаризации Power Platform.

Выполнение этих запросов

Вы можете выполнять любой из этих запросов из интерфейсов Azure Resource Graph. Пошаговые инструкции см. в следующих кратких руководствах.

Количество и распределение

Общее количество всех ресурсов

PowerPlatformResources
| count

Общее число по типу ресурса

PowerPlatformResources
| summarize resourceCount = count() by type
| order by resourceCount

Счетчики по среде

PowerPlatformResources
| extend properties = parse_json(properties)
| extend environmentId = tostring(properties.environmentId)
| summarize resourceCount = count() by environmentId
| order by resourceCount desc

Количество по регионам

PowerPlatformResources
| summarize resourceCount = count() by location
| order by resourceCount desc

Основные владельцы по количеству элементов

PowerPlatformResources
| extend properties = parse_json(properties)
| extend ownerId = tostring(properties.ownerId)
| summarize resourceCount = count() by ownerId
| order by resourceCount desc

Поиск ресурсов

Поиск одного агента в клиенте

PowerPlatformResources
| where type == "microsoft.copilotstudio/agents"
| where name == "[Enter the agent's ID]"

Tip

Идентификатор агента можно найти в URL-адресе Copilot Studio при просмотре агента или в столбце "Имя " таблицы инвентаризации.

Количество агентов по harness

Отображает разбивку агентов, созданных с помощью среды GitHub Copilot, среды Copilot Chat или стандартной среды.

Вы можете увидеть среду агента в столбце Harness в центре администрирования Power Platform в разделе Manage>Copilot Studio. Этот столбец является только столбцом пользовательского интерфейса. Harness пока не возвращается в метаданных агента, поэтому этот запрос определяет его на основе полей, которые возвращает инвентаризация: properties.isCLIAgent, properties.model и properties.createdIn. properties.harness Когда поле становится доступным, его можно запрашивать напрямую. Определения полей см. в схеме инвентаризации агента Microsoft Copilot Studio.

PowerPlatformResources
| where type == "microsoft.copilotstudio/agents"
| extend properties = parse_json(properties)
| extend
    isCLIAgent = tobool(properties.isCLIAgent),
    model = tostring(properties.model),
    createdIn = tostring(properties.createdIn)
| extend harness = case(
    isCLIAgent == true, "GitHub Copilot",
    model =~ "Microsoft 365 Copilot" or createdIn =~ "Microsoft 365 Copilot Agent Builder", "Copilot Chat",
    "Standard")
| summarize agentCount = count() by harness
| order by agentCount desc

Список агентов и их харнессов

Возвращает по одной строке на каждого агента с соответствующим harness, чтобы можно было находить отдельных агентов и выполнять действия с ними, а не просто подсчитывать их количество. Раскомментируйте строку where, чтобы возвращались только агенты, созданные с использованием harness GitHub Copilot.

PowerPlatformResources
| where type == "microsoft.copilotstudio/agents"
| extend properties = parse_json(properties)
| extend
    isCLIAgent = tobool(properties.isCLIAgent),
    model = tostring(properties.model),
    createdIn = tostring(properties.createdIn)
| extend harness = case(
    isCLIAgent == true, "GitHub Copilot",
    model =~ "Microsoft 365 Copilot" or createdIn =~ "Microsoft 365 Copilot Agent Builder", "Copilot Chat",
    "Standard")
//| where harness == "GitHub Copilot"
| project agentName = tostring(properties.displayName),
          agentId = name,
          harness,
          environmentId = tostring(properties.environmentId),
          ownerId = tostring(properties.ownerId),
          createdAt = todatetime(properties.createdAt)
| order by harness asc, createdAt desc

Элементы, созданные за последние 24 часа

PowerPlatformResources
| extend properties = parse_json(properties)
| extend createdAt = todatetime(properties.createdAt)
| where createdAt >= ago(24h)

Запросы соединителя (предварительная версия)

Следующие запросы анализируют использование соединителя в типах ресурсов, охватываемых инвентаризацией соединителей (предварительная версия). Каждый запрос работает с массивом properties.powerPlatformConnectors, формируемым приложениями на основе холста, приложениями на основе модели, облачными потоками, потоками агентов, потоками агентов рабочего процесса и агентами Copilot Studio.

Основные соединители, используемые в ресурсах Power Platform

Выводит список соединителей, используемых самыми различными ресурсами. Полезно для понимания того, какие коннекторы наиболее распространены в рамках тенанта.

PowerPlatformResources
| where type in (
    "microsoft.powerapps/canvasapps",
    "microsoft.powerapps/modeldrivenapps",
    "microsoft.powerautomate/cloudflows",
    "microsoft.powerautomate/agentflows",
    "microsoft.powerautomate/m365agentflows",
    "microsoft.copilotstudio/agents")
| extend properties = parse_json(properties)
| mv-expand connector = properties.powerPlatformConnectors
| extend connectorId = tostring(connector.connectorId)
| where isnotempty(connectorId)
| summarize ResourceCount = dcount(name) by connectorId
| order by ResourceCount desc
| take 10

Распределение количества соединителей на ресурс

Показывает, сколько ресурсов используют 0, 1, 2 или более соединителей. Полезно для выявления аномалий сложности.

PowerPlatformResources
| where type in (
    "microsoft.powerapps/canvasapps",
    "microsoft.powerapps/modeldrivenapps",
    "microsoft.powerautomate/cloudflows",
    "microsoft.powerautomate/agentflows",
    "microsoft.powerautomate/m365agentflows",
    "microsoft.copilotstudio/agents")
| extend properties = parse_json(properties)
| extend connectorCount = array_length(properties.powerPlatformConnectors)
| summarize ResourceCount = count() by toint(connectorCount)
| order by connectorCount asc

Поиск всех ресурсов, использующих определенный соединитель

Замените shared_sharepointonline на разъём, который вы хотите найти. Этот запрос полезен для анализа влияния, если соединитель имеет известную проблему, не рекомендуется или требует нового лицензирования.

PowerPlatformResources
| where type in (
    "microsoft.powerapps/canvasapps",
    "microsoft.powerapps/modeldrivenapps",
    "microsoft.powerautomate/cloudflows",
    "microsoft.powerautomate/agentflows",
    "microsoft.powerautomate/m365agentflows",
    "microsoft.copilotstudio/agents")
| extend properties = parse_json(properties)
| mv-expand connector = properties.powerPlatformConnectors
| where tostring(connector.connectorId) == "shared_sharepointonline"
| project resourceName = tostring(properties.displayName),
          resourceId = name,
          resourceType = type,
          environmentId = tostring(properties.environmentId),
          operationsUsed = connector.operations

Использование соединителя по среде

Перечисляет каждый соединитель, используемый в каждой среде, с количеством отдельных ресурсов, которые используют его. Этот список полезен для понимания моделей внедрения и принятия решений по политике DLP.

PowerPlatformResources
| where type in (
    "microsoft.powerapps/canvasapps",
    "microsoft.powerapps/modeldrivenapps",
    "microsoft.powerautomate/cloudflows",
    "microsoft.powerautomate/agentflows",
    "microsoft.powerautomate/m365agentflows",
    "microsoft.copilotstudio/agents")
| extend properties = parse_json(properties)
| mv-expand connector = properties.powerPlatformConnectors
| extend connectorId = tostring(connector.connectorId)
| where isnotempty(connectorId)
| extend environmentId = tostring(properties.environmentId)
| summarize ResourceCount = dcount(name) by environmentId, connectorId
| order by environmentId asc, ResourceCount desc

Обратная связь

Были ли сведения на этой странице полезными?

Last updated on 2026-08-20