Mulai cepat: Menjalankan kueri Resource Graph menggunakan Azure PowerShell

Artikel
28/06/2024

Mulai cepat ini menjelaskan cara menjalankan kueri Azure Resource Graph menggunakan Az.ResourceGraph modul untuk Azure PowerShell. Modul ini disertakan dengan versi terbaru Azure PowerShell dan menambahkan cmdlet untuk Resource Graph.

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.

Prasyarat

Jika Anda tidak memiliki akun Azure, buat akun gratis sebelum memulai.
Versi terbaru PowerShell dan Azure PowerShell.
Visual Studio Code.

Menginstal modul

Jika Anda menginstal versi terbaru PowerShell dan Azure PowerShell, Anda sudah memiliki Az.ResourceGraph modul dan versi PowerShellGet yang diperlukan.

Penginstalan modul opsional

Gunakan langkah-langkah berikut untuk menginstal Az.ResourceGraph modul sehingga Anda bisa menggunakan Azure PowerShell untuk menjalankan kueri Azure Resource Graph. Modul Azure Resource Graph memerlukan PowerShellGet versi 2.0.1 atau yang lebih tinggi.

Verifikasi versi PowerShellGet Anda:
```
Get-Module -Name PowerShellGet
```
Jika Anda perlu memperbarui, buka PowerShellGet.
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.
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.

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.
Perbarui kueri ke order by name 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.
Perbarui kueri ke order by name 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 keluar dari sesi Azure PowerShell Anda:

Disconnect-AzAccount

Langkah-langkah pembersihan opsional

Jika Anda menginstal versi terbaru Azure PowerShell, Az.ResourceGraph modul disertakan dan tidak boleh dihapus. Langkah-langkah berikut bersifat opsional jika Anda melakukan penginstalan Az.ResourceGraph manual modul dan ingin menghapus modul.

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.

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

Bagikan melalui