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

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 pun di lingkungan lokal Anda.

Untuk memulai Azure Cloud Shell:

Opsi Contoh/Tautan
Harap pilih Coba di sudut kanan atas blok kode atau perintah. Memilih Coba tidak akan menyalin kode atau perintah ke Cloud Shell secara otomatis. Cuplikan layar yang menunjukkan contoh Try It for Azure Cloud Shell.
Buka https://shell.azure.com, atau pilih tombol Luncurkan Cloud Shell untuk membuka Cloud Shell di browser Anda. Cuplikan layar yang menunjukkan cara meluncurkan Cloud Shell di jendela baru.
Pilih tombol Cloud Shell pada bilah menu di kanan atas di portal Microsoft Azure. Cuplikan layar yang menunjukkan tombol Cloud Shell di portal Azure

Untuk mulai menggunakan Azure Cloud Shell:

  1. Mulai Cloud Shell.

  2. Harap pilih tombol Salin pada blok kode (atau blok perintah) untuk menyalin kode atau perintah.

  3. Tempelkan kode atau perintah ke dalam sesi Cloud Shell dengan memilih Ctrl+Shift+V di Windows dan Linux, ataupun dengan memilih Cmd+Shift+V di macOS.

  4. Pilih Masukkan untuk menjalankan kode atau perintah.

Menambahkan modul Resource Graph

Untuk mengaktifkan Azure PowerShell untuk 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 terpasang, ikuti petunjuk ini.

  • PowerShellGet 2.0.1 atau versi lebih tinggi. Jika belum diinstal atau diperbarui, ikuti petunjuk ini.

Memasang modul

Modul Resource Graph untuk PowerShell adalah Az.ResourceGraph.

  1. Dari dialog permintaan PowerShell administratif, jalankan perintah berikut:

    # Install the Resource Graph module from PowerShell Gallery
    Install-Module -Name Az.ResourceGraph
    
  2. 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. Kuerinya menampilkan lima sumber daya Azure pertama dengan Nama dan Jenis Sumber Daya setiap sumber daya. Untuk membuat kueri menurut grup manajemen atau langganan, gunakan parameter -ManagementGroup atau -Subscription.

  1. 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 pengurutan seperti order by, menjalankan kueri ini beberapa kali kemungkinan akan menghasilkan kumpulan sumber daya yang berbeda per permintaan.

  2. 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 per permintaan. Urutan perintah kueri adalah hal yang penting. Dalam contoh ini, order by muncul setelah limit. Urutan perintah ini terlebih dahulu membatasi hasil kueri lalu mengurutkannya.

  3. 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 lebih lanjut bahasa pemrogram Resource Graph, lanjutkan ke halaman detail bahasa kueri.