Kueri sampel inventaris Power Platform

Contoh kueri berikut berjalan terhadap tabel PowerPlatformResources dalam tabel Azure Resource Graph. Cakupannya meliputi penghitungan dan distribusi sumber daya, penemuan bidang, pencarian sumber daya, dan analisis penggunaan konektor. Untuk gambaran umum inventarit Power Platform, lihat Inventarit Power Platform. Untuk referensi skema dan bidang, lihat Referensi skema inventori Power Platform.

Cara menjalankan kueri ini

Anda dapat menjalankan salah satu kueri ini dari antarmuka Azure Resource Graph. Untuk instruksi langkah demi langkah, lihat panduan mulai cepat berikut ini:

• Menjalankan kueri Resource Graph menggunakan portal Azure
• Menjalankan kueri Resource Graph menggunakan Azure CLI
• Menjalankan kueri Resource Graph menggunakan Azure PowerShell
• Menjalankan kueri Azure Resource Graph menggunakan REST API

Jumlah dan distribusi

Jumlah total semua sumber daya

PowerPlatformResources
| count

Jumlah total menurut jenis sumber daya

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

Jumlah berdasarkan lingkungan

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

Hitungan menurut wilayah

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

Pemilik teratas menurut jumlah item

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

Pencarian sumber daya

Menemukan agen tunggal di penyewa

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

Tip

Anda dapat menemukan ID agen di URL Copilot Studio saat melihat agen, atau di kolom Nama tabel inventori.

Jumlah agen berdasarkan harness

Menunjukkan perincian agen yang dibuat dengan harness Microsoft Copilot, Copilot Chat harness, atau Standard harness.

Anda dapat melihat harness milik agen di kolom Harness di pusat admin Power Platform, di bagian Kelola>Copilot Studio. Kolom tersebut hanyalah kolom antarmuka pengguna. Harness belum dikembalikan sebagai metadata agen, sehingga kueri ini memperolehnya dari bidang yang dikembalikan inventaris: properties.isCLIAgent, properties.model, dan properties.createdIn. Ketika bidang properties.harness tersedia, Anda dapat melakukan kueri langsung padanya sebagai gantinya. Untuk definisi bidang, lihat skema inventaris Agen Microsoft Copilot Studio.

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

Daftarkan agen beserta harness-nya

Mengembalikan satu baris untuk setiap agen beserta harness-nya agar Anda dapat menemukan dan mengambil tindakan terhadap masing-masing agen, alih-alih hanya menghitungnya. Batalkan komentar pada baris where untuk hanya mengembalikan agen yang dibangun dengan harness 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

Item yang dibuat dalam 24 jam terakhir

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

kueri Power Pages (pratinjau)

Power Pages kueri menggunakan microsoft.powerpages/sites jenis sumber daya. Power Pages inventaris hanya tersedia untuk administrator Global, administrator Power Platform, dan administrator Dynamics 365.

Daftar situs Power Pages

Kueri ini mengembalikan inventarisasi seluruh tenant atas situs Power Pages beserta lingkungan, pemilik, serta tanggal pembuatan dan modifikasinya.

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

Menghitung situs Power Pages menurut lingkungan

Kueri ini menunjukkan lingkungan yang memiliki situs Power Pages terbanyak.

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

Menghitung situs Power Pages menurut pemilik

Kueri ini memperlihatkan pemilik yang terkait dengan jumlah situs Power Pages terbesar untuk mendukung tinjauan kepemilikan dan perencanaan kelangsungan bisnis.

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 situs dengan akses anonim diaktifkan

Kueri ini menemukan situs yang metadata inventarisasinya menunjukkan bahwa akses anonim diizinkan.

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

Situs Power Pages yang baru dibuat

Kueri ini mengembalikan situs yang dibuat selama 30 hari terakhir. Sesuaikan interval sesuai kebutuhan.

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

Situs Power Pages yang menggunakan domain kustom

Kueri ini mengembalikan situs yang metadata inventarisasinya menyertakan URL situs kustom.

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 dengan sumber daya Power Platform lainnya

Kueri ini meringkas jumlah sumber daya berdasarkan jenis dan lingkungan di seluruh Power Platform, termasuk situs Power Pages. Catatan tanpa ID lingkungan dikecualikan.

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

Kueri konektor

Kueri berikut menganalisis penggunaan konektor di seluruh jenis sumber daya yang dicakup oleh inventaris Konektor. Setiap kueri beroperasi pada array yang dipancarkan properties.powerPlatformConnectors oleh aplikasi kanvas, aplikasi berbasis model, aplikasi yang dibangun dalam runtime terkelola Copilot, alur cloud, alur agen, alur agen alur kerja, agen Copilot Studio pada Harness Standar atau Microsoft Copilot harness, dan agen yang dibuat di Microsoft 365 Copilot Agent Builder. Aplikasi yang dibuat di runtime terkelola Copilot menggunakan jenis microsoft.powerapps/apps dengan subjenis microsoftApp. Kueri mengecualikan aplikasi App Builder, yang menggunakan jenis yang sama tetapi tidak mengeluarkan data konektor.

Konektor teratas yang digunakan di seluruh sumber daya Power Platform

Mencantumkan konektor yang digunakan oleh sumber daya yang paling berbeda. Berguna untuk memahami konektor mana yang mendominasi adopsi di seluruh tenant.

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

Distribusi jumlah konektor per sumber daya

Memperlihatkan berapa banyak sumber daya yang menggunakan konektor 0, 1, 2, atau lebih. Berguna untuk mengidentifikasi faktor luar kompleksitas.

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

Menemukan semua sumber daya yang menggunakan konektor tertentu

Ganti shared_sharepointonline dengan konektor yang ingin Anda cari. Kueri ini berguna untuk analisis dampak ketika konektor memiliki masalah yang diketahui, tidak digunakan lagi, atau memerlukan lisensi baru.

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

Penggunaan konektor menurut lingkungan

Mencantumkan setiap konektor yang digunakan di setiap lingkungan, dengan jumlah sumber daya berbeda yang menggunakannya. Daftar ini berguna untuk memahami pola adopsi dan menginformasikan keputusan kebijakan 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

Konten terkait

• Inventaris Power Platform
• Referensi skema inventaris Power Platform
• API inventori Power Platform
• gambaran umum Azure Resource Graph
• Gambaran umum Bahasa Kueri Kusto (KQL)