Aracılığıyla paylaş

Windows'da Azure CLI'yi yükleme

  • Makale

Azure Komut Satırı Arabirimi (CLI), Windows bilgisayarlara yerel olarak yüklenebilen platformlar arası bir komut satırı aracıdır. Azure'a bağlanmak ve Azure kaynaklarında yönetim komutlarını yürütmek için Windows için Azure CLI'yi kullanabilirsiniz. Windows için Azure CLI, Azure Cloud Shell aracılığıyla bir tarayıcıdan da kullanılabilir veya bir Docker kapsayıcısının içinden çalıştırılabilir.

Windows için Azure CLI, Windows Komut İstemi (CMD) veya PowerShell aracılığıyla CLI'ya erişmenizi sağlayan bir MSI veya ZIP paketi aracılığıyla yüklenir. Linux için Windows Alt Sistemi (WSL) için bir yükleme gerçekleştirdiğinizde, Linux dağıtımınız için paketler kullanılabilir. Desteklenen paket yöneticilerinin listesi veya WSL altında el ile nasıl yükleme yapacağınız hakkında bilgi için ana yükleme sayfasına bakın.

Azure CLI'nın geçerli sürümü 2.63.0'dır. En son sürüm hakkında bilgi edinmek için sürüm notlarına bakın. Yüklü sürümünüzü bulmak ve güncelleştirmeniz gerekip gerekmediğini görmek için az version komutunu çalıştırın.

Yükleme veya güncelleştirme

MSI ve ZIP dağıtılabilir, Windows'da Azure CLI'yi yüklemek veya güncelleştirmek için kullanılır. MSI mevcut sürümleri güncelleştirdiğinden MSI yükleyicisini kullanmadan önce geçerli sürümleri kaldırmanız gerekmez.

Önemli

Yükleme tamamlandıktan sonra, Azure CLI'yı kullanmak için tüm etkin terminal pencerelerini kapatıp yeniden açmanız gerekir.

En son sürüm

Azure CLI'nın en son sürümünü indirin ve yükleyin. Yükleyici bilgisayarınızda değişiklik yapıp yapamadığını sorduğunda "Evet" kutusunu seçin.

Azure CLI'nın en son MSI'sı (32 bit)

Azure CLI'nın en son MSI'sı (64 bit)

Azure CLI'yı daha önce yüklediyseniz, 32 bit veya 64 bit MSI çalıştırıldığında mevcut yüklemenin üzerine yazılır.

Belirli sürüm

İsterseniz, URL kullanarak Azure CLI'nın belirli bir sürümünü indirebilirsiniz.

Belirli bir sürüm için MSI yükleyicisini indirmek için, URL'deki https://azcliprod.blob.core.windows.net/msi/azure-cli-<version>.msi (32 bit) veya https://azcliprod.blob.core.windows.net/msi/azure-cli-<version>-x64.msi (64 bit) sürüm kesimini değiştirin.

Örneğin, Azure CLI sürüm 2.51.0'ın 32 bit MSI'sini yüklemek için URL'niz olacaktır https://azcliprod.blob.core.windows.net/msi/azure-cli-2.51.0.msi. Karşılık gelen 64 bit yükleme olacaktır https://azcliprod.blob.core.windows.net/msi/azure-cli-2.51.0-x64.msi.

Kullanılabilir Azure CLI sürümleri, Azure CLI sürüm notlarında bulunabilir. 64 bit MSI, sürüm 2.51.0'dan edinilebilir.

Azure CLI'yi çalıştırma

Azure CLI’yi artık Windows Komut İsteminden veya PowerShell’den az komutu ile çalıştırabilirsiniz.

PowerShell'de Sekme Tamamlamayı Etkinleştir

"Azure CLI tamamlayıcıları" olarak da bilinen sekme tamamlama, ipuçları sağlamak, bulmayı etkinleştirmek ve giriş girişini hızlandırmak için girişler üzerinde tamamlama sağlar. Komut adları, komut grubu adları, parametreler ve belirli parametre değerleri Sekme tuşuna basılarak komut satırına otomatik olarak eklenebilir.

Sekme tamamlama, Azure Cloud Shell'de ve çoğu Linux dağıtımında varsayılan olarak etkindir. Azure CLI sürüm 2.49'dan başlayarak, PowerShell'de Azure CLI için sekme tamamlama özelliğini etkinleştirebilirsiniz. Şu adımları izleyin:

  1. değişkeninde $PROFILEdepolanan profili oluşturun veya düzenleyin. En basit yol PowerShell'de çalıştırmaktır notepad $PROFILE . Daha fazla bilgi için bkz . Profilinizi oluşturma ve Profiller ve yürütme ilkesi.

  2. PowerShell profilinize aşağıdaki kodu ekleyin:

    Register-ArgumentCompleter -Native -CommandName az -ScriptBlock {
    param($commandName, $wordToComplete, $cursorPosition)
    $completion_file = New-TemporaryFile
    $env:ARGCOMPLETE_USE_TEMPFILES = 1
    $env:_ARGCOMPLETE_STDOUT_FILENAME = $completion_file
    $env:COMP_LINE = $wordToComplete
    $env:COMP_POINT = $cursorPosition
    $env:_ARGCOMPLETE = 1
    $env:_ARGCOMPLETE_SUPPRESS_SPACE = 0
    $env:_ARGCOMPLETE_IFS = "`n"
    $env:_ARGCOMPLETE_SHELL = 'powershell'
    az 2>&1 | Out-Null
    Get-Content $completion_file | Sort-Object | ForEach-Object {
        [System.Management.Automation.CompletionResult]::new($_, $_, "ParameterValue", $_)
    }
    Remove-Item $completion_file, Env:\_ARGCOMPLETE_STDOUT_FILENAME, Env:\ARGCOMPLETE_USE_TEMPFILES, Env:\COMP_LINE, Env:\COMP_POINT, Env:\_ARGCOMPLETE, Env:\_ARGCOMPLETE_SUPPRESS_SPACE, Env:\_ARGCOMPLETE_IFS, Env:\_ARGCOMPLETE_SHELL
}

  3. Menüde kullanılabilir tüm seçenekleri görüntülemek için PowerShell profilinize ekleyin Set-PSReadlineKeyHandler -Key Tab -Function MenuComplete .

Sorun giderme

Azure CLI'yi Windows'a yüklerken karşılaşılan bazı yaygın sorunlar aşağıda açıklanmaktadır. Burada ele alınmayan bir sorunla karşılaşırsanız GitHub'da bir sorun oluşturun.

Ara sunucu blokları bağlantısı

Proxy'niz bağlantıyı engellediği için MSI yükleyicisini indiremiyorsanız, proxy'nizin düzgün yapılandırıldığından emin olun. Windows 10 için bu ayarlar bölmede Settings > Network & Internet > Proxy yönetilir. Gerekli ayarlar veya makinenizin yapılandırmayla yönetilebileceği veya gelişmiş kurulum gerektirebileceği durumlar için sistem yöneticinize başvurun.

Önemli

Bu ayarların hem PowerShell'den hem de Komut İstemi'nden CLI ile Azure hizmetlerine erişebilmesi için de gereklidir. PowerShell'de bunu aşağıdaki komutla yaparsınız:

(New-Object System.Net.WebClient).Proxy.Credentials = `
  [System.Net.CredentialCache]::DefaultNetworkCredentials

MSI'yi almak için proxy'nizin aşağıdaki adreslere https bağlantılarına izin vermesi gerekir:

  • https://aka.ms/
  • https://azcliprod.blob.core.windows.net/

64 bit Azure CLI'ya geçiş

Azure CLI, 2.51.0'dan başlayarak daha iyi performans için önerilen 64 bit MSI'yi de sağlar.

Azure CLI 64 bit'e geçiş yapmak için şu adımları izleyin:

  1. komutunu çalıştırarak az --versiongeçerli CLI sürümünüzü ve yüklü uzantılarınızı denetleyin.
  2. Uzantıların yeniden yüklenmesi gerekir. 32 bit'e geri döndürmeyi seçmeniz durumunda geçerli uzantı klasörünü %userprofile%\.azure\cliextensions yeniden adlandırarak bir yedekleme gerçekleştirmeniz önerilir. Bu klasör, bir uzantıyı yeniden yüklerken otomatik olarak oluşturulur.
  3. Yükleme veya güncelleştirme bölümünde açıklandığı gibi en son 64 bit yükleyiciyi indirip yükleyin. 32 bit MSI otomatik olarak kaldırılır.
  4. uzantılarını çalıştırarak az extension add --name <extension> --version <version>yükleyin. Uzantıları el ile yeniden yüklemek istemiyorsanız, Azure CLI ilk kullanımda bir uzantı yüklemenizi ister. Uzantıları yükleme hakkında daha fazla bilgi için bkz . Uzantıları yükleme.

Geçiş sonrasında sorun yaşıyorsanız 64 bit'i kaldırıp 32 bit MSI'yi yeniden yükleyebilirsiniz. 32 bit uzantı klasörünüzün yedeğini aldıysanız, değişiklikten sonra uzantı klasörünüzü geri yükleyin (yeniden adlandırın).

Azure CLI'yi güncelleştirme

2.11.0 sürümünden itibaren Azure CLI, en son sürüme güncelleştirmek için araç içi bir komut sağlar.

az upgrade

Bu komut ayrıca tüm yüklü uzantıları varsayılan olarak güncelleştirir. az upgrade Diğer seçenekler için komut başvuru sayfasına bakın. 2.11.0 öncesi Azure CLI sürümleri için, Azure CLI'yi yükleme bölümünde açıklandığı gibi yeniden yükleyerek güncelleştirin.

ZIP dağıtımı kullanıyorsanız lütfen eski yükleme klasörünü silin ve yeni sürümü aynı konuma ayıklayın.

uygulamasını kaldırma

Azure CLI’yı kaldırmaya karar verdiyseniz, ayrıldığınız için üzgünüz. Kaldırmadan önce, az feedback komutunu kullanarak nelerin geliştirilebileceğini veya düzeltilebileceğini bize bildirin. Amacımız, Azure CLI’yı hatasız ve kullanımı kolay hale getirmektir. Hata bulduysanız bir GitHub sorunu oluşturarak bize bildirirseniz seviniriz.

Azure CLI'yi Windows "Uygulamalar ve Özellikler" listesinden kaldırırsınız. Kaldırmak için:

Platform Yönergeler
Windows 11 Başlangıç > Ayarları > Uygulamalar > Yüklü uygulamalar
Windows 10 Başlangıç > Ayarları > Uygulamalar > Uygulamaları ve Özellikleri
Windows 8 ve Windows 7 Programları Denetim Masası > Başlat > Program > kaldırma

Bu ekrandan sonra program arama çubuğuna Azure CLI yazın. Kaldırılan program, Azure için Microsoft CLI 2.0 olarak listelenir. Bu uygulamayı ve ardından düğmeyi Uninstall seçin.

Verileri kaldırma

Azure CLI'yı yeniden yüklemeyi planlamıyorsanız veya 'den C:\Users\<username>\.azure\msal_token_cache.bin C:\Users\<username>\.azure\msal_token_cache.jsonverilerini kaldırın.

Sonraki Adımlar

Azure CLI'yi Windows'a yüklediğinize göre, oturum açmanın farklı yolları hakkında bilgi edinin.

Azure CLI ile oturum açma