Consultes d'exemple d'inventari de Power Platform

Les següents consultes d'exemple s'executen sobre la taula PowerPlatformResources a Azure Resource Graph. Cobreixen el recompte i la distribució de recursos, el descobriment de camps, la cerca de recursos i l'anàlisi d'ús de connectors. Per a una visió general de l'inventari de Power Platform, vegeu Inventari de Power Platform. Per a la referència d'esquemes i camps, vegeu la referència a l'esquema d'inventari de Power Platform.

Com executar aquestes consultes

Pots executar qualsevol d'aquestes consultes des de les interfícies d'Azure Resource Graph. Per a instruccions pas a pas, consulta les següents guies d'inici ràpid:

Recomptes i distribució

Comptatge total de tots els recursos

PowerPlatformResources
| count

Comptatges totals per tipus de recurs

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

Comptatges per entorn

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

Recomptes per regió

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

Principals propietaris per nombre d'objectes

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

Cerques de recursos

Troba un únic agent al llogater

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

Suggeriment

Pots trobar l'ID de l'agent a l'URL de Copilot Studio quan visualitzis l'agent, o a la columna Nom de la taula d'inventari.

Compta els agents per arnès

Mostra un desglossament dels agents creats amb l'arnès Microsoft Copilot, Copilot Chat harness o arnès estàndard.

Pots veure l'arnès d'un agent a la columna Harness al centre d'administració de Power Platform, a ManageCopilot> Studio. Aquesta columna és només una columna d'interfície d'usuari. Harness encara no es retorna com a metadades d'agent, així que aquesta consulta el deriva dels camps que retorna l'inventari: properties.isCLIAgent, properties.model, i properties.createdIn. Quan el properties.harness camp estigui disponible, el pots consultar directament. Per a les definicions de camps, vegeu Microsoft Copilot Studio Agent Inventory Schema.

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

Llista agents amb el seu arnès

Retorna una fila per agent amb el seu arnès, així pots trobar i actuar sobre agents individuals en comptes de només comptar-los. Descomenta la where línia per tornar només els agents construïts amb l'arnès Microsoft 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

Elements creats en les últimes 24 hores

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

Power Pages consultes (previsualització)

Les consultes de Power Pages utilitzen el tipus de microsoft.powerpages/sites recurs. L'inventari de Power Pages només està disponible per a administradors globals, administradors de Power Platform i administradors de Dynamics 365.

Llista de llocs de Power Pages

Aquesta consulta retorna un inventari a tot el llogater dels llocs Power Pages amb el seu entorn, propietari i dates de creació i modificació.

PowerPlatformResources
| where type =~ "microsoft.powerpages/sites"
| extend properties = parse_json(properties)
| project siteName = tostring(properties.displayName),
    siteId = name,
    environmentId = tostring(properties.environmentId),
    ownerId = tostring(properties.ownerId),
    createdOn = todatetime(properties.createdAt),
    lastModifiedOn = todatetime(properties.lastModifiedAt)
| order by siteName asc

Compta els llocs de Power Pages per entorn

Aquesta consulta mostra quins entorns contenen més llocs de Power Pages.

PowerPlatformResources
| where type =~ "microsoft.powerpages/sites"
| extend properties = parse_json(properties)
| extend environmentId = tostring(properties.environmentId)
| summarize siteCount = count() by environmentId
| order by siteCount desc

Comptes els llocs de Power Pages per propietari

Aquesta consulta mostra els propietaris associats al major nombre de llocs Power Pages per donar suport a revisions de propietat i planificació de la continuïtat del negoci.

PowerPlatformResources
| where type =~ "microsoft.powerpages/sites"
| extend properties = parse_json(properties)
| extend ownerId = tostring(properties.ownerId)
| summarize siteCount = count() by ownerId
| order by siteCount desc

Llocs de Power Pages amb accés anònim activat

Aquesta consulta troba llocs les metadades de l'inventari dels quals indiquen que es permet l'accés anònim.

PowerPlatformResources
| where type =~ "microsoft.powerpages/sites"
| extend properties = parse_json(properties)
| extend anonymousAccessEnabled = tobool(properties.anonymousAccessAllowed)
| where anonymousAccessEnabled == true
| project siteName = tostring(properties.displayName),
    siteId = name,
    environmentId = tostring(properties.environmentId),
    websiteUrl = tostring(properties.siteUrl)
| order by siteName asc

Llocs recentment creats a Power Pages

Aquesta consulta retorna llocs creats durant els últims 30 dies. Ajusta l'interval segons calgui.

PowerPlatformResources
| where type =~ "microsoft.powerpages/sites"
| extend properties = parse_json(properties)
| extend createdOn = todatetime(properties.createdAt)
| where createdOn >= ago(30d)
| project siteName = tostring(properties.displayName),
    siteId = name,
    environmentId = tostring(properties.environmentId),
    ownerId = tostring(properties.ownerId),
    createdOn
| order by createdOn desc

Llocs de Power Pages utilitzant dominis personalitzats

Aquesta consulta retorna els llocs amb metadades d'inventari que inclouen una URL personalitzada.

PowerPlatformResources
| where type =~ "microsoft.powerpages/sites"
| extend properties = parse_json(properties)
| extend customDomain = tostring(properties.customSiteUrl)
| where isnotempty(customDomain)
| project siteName = tostring(properties.displayName),
    siteId = name,
    environmentId = tostring(properties.environmentId),
    websiteUrl = tostring(properties.siteUrl),
    customDomain
| order by siteName asc

Power Pages amb altres recursos de Power Platform

Aquesta consulta resumeix el recompte de recursos per tipus i entorn a través de Power Platform, incloent-hi els llocs de Power Pages. Els registres sense un ID d'entorn queden exclosos.

PowerPlatformResources
| extend properties = parse_json(properties)
| extend environmentId = tostring(properties.environmentId)
| where isnotempty(environmentId)
| summarize resourceCount = count() by environmentId, type
| order by environmentId asc, resourceCount desc

Consultes de connectors

Les consultes següents analitzen l'ús dels connectors entre els tipus de recursos coberts per l'inventari de connectors. Cada consulta opera sobre l'array properties.powerPlatformConnectors emès per aplicacions de canvas, aplicacions basades en models, aplicacions integrades en temps d'execució gestionat per Copilot, fluxos al núvol, fluxos d'agents, fluxos d'agents de flux de treball, agents de Copilot Studio a l'arnès Standard o Microsoft Copilot, i agents creats a Microsoft 365 Copilot Agent Builder. Les aplicacions integrades en runtime gestionat per Copilot utilitzen el microsoft.powerapps/apps tipus amb el microsoftApp subtipus. Les consultes exclouen les aplicacions d'App Builder, que utilitzen el mateix tipus però no emeten dades connectors.

Connectors principals utilitzats a través dels recursos de Power Platform

Llista els connectors utilitzats pels recursos més distintius. Útil per entendre quins connectors dominen l'adopció a tot el llogater.

PowerPlatformResources
| where type in (
    "microsoft.powerapps/canvasapps",
    "microsoft.powerapps/modeldrivenapps",
    "microsoft.powerapps/apps",
    "microsoft.powerautomate/cloudflows",
    "microsoft.powerautomate/agentflows",
    "microsoft.powerautomate/m365agentflows",
    "microsoft.copilotstudio/agents")
| extend properties = parse_json(properties)
| where type != "microsoft.powerapps/apps" or tostring(properties.subType) == "microsoftApp"
| 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ó del nombre de connectors per recurs

Mostra quants recursos utilitzen 0, 1, 2 o més connectors. Útil per detectar casos atípics de complexitat.

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

Troba tots els recursos que utilitzin un connector específic

Substitueix-lo shared_sharepointonline pel connector que vulguis buscar. Aquesta consulta és útil per a l'anàlisi d'impacte quan un connector té un problema conegut, està sent obsolet o requereix nova llicència.

PowerPlatformResources
| where type in (
    "microsoft.powerapps/canvasapps",
    "microsoft.powerapps/modeldrivenapps",
    "microsoft.powerapps/apps",
    "microsoft.powerautomate/cloudflows",
    "microsoft.powerautomate/agentflows",
    "microsoft.powerautomate/m365agentflows",
    "microsoft.copilotstudio/agents")
| extend properties = parse_json(properties)
| where type != "microsoft.powerapps/apps" or tostring(properties.subType) == "microsoftApp"
| 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

Ús del connector per entorn

Llista cada connector utilitzat en cada entorn, amb el recompte de recursos diferents que l'utilitzen. Aquesta llista és útil per entendre patrons d'adopció i informar les decisions de polítiques DLP.

PowerPlatformResources
| where type in (
    "microsoft.powerapps/canvasapps",
    "microsoft.powerapps/modeldrivenapps",
    "microsoft.powerapps/apps",
    "microsoft.powerautomate/cloudflows",
    "microsoft.powerautomate/agentflows",
    "microsoft.powerautomate/m365agentflows",
    "microsoft.copilotstudio/agents")
| extend properties = parse_json(properties)
| where type != "microsoft.powerapps/apps" or tostring(properties.subType) == "microsoftApp"
| 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