Power Platform envanteri örnek sorguları

Aşağıdaki örnek sorgular Azure Kaynak Grafı içindeki PowerPlatformResources tablosunda çalıştırılır. Bunlar kaynak sayma ve dağıtım, alan bulma, kaynak aramaları ve bağlayıcı kullanımı analizini kapsar. Power Platform envanteri hakkında genel bilgi için bkz. Power Platform envanteri. Şema ve alan başvurusu için bkz. Power Platform envanter şeması başvurusu.

Bu sorgular nasıl çalıştırılır

Bu sorgulardan herhangi birini Azure Kaynak Grafı arabirimlerinden çalıştırabilirsiniz. Adım adım yönergeler için aşağıdaki hızlı başlangıç kılavuzlarını inceleyin:

• Azure portalını kullanarak Kaynak Grafı sorgusunu çalıştırma
• Azure CLI kullanarak Kaynak Grafı sorgusunu çalıştırma
• Azure PowerShell kullanarak Kaynak Grafı sorgusunu çalıştırma
• REST API kullanarak Azure Kaynak Grafı sorgusunu çalıştırma

Sayımlar ve dağıtım

Tüm kaynakların toplam sayısı

PowerPlatformResources
| count

Kaynak türüne göre toplam sayımlar

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

Ortama göre sayımlar

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

Bölgeye göre sayımlar

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

Öğe sayısına göre en iyi sahipler

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

Kaynak aramaları

Tenant içinde tek bir ajan bulun

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

Tip

Aracıyı görüntülerken Copilot Studio URL'sinde veya stok tablosunun Ad sütununda aracının kimliğini bulabilirsiniz.

Ajanları harness'e göre sayma

GitHub Copilot harness, Copilot Chat harness veya Standard harness ile oluşturulan ajanların dökümünü gösterir.

Power Platform yönetim merkezinde, Yönet>Copilot Studio altında, bir temsilcinin koşumunu Harness sütununda görebilirsiniz. Bu sütun yalnızca kullanıcı arabirimi sütunudur. Harness henüz aracı meta verisi olarak döndürülmediği için bu sorgu, bunu envanterin döndürdüğü şu alanlardan türetir: properties.isCLIAgent, properties.model ve properties.createdIn. properties.harness alanı kullanılabilir hale geldiğinde, bunun yerine doğrudan sorgulayabilirsiniz. Alan tanımları için bkz. Microsoft Copilot Studio Aracısı envanter şeması.

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

Ajanları kendi harness'leriyle listeleme

Aracı başına bir satır döndürür ve bu sayede aracıları saymak yerine tek tek aracıları bulup üzerinde işlem yapabilirsiniz. Yalnızca GitHub Copilot harness’ı ile oluşturulan aracıları döndürmek için where satırındaki yorum işaretini kaldırın.

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

Son 24 saat içinde oluşturulan öğeler

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

Bağlayıcı sorguları (önizleme)

Aşağıdaki sorgular Bağlayıcı envanteri (önizleme) kapsamındaki kaynak türleri genelinde bağlayıcı kullanımını analiz ediyor. Her sorgu, tuval uygulamaları, model temelli uygulamalar, bulut akışları, ajan akışları, iş akışı ajan akışları ve Copilot Studio ajanları tarafından üretilen properties.powerPlatformConnectors dizisi üzerinde çalışır.

Power Platform kaynakları arasında kullanılan en iyi bağlayıcılar

En farklı kaynaklar tarafından kullanılan bağlayıcıları listeler. Kiracı genelinde benimsemeye hakim bağlayıcıları anlamak için kullanışlıdır.

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

Kaynak başına bağlayıcı sayısının dağılımı

Kaç kaynağın 0, 1, 2 veya daha fazla bağlayıcı kullandığını gösterir. Karmaşıklık açısından aykırı değerleri saptamak için kullanışlıdır.

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

Belirli bir bağlayıcıyı kullanan tüm kaynakları bulma

yerine shared_sharepointonline aramak istediğiniz bağlayıcıyı yazın. Bu sorgu, bağlayıcının bilinen bir sorunu olduğunda, kullanım dışı bırakıldığında veya yeni lisanslama gerektirdiğinde etki analizi için yararlıdır.

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

Ortama göre bağlayıcı kullanımı

Her ortamda kullanılan her bağlayıcıyı, kullanan farklı kaynakların sayısıyla birlikte listeler. Bu liste benimseme desenlerini anlamak ve DLP ilke kararlarını bilgilendirmek için kullanışlıdır.

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

İlgili içerik

• Power Platform envanteri
• Power Platform envanter şema referansı
• Power Platform envanter API'si
• Azure Kaynak Grafı'ne genel bakış
• Kusto Sorgu Dili'ne (KQL) genel bakış