Примеры запросов для инвентаризации 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 при просмотре агента или в столбце "Имя " таблицы инвентаризации.

Элементы, созданные за последние 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