Hızlı Başlangıç: Azure PowerShell kullanarak Kaynak Grafı sorgu çalıştırma

  • Makale

Bu hızlı başlangıçta, Azure PowerShell modülünü kullanarak bir Azure Kaynak Grafı sorgusunun nasıl çalıştırıldığı Az.ResourceGraph açıklanmaktadır. Makalede ayrıca sorgu sonuçlarını sıralama (sıralama) ve sınırlama da gösterilmektedir. Kiracınızdaki, yönetim gruplarınızdaki veya aboneliklerinizdeki kaynaklar için bir sorgu çalıştırabilirsiniz. İşiniz bittiğinde modülü kaldırabilirsiniz.

Önkoşullar

Modülü yükleme

Az.ResourceGraph Azure Kaynak Grafı sorgularını çalıştırmak için Azure PowerShell'i kullanabilmek için modülü yükleyin. Azure Kaynak Grafı modülü PowerShellGet sürüm 2.0.1 veya üzerini gerektirir. PowerShell ve Azure PowerShell'in en son sürümlerini yüklediyseniz, gerekli sürüme zaten sahipsinizdir.

  1. PowerShellGet sürümünüzü doğrulayın:

    Get-Module -Name PowerShellGet

    Güncelleştirmeniz gerekiyorsa PowerShellGet'e gidin.

  2. Modülü yükleyin:

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

    komutu, modülü CurrentUser kapsama yükler. Kapsamda yüklemeniz AllUsers gerekiyorsa, yüklemeyi bir yönetim PowerShell oturumundan çalıştırın.

  3. Modülün yüklendiğini doğrulayın:

    Get-Command -Module Az.ResourceGraph -CommandType Cmdlet

    komut cmdlet sürümünü görüntüler Search-AzGraph ve modülü PowerShell oturumunuza yükler.

Azure'a bağlanma

Visual Studio Code terminal oturumundan Azure'a bağlanın. Birden fazla aboneliğiniz varsa, aboneliğinize bağlam ayarlamak için komutları çalıştırın. <subscriptionID> öğesini Azure abonelik kimliğinizle değiştirin.

Connect-AzAccount

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

Sorgu çalıştırma

Modül ortamınıza eklendikten sonra kiracı tabanlı bir sorgu çalıştırabilirsiniz. Bu örnekteki sorgu, her kaynağın ve type değerini içeren name beş Azure kaynağı döndürür. Yönetim grubuna veya aboneliğe göre sorgulamak için veya -Subscription parametrelerini kullanın-ManagementGroup.

  1. cmdlet'ini Search-AzGraph kullanarak bir Azure Kaynak Grafı sorgusu çalıştırın:

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

    Bu sorgu örneği gibi order bybir sıralama değiştirici kullanmaz. Sorguyu birden çok kez çalıştırırsanız, her istek için farklı bir kaynak kümesi verebilir.

  2. Sorguyu order by şu özelliğe güncelleştirin name :

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

    Önceki sorguda olduğu gibi, bu sorguyu birden çok kez çalıştırırsanız her istek için farklı bir kaynak kümesi elde edebilirsiniz. Sorgu komutlarının düzeni önemlidir. Bu örnekte order by, limit’den sonra gelmektedir. Sorgu sonuçları beş kaynakla sınırlar ve ardından bu sonuçları ada göre sıralar.

  3. Sorguyu özelliğine order byname ve ardından limit çıkışı beş sonuçla güncelleştirin:

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

    Bu sorgu ortamınızda değişiklik yapılmadan birkaç kez çalıştırılırsa, sonuçlar özellik tarafından name tutarlı ve sıralı olur, ancak yine de beş sonuçla sınırlıdır. Sorgu sonuçları ada göre sıralar ve ardından çıkışı beş kaynakla sınırlar.

Sorgu zaten erişiminiz olan bir abonelikten sonuç döndürmezse, cmdlet'in varsayılan bağlamdaki abonelikler olarak varsayılan olduğunu Search-AzGraph unutmayın. Varsayılan bağlamın parçası olan abonelik kimliklerinin listesini görmek için bunu (Get-AzContext).Account.ExtendedProperties.Subscriptions çalıştırın Erişiminiz olan tüm aboneliklerde arama yapmak istiyorsanız komutunu çalıştırarak cmdlet'ini PSDefaultParameterValuesSearch-AzGraph ayarlayın $PSDefaultParameterValues=@{"Search-AzGraph:Subscription"= $(Get-AzSubscription).ID}

Kaynakları temizleme

Modülü PowerShell oturumunuzdan kaldırmak Az.ResourceGraph için aşağıdaki komutu çalıştırın:

Remove-Module -Name Az.ResourceGraph

Modülü bilgisayarınızdan kaldırmak Az.ResourceGraph için aşağıdaki komutu çalıştırın:

Uninstall-Module -Name Az.ResourceGraph

Az.ResourceGraph modülünün şu anda kullanımda olduğunu belirten bir ileti görüntülenebilir. Bu durumda PowerShell oturumunuzu kapatmanız ve yeni bir oturum başlatmanız gerekir. Ardından komutunu çalıştırarak modülü bilgisayarınızdan kaldırın.

Azure PowerShell oturumunuzun oturumunu kapatmak için:

Disconnect-AzAccount

Sonraki adımlar

Bu hızlı başlangıçta Azure PowerShell ortamınıza Kaynak Grafı modülünü eklediniz ve bir sorgu çalıştırmıştınız. Daha fazla bilgi edinmek için sorgu dili ayrıntıları sayfasına gidin.

Azure Kaynak Grafı sorgu dilini anlama