Mulai cepat: Menjalankan kueri Resource Graph menggunakan Azure PowerShell

  • Artikel

Mulai cepat ini menjelaskan cara menjalankan kueri Azure Resource Graph menggunakan Az.ResourceGraph modul untuk Azure PowerShell. Artikel ini juga memperlihatkan cara mengurutkan (mengurutkan) dan membatasi hasil kueri. Anda bisa menjalankan kueri untuk sumber daya di penyewa, grup manajemen, atau langganan Anda. Setelah selesai, Anda dapat menghapus modul.

Prasyarat

Menginstal modul

Az.ResourceGraph Instal modul sehingga Anda dapat menggunakan Azure PowerShell untuk menjalankan kueri Azure Resource Graph. Modul Azure Resource Graph memerlukan PowerShellGet versi 2.0.1 atau yang lebih tinggi. Jika Anda menginstal versi terbaru PowerShell dan Azure PowerShell, Anda sudah memiliki versi yang diperlukan.

  1. Verifikasi versi PowerShellGet Anda:

    Get-Module -Name PowerShellGet

    Jika Anda perlu memperbarui, buka PowerShellGet.

  2. Instal modul:

    Install-Module -Name Az.ResourceGraph -Repository PSGallery -Scope CurrentUser

    Perintah menginstal modul dalam CurrentUser cakupan. Jika Anda perlu menginstal dalam AllUsers cakupan, jalankan penginstalan dari sesi PowerShell administratif.

  3. Verifikasi bahwa modul telah diinstal:

    Get-Command -Module Az.ResourceGraph -CommandType Cmdlet

    Perintah menampilkan Search-AzGraph versi cmdlet dan memuat modul ke sesi PowerShell Anda.

Hubungkan ke Azure

Dari sesi terminal Visual Studio Code, sambungkan ke Azure. Jika Anda memiliki lebih dari satu langganan, jalankan perintah untuk mengatur konteks ke langganan Anda. Ganti <subscriptionID> dengan ID langganan Azure Anda.

Connect-AzAccount

# Run these commands if you have multiple subscriptions
Get-AzSubScription
Set-AzContext -Subscription <subscriptionID>

Menjalankan kueri

Setelah modul ditambahkan ke lingkungan Anda, Anda dapat menjalankan kueri berbasis penyewa. Kueri dalam contoh ini mengembalikan lima sumber daya Azure dengan name dan type dari setiap sumber daya. Untuk membuat kueri menurut grup manajemen atau langganan, gunakan parameter -ManagementGroup atau -Subscription.

  1. Jalankan kueri Azure Resource Graph menggunakan Search-AzGraph cmdlet:

    Search-AzGraph -Query 'Resources | project name, type | limit 5'

    Contoh kueri ini tidak menggunakan pengubah pengurutan seperti order by. Jika Anda menjalankan kueri beberapa kali, kueri mungkin menghasilkan sekumpulan sumber daya yang berbeda untuk setiap permintaan.

  2. Perbarui kueri ke order byname properti :

    Search-AzGraph -Query 'Resources | project name, type | limit 5 | order by name asc'

    Seperti kueri sebelumnya, jika Anda menjalankan kueri ini beberapa kali mungkin menghasilkan sekumpulan sumber daya yang berbeda untuk setiap permintaan. Urutan perintah kueri adalah hal yang penting. Dalam contoh ini, order by muncul setelah limit. Kueri membatasi hasil ke lima sumber daya lalu mengurutkan hasil tersebut berdasarkan nama.

  3. Perbarui kueri ke order byname properti lalu limit output ke lima hasil:

    Search-AzGraph -Query 'Resources | project name, type | order by name asc | limit 5'

    Jika kueri ini dijalankan beberapa kali tanpa perubahan pada lingkungan Anda, hasilnya konsisten dan diurutkan oleh properti, tetapi masih terbatas pada name lima hasil. Kueri mengurutkan hasil berdasarkan nama lalu membatasi output ke lima sumber daya.

Jika kueri tidak mengembalikan hasil dari langganan yang sudah Anda akses, perhatikan bahwa Search-AzGraph cmdlet default ke langganan dalam konteks default. Untuk melihat daftar ID langganan yang merupakan bagian dari konteks default, jalankan ini (Get-AzContext).Account.ExtendedProperties.Subscriptions Jika Anda ingin mencari di semua langganan yang dapat Anda akses, atur PSDefaultParameterValues untuk Search-AzGraph cmdlet dengan menjalankan $PSDefaultParameterValues=@{"Search-AzGraph:Subscription"= $(Get-AzSubscription).ID}

Membersihkan sumber daya

Untuk menghapus Az.ResourceGraph modul dari sesi PowerShell Anda, jalankan perintah berikut:

Remove-Module -Name Az.ResourceGraph

Untuk menghapus instalan Az.ResourceGraph modul dari komputer Anda, jalankan perintah berikut:

Uninstall-Module -Name Az.ResourceGraph

Pesan mungkin ditampilkan bahwa modul Az.ResourceGraph saat ini sedang digunakan. Jika demikian, Anda perlu mematikan sesi PowerShell dan memulai sesi baru. Kemudian jalankan perintah untuk menghapus instalan modul dari komputer Anda.

Untuk keluar dari sesi Azure PowerShell Anda:

Disconnect-AzAccount

Langkah berikutnya

Dalam mulai cepat ini, Anda menambahkan modul Resource Graph ke lingkungan Azure PowerShell Anda dan menjalankan kueri. Untuk mempelajari selengkapnya, buka halaman detail bahasa kueri.

Memahami bahasa kueri Azure Resource Graph