Aracılığıyla paylaş


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

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. Modül, Azure PowerShell'in en son sürümüne eklenmiştir ve Kaynak Grafı için cmdlet'ler ekler.

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.

Önkoşullar

Modülü yükleme

PowerShell ve Azure PowerShell'in en son sürümlerini yüklediyseniz modülü ve gerekli PowerShellGet sürümünü zaten Az.ResourceGraph yüklemişsinizdir.

İsteğe bağlı modül yüklemesi

Azure PowerShell kullanarak Azure Kaynak Grafı sorgularını çalıştırabilmeniz için modülü yüklemek Az.ResourceGraph için aşağıdaki adımları kullanın. Azure Kaynak Grafı modülü PowerShellGet sürüm 2.0.1 veya üzerini gerektirir.

  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 by name 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 PSDefaultParameterValues Search-AzGraph ayarlayın $PSDefaultParameterValues=@{"Search-AzGraph:Subscription"= $(Get-AzSubscription).ID}

Kaynakları temizleme

Azure PowerShell oturumunuzun oturumunu kapatmak için:

Disconnect-AzAccount

İsteğe bağlı temizleme adımları

Azure PowerShell'in en son sürümünü yüklediyseniz modül Az.ResourceGraph eklenir ve kaldırılmamalıdır. Modülü el ile yüklediyseniz Az.ResourceGraph ve modülü kaldırmak istiyorsanız aşağıdaki adımlar isteğe bağlıdır.

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.

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.