Consultas de ejemplo del inventario de Power Platform

Las siguientes consultas de ejemplo se ejecutan en la tabla PowerPlatformResources en Azure Resource Graph. Abarcan el recuento y distribución de recursos, la detección de campos, las búsquedas de recursos y el análisis de uso del conector. Para obtener información general sobre el inventario de Power Platform, consulte Inventario de Power Platform. Para consultar la referencia del esquema y de los campos, vea Referencia del esquema de inventario de Power Platform.

Cómo ejecutar estas consultas

Puede ejecutar cualquiera de estas consultas desde las interfaces de Azure Resource Graph. Para obtener instrucciones paso a paso, consulte las siguientes guías de inicio rápido:

Recuentos y distribución

Recuento total de todos los recursos

PowerPlatformResources
| count

Recuentos totales por tipo de recurso

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

Recuentos por entorno

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

Recuentos por región

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

Principales propietarios por recuento de elementos

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

Búsquedas de recursos

Búsqueda de un único agente en el inquilino

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

Tip

Puede encontrar el identificador del agente en la dirección URL de Copilot Studio al ver el agente o en la columna Nombre de la tabla de inventario.

Elementos creados en las últimas 24 horas

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

Consultas del conector (versión preliminar)

Las siguientes consultas analizan el uso del conector en los tipos de recursos cubiertos por el inventario de conectores (versión preliminar). Cada consulta opera sobre la matriz properties.powerPlatformConnectors generada por aplicaciones de lienzo, aplicaciones basadas en modelos, flujos en la nube, flujos de agente, flujos de agente de flujos de trabajo y agentes de Copilot Studio.

Principales conectores usados en los recursos de Power Platform

Enumera los conectores usados por los recursos más distintos. Es útil para entender qué conectores lideran la adopción en toda la organización.

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

Distribución del recuento de conectores por recurso

Muestra cuántos recursos usan 0, 1, 2 o más conectores. Útil para detectar valores atípicos de complejidad.

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

Búsqueda de todos los recursos que usan un conector específico

Reemplace por shared_sharepointonline el conector que desea buscar. Esta consulta es útil para el análisis de impacto cuando un conector tiene un problema conocido, está en desuso o requiere nuevas licencias.

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

Uso del conector por entorno

Enumera todos los conectores usados en cada entorno, con el recuento de distintos recursos que lo usan. Esta lista es útil para comprender los patrones de adopción e informar a las decisiones de directiva 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

Contenido relacionado

  • Last updated on