Windows'da Azure CLI'yi yükleme

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

winget install --exact --id Microsoft.AzureCLI

winget install --exact --id Microsoft.AzureCLI --version 2.67.0

$ProgressPreference = 'SilentlyContinue'; Invoke-WebRequest -Uri https://aka.ms/installazurecliwindows -OutFile .\AzureCLI.msi; Start-Process msiexec.exe -Wait -ArgumentList '/I AzureCLI.msi /quiet'; Remove-Item .\AzureCLI.msi

$ProgressPreference = 'SilentlyContinue'; Invoke-WebRequest -Uri https://azcliprod.blob.core.windows.net/msi/azure-cli-2.51.0.msi -OutFile .\AzureCLI.msi; Start-Process msiexec.exe -Wait -ArgumentList '/I AzureCLI.msi /quiet'; Remove-Item .\AzureCLI.msi

Azure CLI'yi çalıştırma

Yüklemeden sonra, etkin terminal pencerelerini kapatın ve yeniden açın. Azure CLI'yi Windows Komut İstemi veya PowerShell'den az komutuyla çalıştırın. Yaygın bir ilk adım, etkin aboneliğinizi denetlemektir.

az account show

Yükleme sorunlarını 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.

PATH değişkeni ayarlanmadı

Bu sorunun en yaygın nedeni, etkin terminal penceresinin yüklemeden sonra yeniden başlatılmamış olmasıdır. Etkin terminal pencerelerini kapatın ve yeniden açın.

Ara sunucu bağlantıyı engelliyor

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.

(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/

Daha fazla bilgi için bkz. Azure CLI sorun giderme kılavuzunda vekil sunucu arkasında çalışmak.

Yavaş yanıt süreleri

Bkz. 64 bit Azure CLI'ya geçiş

PowerShell'de Sekme Tamamlamayı Etkinleştir

"Azure CLI tamamlayıcıları" olarak da bilinen sekme tamamlama, ipuçları sağlamak, araştırmayı kolaylaştırmak ve girişi hızlandırmak için girişlerin tamamlanmasına imkan tanır. 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 .

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.

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ılacaktır.
4. Uzantıları yüklemek için az extension add --name <extension> --version <version> çalıştırın. 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 Uzantıları nasıl yüklenir bölümüne bakın.

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

Kaldır

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:

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'yi yeniden yüklemeyi planlamıyorsanız, verilerini C:\Users\<username>\.azure\msal_token_cache.bin veya C:\Users\<username>\.azure\msal_token_cache.json'den 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.