Ukázkové dotazy inventáře Power Platform

Následující ukázkové dotazy se spouští v tabulce PowerPlatformResources v Azure Resource Graph. Zahrnují počítání a distribuci prostředků, zjišťování dostupných polí, vyhledávání prostředků a analýzu využití konektorů. Přehled inventáře Power Platform najdete v tématu Inventář Power Platform. Referenční informace o schématu a polích najdete v referenčních informacích ke schématu inventáře Power Platform.

Jak spustit tyto dotazy

Z rozhraní Azure Resource Graph můžete spustit kterýkoli z těchto dotazů. Podrobné pokyny najdete v následujících příručkách pro rychlý start:

• Spuštění dotazu Resource Graph pomocí portálu Azure
• Spuštění dotazu Resource Graphu pomocí Azure CLI
• Spuštění dotazu Resource Graphu pomocí Azure PowerShellu
• Spuštění dotazu Azure Resource Graphu pomocí rozhraní REST API

Počty a distribuce

Celkový počet všech prostředků

PowerPlatformResources
| count

Celkový počet podle typu prostředku

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

Počítá podle prostředí

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

Počty podle oblastí

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

Hlavní vlastníci podle počtu položek

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

Vyhledávání zdrojů

Vyhledání jednoho agenta v klientovi

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

Tip

ID agenta najdete v adrese URL aplikace Copilot Studio při prohlížení agenta nebo ve sloupci Název v tabulce inventáře.

Počet agentů podle harnessu

Zobrazuje přehled agentů vytvořených pomocí harnessu GitHub Copilot, harnessu Copilot Chat nebo standardního harnessu.

V centru pro správu Power Platform můžete ve sloupci Harness v části Spravovat>Copilot Studio zobrazit harness agenta. Tento sloupec je pouze sloupec uživatelského rozhraní. Harness se zatím nevrací jako metadata agenta, takže jej tento dotaz odvozuje z polí, která inventář vrací: properties.isCLIAgent, properties.model a properties.createdIn. Jakmile properties.harness bude pole dostupné, můžete ho místo toho zadat přímo. Definice polí najdete v článku Microsoft Copilot Studio – schéma inventáře agenta.

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

Seznam agentů s jejich postroji

Vrátí jeden řádek pro každého agenta spolu s jeho harnessem, takže můžete vyhledat jednotlivé agenty a provádět s nimi akce, místo toho, abyste je pouze počítali. Odkomentujte řádek where, aby se vrátili pouze agenti vytvoření pomocí harnessu GitHub 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

Položky vytvořené za posledních 24 hodin

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

Dotazy konektoru (Preview)

Následující dotazy analyzují využití konektorů u všech typů prostředků zahrnutých v inventáři konektorů (Preview). Každý dotaz pracuje s polem properties.powerPlatformConnectors, které odesílají aplikace plátna, modelově řízené aplikace, cloudové toky, toky agentů, toky agentů workflow a agenti Copilot Studio.

Hlavní konektory používané napříč prostředky Power Platform

Uvádí konektory používané největším počtem různých zdrojů. Užitečné pro pochopení, které konektory jsou v tenantovi nejvíce využívané.

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

Rozložení počtu konektorů podle prostředku

Ukazuje, kolik prostředků používá 0, 1, 2 nebo více konektorů. Užitečné pro odhalení odlehlých hodnot složitosti.

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

Vyhledání všech prostředků, které používají konkrétní konektor

Nahraďte shared_sharepointonline konektorem, který chcete vyhledat. Tento dotaz je užitečný pro analýzu dopadu, pokud má konektor známý problém, je zastaralý nebo vyžaduje nové licencová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
| where tostring(connector.connectorId) == "shared_sharepointonline"
| project resourceName = tostring(properties.displayName),
          resourceId = name,
          resourceType = type,
          environmentId = tostring(properties.environmentId),
          operationsUsed = connector.operations

Využití konektoru podle prostředí

Zobrazí seznam všech konektorů používaných v každém prostředí s počtem různých prostředků, které ho používají. Tento seznam je užitečný pro pochopení vzorců adopce a pro rozhodování o zásadách ochrany před únikem informací (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

Související obsah

• Inventář Power Platform
• Referenční informace ke schématu inventáře Power Platform
• Rozhraní API Power Platform pro inventář
• Přehled služby Azure Resource Graph
• Přehled dotazovacího jazyka Kusto (KQL)