Exemple de interogări pentru inventarul Power Platform

Următoarele interogări exemplu rulează pe tabelul PowerPlatformResources din Azure Resource Graph. Acestea acoperă numărarea și distribuția resurselor, descoperirea terenurilor, căutarea resurselor și analiza utilizării conectoarelor. Pentru o prezentare generală a inventarului Power Platform, vezi Power Platform inventar. Pentru referința pentru schema și câmpul, vezi referința pentru schema de inventar Power Platform.

Cum să rulezi aceste interogări

Poți rula oricare dintre aceste interogări din interfețele Azure Resource Graph. Pentru instrucțiuni pas cu pas, consultați următoarele ghiduri de pornire rapidă:

Numărători și distribuție

Numărătoarea totală a tuturor resurselor

PowerPlatformResources
| count

Numărătoare totală după tipul resursei

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

Numărătoare după mediu

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

Numărătoare pe regiuni

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

Cei mai buni proprietari după numărul de obiecte

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

Căutări de resurse

Găsește un singur agent în chiriaș

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

Sfat

Poți găsi ID-ul agentului în URL-ul Copilot Studio când îl vizualizezi sau în coloana Nume din tabelul de inventar.

Numărați agenții prin ham

Afișează o defalcare a agenților creați cu hamul de Microsoft Copilot, cu hamul Copilot Chat sau cu hamul standard.

Puteți vedea valorificarea unui agent în coloana Valorificare din centrul de administrare Power Platform, sub Gestionare>Copilot Studio. Acea coloană este doar o coloană de interfață utilizator. Valorificarea nu este returnată încă ca metadate ale agentului, prin urmare, această interogare o derivă din câmpurile pe care le returnează inventarul: properties.isCLIAgent, properties.model, și properties.createdIn. properties.harness Când câmpul devine disponibil, îl puteți interoga direct. Pentru definițiile de câmp, consultați Microsoft Copilot Studio schema de inventar agent.

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

Listați agenții cu hamul lor

Returnează un rând per agent cu capacitatea sa de utilizare, astfel încât să puteți găsi și acționa asupra agenților individuali, mai degrabă decât să le contorizați. Nu se renunță where linia pentru a returna numai agenții construiți cu hamul 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

Elemente create în ultimele 24 de ore

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

Power Pages interogări (previzualizare)

Power Pages interogări utilizează tipul de microsoft.powerpages/sites resursă. Power Pages inventar este disponibil doar administratorilor globali, administratorilor Power Platform și administratorilor Dynamics 365.

Listare Power Pages site-uri

Această interogare returnează un inventar la nivel de entitate găzduită de site-uri Power Pages cu mediul lor, proprietarul și datele de creare și modificare.

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

Numărarea Power Pages site-uri în funcție de mediu

Această interogare arată ce medii conțin cele mai Power Pages site-uri.

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

Contorizare Power Pages site-uri după proprietar

Această interogare afișează proprietarii asociați cu cel mai mare număr de site-uri Power Pages pentru a accepta recenziile de proprietate și planificarea continuității activității.

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

Power Pages site-uri cu acces anonim activat

Această interogare găsește site-uri ale căror metadate de inventar indică faptul că accesul anonim este permis.

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

Site-uri Power Pages create recent

Această interogare returnează site-urile create în ultimele 30 de zile. Ajustați intervalul după cum este necesar.

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

Power Pages site-uri care utilizează domenii particularizate

Această interogare returnează site-urile ale căror metadate de inventar includ un URL de site particularizat.

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 cu alte resurse Power Platform

Această interogare rezumă numărul de resurse după tip și mediu în Power Platform, inclusiv după Power Pages site-uri. Înregistrările fără un ID de mediu sunt excluse.

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

Interogări conector

Următoarele interogări analizează utilizarea conectorilor în tipurile de resurse acoperite de inventarul Conector. Fiecare interogare funcționează pe matricea properties.powerPlatformConnectors emisă de aplicațiile de pânză, aplicațiile bazate pe modele, aplicațiile încorporate Copilot modulul runtime gestionat, fluxurile de cloud, fluxurile de agent, fluxurile de agent de flux de lucru, Copilot Studio agenți pe hamul standard sau pe Microsoft Copilot ham și agenții creați în Microsoft 365 Copilot Agent Builder. Aplicațiile încorporate Copilot runtime gestionate utilizează microsoft.powerapps/apps tipul cu subtipulmicrosoftApp. Interogările exclud aplicațiile App Builder, care utilizează același tip, dar nu emit date de conector.

Conectorii de top utilizați în resursele Power Platform

Listează conectorii folosiți de cele mai distincte resurse. Util pentru a înțelege care conectori domină adoptarea pe tot parcursul tenantului.

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

Distribuția numărului de conectori per resursă

Arată câte resurse folosesc 0, 1, 2 sau mai mulți conectori. Util pentru a identifica excepțiile de complexitate.

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

Găsește toate resursele care folosesc un anumit conector

Înlocuiește-l shared_sharepointonline cu conectorul pe care vrei să-l cauți. Această interogare este utilă pentru analiza impactului atunci când un conector are o problemă cunoscută, este deprevăzut sau necesită licențiere noi.

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

Utilizarea conectorului după mediu

Listează fiecare conector folosit în fiecare mediu, cu numărul de resurse distincte care îl folosesc. Această listă este utilă pentru înțelegerea tiparelor de adoptare și pentru a informa deciziile privind politicile 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