Hızlı başlangıç: Azure PowerShell kullanarak ilk kaynak grafik sorgunuzu çalıştırın

Azure Kaynak Grafiği’ni kullanmada ilk adım, Azure PowerShell modülünün yüklenip yüklenmediğini denetlemektir. Bu hızlı başlangıç, Azure PowerShell yüklemenize modül ekleme işlemini incelemenizi sağlar.

Bu işlemin sonunda, modülü seçtiğiniz Azure PowerShell yüklemesine eklemiş ve ilk Kaynak Grafiği sorgunuzu çalıştırmış olacaksınız.

Önkoşullar

Azure aboneliğiniz yoksa başlamadan önce ücretsiz bir hesap oluşturun.

Azure Cloud Shell kullanma

Azure, tarayıcınız aracılığıyla kullanabileceğiniz etkileşimli bir kabuk ortamı olan Azure Cloud Shell’i barındırır. Azure hizmetleriyle çalışmak için Cloud Shell ile Bash veya PowerShell kullanabilirsiniz. Bu makaledeki kodu, yerel ortamınıza herhangi bir şey yüklemeye gerek kalmadan çalıştırmak için Cloud Shell’in önceden yüklenmiş komutlarını kullanabilirsiniz.

Azure Cloud Shell’i başlatmak için:

Seçenek Örnek/Bağlantı
Kod bloğunun sağ üst köşesindeki Deneyin’i seçin. Deneyin seçeneği belirlendiğinde, kod otomatik olarak Cloud Shell’e kopyalanmaz. Azure Cloud Shell için Deneyin örneği
Cloud Shell’i tarayıcınızda açmak için https://shell.azure.com bölümüne gidin veya Cloud Shell’i Başlat düğmesini seçin. Cloud Shell’i yeni bir pencerede başlatma
Azure portalın sağ üst köşesindeki menü çubuğunda yer alan Cloud Shell düğmesini seçin. Azure portaldaki Cloud Shell düğmesi

Azure Cloud Shell’de bu makaledeki kodu çalıştırmak için:

  1. Cloud Shell’i başlatın.

  2. Kodu kopyalamak için kod bloğunda Kopyala düğmesini seçin.

  3. Windows ve Linux sisteminde Ctrl+Shift+V tuşlarını kullanarak veya macOS’de Cmd+Shift+V tuşlarını kullanarak kodu Cloud Shell oturumuna yapıştırın.

  4. Kodu çalıştırmak için Enter tuşuna basın.

Kaynak Grafiği modülü ekleme

Azure PowerShell’in Azure Kaynak Grafiği’ni sorgulamasını etkinleştirmek için modül eklenmelidir. Bu modül, Azure Cloud ShellIle veya PowerShell Docker görüntüsüIle yerel olarak yüklü PowerShell ile kullanılabilir.

Temel gereksinimler

Azure Kaynak Grafiği modülü aşağıdaki yazılımı gerektirir:

  • Azure PowerShell 1.0.0 veya üzeri. Henüz yüklenmiş değilse, bu yönergeleri izleyin.

  • PowerShellGet 2.0.1 veya üzeri. Henüz yüklenmiş ve güncellenmiş değilse, bu yönergeleri izleyin.

Modülü yükler

PowerShell için kaynak Graph modülü az. ResourceGraph' dir.

  1. Bir Yönetim PowerShell isteminde aşağıdaki komutu çalıştırın:

    # Install the Resource Graph module from PowerShell Gallery
    Install-Module -Name Az.ResourceGraph
    
  2. Modülün içeri aktarıldığını ve en az sürüm olduğunu doğrulayın 0.10.0 :

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

İlk Kaynak Grafiği sorgunuzu çalıştırma

Azure PowerShell modülünün seçtiğiniz ortamınıza eklenmesiyle birlikte şimdi basit bir Kaynak Grafiği sorgusu denemenin zamanı geldi. Sorgu, ilk beş Azure kaynağını her bir kaynağın adı ve kaynak türü ile döndürür.

  1. Search-AzGraph cmdlet’ini kullanarak İlk Azure Kaynak Grafiği sorgunuzu çalıştırın:

    # Login first with Connect-AzAccount if not using Cloud Shell
    
    # Run Azure Resource Graph query
    (Search-AzGraph -Query 'Resources | project name, type | limit 5').Data
    

    Not

    Bu sorgu örneği gibi bir sıralama değiştiricisi sağlamadığından order by , bu sorguyu birden çok kez çalıştırmak, istek başına farklı bir kaynak kümesi sunmamasından kaynaklanıyor olabilir.

  2. Sorguyu order byAd özelliğine güncelleştirin:

    # Run Azure Resource Graph query with 'order by'
    (Search-AzGraph -Query 'Resources | project name, type | limit 5 | order by name asc').Data
    

    Not

    İlk sorguda olduğu gibi, bu sorguyu birden çok kez çalıştırmak, muhtemelen istek başına farklı bir kaynak kümesi sunacaktır. Sorgu komutlarının düzeni önemlidir. Bu örnekte order by, limit’den sonra gelmektedir. Bu komut sırası ilk olarak sorgu sonuçlarını kısıtlar ve sonra sıralar.

  3. Sorguyu ilk önce order byAd özelliğine ve ardından limit’e en iyi beş sonuca güncelleştirin:

    # Run Azure Resource Graph query with `order by` first, then with `limit`
    (Search-AzGraph -Query 'Resources | project name, type | order by name asc | limit 5').Data
    

Son sorgu birkaç kez çalıştırıldığında, ortamınızdaki hiçbir şeyin değişmediği kabul edildiğinde döndürülen sonuçlar tutarlı ve ad özelliğine göre sıralanır, ancak yine de en üstteki beş sonuçla sınırlıdır.

Not

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

Kaynakları temizleme

Kaynak Grafiği modülünü Azure PowerShell ortamınızdan kaldırmak isterseniz, aşağıdaki komutu kullanarak bunu yapabilirsiniz:

# 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'

Not

Bu, daha önce indirilen modül dosyasını silmez. Yalnızca çalışan PowerShell ortamından kaldırır.

Sonraki adımlar

Bu hızlı başlangıçta, kaynak Graph modülünü Azure PowerShell ortamınıza eklediniz ve ilk sorgunuzu çalıştırdık. Kaynak grafik dili hakkında daha fazla bilgi edinmek için sorgu dili ayrıntıları sayfasına ilerleyin.