Azure CLI'yi kullanmaya başlama

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

Not

Betiklerde ve Microsoft belge sitesinde Azure CLI örnekleri bash kabuğu için yazılmıştır. Tek satırlı örnekler tüm platformlarda çalışır. Satır devamı (\) ya da değişken ataması içeren daha uzun örneklerin, PowerShell gibi diğer kabuklarda çalışması için değiştirilmesi gerekir.

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

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

CLI'yı yüklemeye hazır olduğunuzda yükleme yönergelerine bakın.

CLI'yi ilk kez yükledikten sonra komutunu çalıştırarak az --versionyüklü olup olmadığını ve doğru sürüme sahip olup olmadığını denetleyin.

Not

Azure klasik dağıtım modelini kullanıyorsanız Azure klasik CLI'yi yükleyin.

Azure CLI'da oturum açma

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

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

    az login
    

    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 bir tarayıcı sayfası https://aka.ms/devicelogin açmanızı ve terminalinizde görüntülenen kodu girmenizi söyler.

    Kullanılabilir web tarayıcısı yoksa veya web tarayıcısı açılamazsa 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 görürsünüz. ile isDefault: true abonelik bilgileri, oturum açtıktan sonra şu anda etkin olan aboneliktir. Başka bir abonelik seçmek için, geçiş yapmak için abonelik kimliğiyle az account set komutunu kullanın. Abonelik seçimi hakkında daha fazla bilgi için bkz. Birden çok Azure aboneliği kullanma.

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.

Sık kullanılan Azure CLI komutları

Bu tabloda, CLI’da kullanılan bazı yaygın komutlar ve onların başvuru belgelerinin bağlantıları listelenir.

Kaynak türü Azure CLI komut grubu
Kaynak grubu az group
Sanal makineler az vm
Depolama hesapları az storage account
Anahtar Kasası az keyvault
Web uygulamaları az webapp
SQL veritabanları az sql server
Cosmos DB az cosmosdb

Komutları bulma

Azure CLI komutları gruplarınkomutları olarak düzenlenir. Her grup bir Azure hizmetini temsil eder ve komutlar o hizmet üzerinde işlem yapar.

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

az find secret

Bir gruptaki komutların ve alt grupların tam listesini almak için --help bağımsız değişkenini kullanın. Örneğin, Ağ Güvenlik Grupları (NSG’ler) ile çalışmaya yönelik CLI komutlarını bulmak için:

az network nsg --help

CLI, bash kabuğu altında komutlar için tam sekme tamamlama işlevine sahiptir.

Genel olarak kullanılabilen bağımsız değişkenler

Her 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 komut sonuçlarını sorgulama 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.

Etkileşimli mod

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 bilgi edinmek için bkz. Azure CLI Etkileşimli Modu.

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 öğreticiler ile CLI temellerini öğrenme

Azure CLI'yı kullanmayı öğrenmek için, sanal makineleri ayarlamaya ve CLI'nın gücünü kullanarak Azure kaynaklarını sorgulamaya yönelik ayrıntılı bir öğreticiyi deneyin.

Diğer popüler hizmetler için de hızlı başlangıçlar vardır.

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. Az feedback komutuyla genel geri bildirim bırakmak için GitHub'da bir sorun oluşturabilir veya CLI'nın yerleşik özelliklerini kullanabilirsiniz.

az feedback

Ayrıca bkz.