Mulai Cepat: Menjalankan kueri Resource Graph pertama Anda menggunakan Azure PowerShell

Artikel
03/10/2024

Langkah pertama untuk menggunakan Azure Resource Graph adalah memeriksa apakah modul untuk Azure PowerShell telah dipasang. Panduan mulai cepat ini memandu Anda melalui proses penambahan modul ke penginstalan Azure PowerShell Anda.

Di akhir proses ini, Anda akan menambahkan modul ke penginstalan Azure PowerShell pilihan Anda dan menjalankan kueri Resource Graph pertama Anda.

Prasyarat

Jika Anda tidak memiliki langganan Azure, buat akun gratis sebelum Anda memulai.

Azure Cloud Shell

Azure meng-hosting Azure Cloud Shell, lingkungan shell interaktif yang dapat Anda gunakan melalui browser. Anda dapat menggunakan Bash atau PowerShell dengan Cloud Shell untuk bekerja dengan layanan Azure. Anda dapat menggunakan perintah Cloud Shell yang telah diinstal sebelumnya untuk menjalankan kode dalam artikel ini tanpa harus menginstal apa-apa di lingkungan lokal Anda.

Untuk memulai Azure Cloud Shell:

Opsi	Contoh/Tautan
Pilih Coba di pojok kanan atas blok kode atau perintah. Memilih Coba tidak otomatis menyalin kode atau perintah ke Cloud Shell.
Buka https://shell.azure.com, atau pilih tombol Luncurkan Cloud Shell untuk membuka Cloud Shell di browser Anda.
Pilih tombol Cloud Shell pada bilah menu di kanan atas di portal Microsoft Azure.

Untuk menggunakan Azure Cloud Shell:

Mulai Cloud Shell.
Pilih tombol Salin pada blok kode (atau blok perintah) untuk menyalin kode atau perintah.
Tempel kode atau perintah ke dalam sesi Cloud Shell dengan memilih Ctrl+Shift+V di Windows dan Linux, atau dengan memilih Cmd+Shift+V di macOS.
Pilih Masukkan untuk menjalankan kode atau perintah.

Menambahkan modul Resource Graph

Untuk mengaktifkan Azure PowerShell guna mengkueri Azure Resource Graph, modul harus ditambahkan. Modul ini dapat digunakan dengan PowerShell yang dipasang secara lokal, dengan Azure Cloud Shell, atau dengan gambar PowerShell Docker.

Persyaratan dasar

Modul Azure Resource Graph memerlukan perangkat lunak berikut:

Azure PowerShell 1.0.0 atau lebih tinggi. Jika belum diinstal, ikuti petunjuk ini.
PowerShellGet 2.0.1 atau versi lebih tinggi. Jika belum diinstal atau diperbarui, ikuti petunjuk ini.

Menginstal modul

Modul Resource Graph untuk PowerShell adalah Az.ResourceGraph.

Dari dialog permintaan PowerShell administratif, jalankan perintah berikut:

# Install the Resource Graph module from PowerShell Gallery
Install-Module -Name Az.ResourceGraph

Validasi bahwa modul telah diimpor dan setidaknya menggunakan versi 0.11.0:

# Get a list of commands for the imported Az.ResourceGraph module
Get-Command -Module 'Az.ResourceGraph' -CommandType 'Cmdlet'

Menjalankan kueri Resource Graph pertama Anda

Setelah modul Azure PowerShell ditambahkan ke lingkungan pilihan Anda, inilah saatnya untuk mencoba kueri Resource Graph berdasarkan penyewa sederhana. Kueri mengembalikan lima sumber daya Azure pertama dengan Nama dan Jenis Sumber Daya dari setiap sumber daya. Untuk membuat kueri menurut grup manajemen atau langganan, gunakan parameter -ManagementGroup atau -Subscription.

Jalankan kueri Azure Resource Graph pertama Anda menggunakan cmdlet Search-AzGraph:
```
# Login first with Connect-AzAccount if not using Cloud Shell

# Run Azure Resource Graph query
Search-AzGraph -Query 'Resources | project name, type | limit 5'
```
Catatan

Karena contoh kueri ini tidak menyediakan pengubah urutan seperti order by, menjalankan kueri ini beberapa kali kemungkinan akan menghasilkan set sumber daya yang berbeda untuk setiap permintaan.
Perbarui kueri ke properti order byNama:
```
# Run Azure Resource Graph query with 'order by'
Search-AzGraph -Query 'Resources | project name, type | limit 5 | order by name asc'
```
Catatan

Sama seperti kueri pertama, menjalankan kueri ini beberapa kali kemungkinan akan menghasilkan kumpulan sumber daya yang berbeda untuk setiap permintaan. Urutan perintah kueri adalah hal yang penting. Dalam contoh ini, order by muncul setelah limit. Urutan perintah ini pertama-tama membatasi hasil kueri dan kemudian mengurutkannya.

Perbarui kueri ke properti order byNama terlebih dahulu, lalu limit ke lima hasil teratas:

# Store the query in a variable
$query = 'Resources | project name, type | order by name asc | limit 5'

# Run Azure Resource Graph query with `order by` first, then with `limit`
Search-AzGraph -Query $query

Ketika kueri akhir dijalankan beberapa kali, dengan asumsi bahwa tidak ada yang berubah di lingkungan Anda, hasil yang ditampilkan konsisten dan diurutkan berdasarkan properti Nama, tetapi masih terbatas pada lima hasil teratas.

Catatan

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

Membersihkan sumber daya

Jika Anda ingin menghapus modul Resource Graph dari lingkungan Azure PowerShell Anda, Anda dapat melakukannya dengan menggunakan perintah berikut:

# Remove the Resource Graph module from the current session
Remove-Module -Name 'Az.ResourceGraph'

# Uninstall the Resource Graph module from the environment
Uninstall-Module -Name 'Az.ResourceGraph'

Catatan

Hal ini tidak menghapus file modul yang diunduh sebelumnya. Itu hanya menghapusnya dari sesi PowerShell yang sedang berjalan.

Langkah berikutnya

Dalam panduan memulai ini, Anda telah menambahkan modul Resource Graph ke lingkungan Azure PowerShell Anda dan menjalankan kueri pertama Anda. Untuk mempelajari selengkapnya tentang bahasa Resource Graph, lanjutkan ke halaman detail bahasa kueri.

Mendapatkan informasi selengkapnya tentang bahasa kueri