Aracılığıyla paylaş


Azure CLI'yi kullanmaya başlama

Azure Komut Satırı Arabirimi'ne (CLI) hoş geldiniz! Bu makalede CLI tanıtılarak yaygın görevleri tamamlamanıza yardımcı olur.

Azure Cloud Shell'i yükleme veya çalıştırma

Azure CLI'yi kullanmayı öğrenmenin en kolay yolu, tarayıcınız aracılığıyla Azure Cloud Shell'de bir Bash ortamı çalıştırmaktır. Cloud Shell hakkında bilgi edinmek için bkz. Azure Cloud Shell'de Bash için Hızlı Başlangıç.

Azure CLI'yı yüklemeye hazır olduğunuzda Windows, Linux, macOS ve Docker kapsayıcısı yükleme yönergelerine bakın. Azure klasik dağıtım modelini kullanıyorsanız Azure klasik CLI'yi yükleyin.

komutunu çalıştırarak az --versionsürümünüzü denetleyin. Azure Cloud Shell'de her zaman Azure CLI'nin en son sürümü önceden yüklenmiş olarak bulunur.

az version

Azure CLI'da oturum açma

Yerel yüklemeyle azure CLI komutlarını kullanmadan önce az login ile oturum açmanız gerekir.

  1. az login komutunu çalıştırın.

    az login
    

    Azure CLI varsayılan tarayıcınızı açabiliyorsa yetkilendirme kodu akışını başlatır ve azure oturum açma sayfasını yüklemek için varsayılan tarayıcıyı açar.

    Aksi takdirde, cihaz kodu akışını başlatır ve adresinde https://aka.ms/deviceloginbir tarayıcı sayfası açmanız için size talimat verir. Ardından terminalinizde görüntülenen kodu girin.

    Kullanılabilir web tarayıcısı yoksa veya web tarayıcısı açılamıyorsa az login --use-device-code ile cihaz kodu akışını zorlayabilirsiniz.

  2. Tarayıcıda hesabınızın kimlik bilgileriyle oturum açın.

Oturum açtıktan sonra Azure hesabınızla ilişkili aboneliklerin listesini alırsınız. ile isDefault: true abonelik bilgileri, oturum açtıktan sonra şu anda etkinleştirilmiş olan aboneliktir. Başka bir abonelik seçmek için, istenen hesabın abonelik kimliğiyle az account set komutunu kullanın. Abonelik seçimi hakkında daha fazla bilgi için bkz . Azure aboneliklerini yönetme.

Azure CLI ile oturum açma bölümünde ayrıntılı bir şekilde ele alınan etkileşimsiz olarak oturum açma yöntemleri mevcuttur.

Komutları bulma

Azure CLI komutları komut grupları olarak düzenlenir. Her grup, Azure hizmetinin bir alanını temsil eder. Komut gruplarını bulmak için iki seçenek vardır:

  • az find komutunu kullanın. Örneğin, vm içeren komut adlarını aramak için şu komutu kullanın:

    az find vm
    
  • Başvuru grubu içindeki --help alt grupların tam listesini almak için bağımsız değişkenini kullanın. Bu örnek, sanal makineler için tüm alt grupları döndürür:

    az vm --help
    

    Kısalık için satır atlanmış örnek çıktı aşağıda verilmiştir:

    Subgroups:
      application            : Manage applications for VM.
      availability-set       : Group resources into availability sets.
      boot-diagnostics       : Troubleshoot the startup of an Azure Virtual Machine.
      ...
    

    Sanal makineleri kullanılabilirlik kümelerine gruplandırmak için Azure CLI komutlarını bulan başka bir örnek aşağıda verilmiştiraz vm:

    az vm availability-set --help
    

    Başvuru komutu için parametre listelerini ve komut örneklerini almak için de kullanın--help.

    az vm create --help
    

    Kısalık için satır atlanmış örnek çıktı aşağıda verilmiştir:

    Arguments
        --name  [Required] : Name of the virtual machine.
        ...
    Authentication Arguments
        --admin-password   : Password for the VM if authentication type is 'Password'.
        --admin-username   : Username for the VM...
        ...
    Managed Service Identity Arguments
        ...
    Examples
        Create a VM from a custom managed image.
          az vm create -g MyResourceGroup -n MyVm --image MyImage
        ...
    
  • Tüm komut gruplarını alfabetik olarak listeleyen A-Z başvuru dizinini kullanın.

Yayımlanan örnekleri ve makaleleri bulma

Test edilmiş yayımlanmış örnekleri görerek Azure CLI söz dizimini öğrenmek isterseniz makale içeriğinin iki dizini vardır:

Sekme tamamlamayı kullanma

CLI, Bash ortamındaki komutlar için tam sekme tamamlamaya sahiptir. PowerShell ortamında sekme tamamlamayı etkinleştirmek için bkz . PowerShell'de sekme tamamlamayı etkinleştirme.

Genel olarak kullanılabilir bağımsız değişkenlere dikkat edin

Çoğu komut için kullanılabilen bazı bağımsız değişkenler vardır.

  • --help, komutlar ve bunların bağımsız değişkenleri ile ilgili CLI başvuru bilgilerini yazdırır ve kullanılabilen alt grupları ve komutları listeler.

  • --output, çıkış biçimini değiştirir. Kullanılabilir çıkış biçimleri şunlardır: json, (renklendirilmiş JSON), tsv (Sekmeyle Ayrılmış Değerler), table (insan tarafından okunabilir ASCII tabloları) ve yamljsonc . Varsayılan olarak CLI, json çıkışı sağlar. Kullanılabilir çıkış biçimleri hakkında daha fazla bilgi edinmek için bkz. Azure CLI için çıkış biçimleri.

  • --query, Azure hizmetlerinden döndürülen çıkışı filtrelemek için JMESPath sorgu dilini kullanır. Sorgular hakkında daha fazla bilgi edinmek için bkz . Azure CLI ile sorgu komutu sonuçları ve JMESPath öğreticisi.

  • --verbose, bir işlem sırasında Azure’da oluşturulan kaynaklar hakkındaki bilgileri ve diğer faydalı bilgileri yazdırır.

  • --debug, hata ayıklama amaçlarıyla kullanılan CLI işlemleri hakkında daha da fazla bilgi yazdırır. Hata bulursanız, hata raporu gönderirken --debug bayrağı ile oluşturulan çıkışı sağlayın. Örneğin, komutunun altında yürüttüğü REST API'yi ve hizmetten alınan yanıtı tanımlamak için kullanılabilir.

  • --subscription bir aboneliğin adı veya kimliğidir. Varsayılan aboneliğinizi ayarlama hakkında daha fazla bilgi için bkz . Azure CLI ile Azure aboneliklerini yönetme.

  • --only-show-errors komut çıktısındaki uyarıları bastırır ve yalnızca hataları gösterir.

Etkileşimli modu kullanma

CLI, otomatik olarak yardım bilgileri görüntüleyen ve alt komutların seçilmesini kolaylaştıran etkileşimli bir mod sunar. Etkileşimli moda az interactive komutu ile girersiniz.

az interactive

Etkileşimli mod hakkında daha fazla bilgi için bkz . Azure CLI'yi Etkileşimli Modda çalıştırma.

Ayrıca otomatik tamamlama ve işaretçiyle değişim belgeleri de dahil olmak üzere etkileşimli deneyim sunan bir Visual Studio Code eklentisi de mevcuttur.

Hızlı başlangıçlar ve öğreticilerle Azure CLI ile ilgili temel bilgileri öğrenin

Azure CLI'yı kullanmayı öğrenmek için Azure Depolama ile çalışırken size aşağıdaki becerileri öğreten ekleme öğreticimizi deneyin:

Not

Betiklerde ve Microsoft belge sitesinde Bash kabuğu için Azure CLI örnekleri yazılmıştır. Tek satırlık örneklerin çoğu herhangi bir platformda çalışır. PowerShell dahil olmak üzere diğer kabuklarda çalışmak için satır devamlılıkları (\), değişken ataması veya tırnak işaretleri içeren daha uzun örneklerin değiştirilmesi gerekir. Ortamlar arasındaki söz dizimi farklılıkları hakkında daha fazla bilgi için bkz . Bash, PowerShell ve Cmd arasındaki söz dizimi farklarını öğrenme.

Görüş bildirin

İyileştirme yapmamıza ve hataları gidermemize yardımcı olması açısından CLI ile ilgili geri bildirimlerinizi almaktan memnuniyet duyarız. GitHub'da bir sorun oluşturabilir veya CLI'nın yerleşik özelliklerini kullanarak az feedback komutuyla genel geri bildirim bırakabilirsiniz.

az feedback

Ayrıca bkz.