Azure CLI'yi kullanmaya başlama

Makale
03/08/2024

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.

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.
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:

Örnek dizini A-Z. Örnekler dizini konu alanına, başvuru grubuna ve GitHub deposuna göre sıralanmış Azure CLI örneklerinin listesini sağlar.

Makale dizini A-Z. İlgilendiğiniz başvuru komut grubuna hızla gitmek için gibi Ctrl + Fklavye find kısayol tuşlarınızı kullanın. Örneğin, makale dizini için az vmşuna benzer:

Başvuru alt grubu	Başvuru kullanımını gösteren Azure CLI makalesi
az vm	Azure CLI komutları için çıkış biçimleri
	Azure CLI komutlarında değişkenleri kullanma
	Sorgularla VM bilgilerini alma
	{Burada listelenen diğer makaleler.}
az vm aem	SAP çözümleri için Azure VM uzantısının yeni sürümü
	SAP çözümleri için Azure VM uzantısının Standart Sürümü
az vm application	{...}

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.
--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:

Varsayılan aboneliğinizi bulun ve değiştirin.
Adında rastgele bir kimlik içeren bir Azure kaynağı oluşturun.
Ortam değişkenlerini ayarlayın.
Bash, PowerShell ve Cmd arasındaki söz dizimi farklarını öğrenin.
Azure CLI başvuru komutlarının hatalarını ayıklama.
Yerel bir JSON dosyasından özellik alın.. Bu örnekte geliştirme, aşama ve üretim için yapılandırma değerlerinin nasıl alınıyor olduğu gösterilmektedir.
Betik kullanarak birden çok kaynağı silin.

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