Consultas de exemplo para o inventário da Power Platform

As seguintes consultas de exemplo são executadas contra a tabela PowerPlatformResources em Azure Resource Graph. Abrangem contagem e distribuição de recursos, descoberta de campos, consultas de recursos e análise de utilização de conectores. Para uma visão geral do inventário da Power Platform, consulte inventário da Power Platform. Para a referência do esquema e dos campos, consulte a referência do esquema de inventário do Power Platform.

Como executar estas consultas

Pode executar qualquer uma destas consultas a partir das interfaces do Azure Resource Graph. Para instruções passo a passo, consulte os seguintes guias de início rápido:

Contagens e distribuição

Contagem total de todos os recursos

PowerPlatformResources
| count

Contagens totais por tipo de recurso

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

Contagens por ambiente

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

Números por região

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

Principais proprietários por número de itens

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

Consultas de recursos

Encontrar um único agente no inquilino

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

Tip

Pode encontrar o ID do agente na URL do Copilot Studio ao visualizar o agente, ou na coluna Nome da tabela de inventário.

Itens criados nas últimas 24 horas

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

Consultas de conectores (pré-visualização)

As consultas seguintes analisam a utilização dos conectores entre os tipos de recursos abrangidos pelo inventário de Conectores (pré-visualização). Cada consulta opera sobre a matriz properties.powerPlatformConnectors emitida por aplicações de tela, aplicações condicionadas por modelo, fluxos de cloud, fluxos de agentes, fluxos de agentes de fluxo de trabalho e agentes do Copilot Studio.

Principais conectores utilizados em todos os recursos da Power Platform

Lista os conectores usados pelos recursos mais distintos. Útil para perceber quais os conectores que dominam a adoção em todo o inquilino.

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

Distribuição da contagem de conectores por recurso

Mostra quantos recursos usam 0, 1, 2 ou mais conectores. Útil para identificar exceções de complexidade.

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

Encontre todos os recursos que utilizem um conector específico

Substitui shared_sharepointonline pelo conector que queres procurar. Esta consulta é útil para análise de impacto quando um conector tem um problema conhecido, está a ser obsoleto ou necessita de novas licenças.

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

Utilização do conector por ambiente

Lista todos os conectores usados em cada ambiente, com o número de recursos distintos que o utilizam. Esta lista é útil para compreender padrões de adoção e informar decisões políticas de 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

Conteúdo relacionado

  • Last updated on