Aracılığıyla paylaş

Azure CLI Windows yükleme

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

Windows için Azure CLI, Azure CLI PowerShell veya Windows Komut İstemi (cmd.exe) aracılığıyla erişmenizi sağlayan bir MSI veya ZIP paketi aracılığıyla yüklenir. Windows Subsystem for Linux (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 geçerli sürümü 2.84.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 Azure CLI 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'yi kullanmak için etkin olan tüm terminal pencerelerini kapatmalı ve tekrar açmalısınız.

WinGet (Windows Package Manager)

Azure CLI güncelleştirmelerini yüklemek ve yönetmek için WinGet microsoft'un Windows paket yöneticisini kullanın. Winget varsayılan olarak 64 bit Azure CLI 64 bit işletim sistemlerine yükler.

Uyarı

WinGet varsayılan olarak Windows 10 Windows 11 ve modern sürümlerinde kullanılabilir. Ancak, Windows eski sürümlerinde yüklü olmayabilir. Yükleme yönergeleri için winget belgelerine bakın.

winget install --exact --id Microsoft.AzureCLI

--exact seçeneği, resmi Azure CLI paketinin yüklendiğinden emin olmaktır. Bu komut varsayılan olarak en son sürümü yükler. Bir sürüm belirtmek için komutuna istediğiniz sürümü içeren bir --version <version> ekleyin. İşte bir örnek:

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

Microsoft Installer (MSI)

En son sürüm

Azure CLI 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.

En son Azure CLI (32-bit) MSI

Azure CLI'nin En Son 64-bit MSI'si

Daha önce Azure CLI'yi yüklediyseniz, 32 bit veya 64 bit MSI'yi çalıştırmak mevcut yüklemenin üzerine yazacaktır.

Belirli sürüm

İsterseniz, URL kullanarak Azure CLI 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, 2.51.0 Azure CLI sürümünün 32 bit MSI'sini yüklemek için URL'niz https://azcliprod.blob.core.windows.net/msi/azure-cli-2.51.0.msi olacaktır. Karşılık gelen 64 bit yükleme şu şekildedir: 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.

PowerShell ile Microsoft Installer (MSI)

powershell kullanarak Azure CLI yüklemek için, PowerShell as administrator başlatın ve aşağıdaki komutu çalıştırın:

$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

Bu, Windows için Azure CLI en son 32 bit yükleyicisini indirip yükler. 64 bit yüklemeyi tercih ediyorsanız URL'yi olarak https://aka.ms/installazurecliwindowsx64değiştirin. Azure CLI zaten yüklüyse, yükleyici mevcut sürümün üzerine yazar.

Belirli bir sürümü yüklemek için -Uri bağımsız değişkenini sonraki bölümde açıklanan URL ile değiştirin. PowerShell'de Azure CLI sürümünün 32 bit yükleyicisini 2.51.0 kullanma örneği aşağıda verilmiştir:

$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

Belirli sürüm

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, 2.51.0 Azure CLI sürümünün 32 bit MSI'sini yüklemek için URL'niz https://azcliprod.blob.core.windows.net/msi/azure-cli-2.51.0.msi olacaktır. Karşılık gelen 64 bit yükleme şu şekildedir: 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.

Bash ile PowerShell arasındaki söz dizimi farklılıkları

çoğu Azure CLI belge bir Bash kabuğunda yazılmış ve test edilmiş olsa da, PowerShell kullanarak Azure CLI yükleyebilir ve çalıştırabilirsiniz. Bash ile PowerShell arasında küçük söz dizimi farkları vardır. Betik hatalarını önlemek için şu makaleleri gözden geçirin:

  • Azure CLI'yi bir PowerShell betik dilinde çalıştırırken dikkate alınması gereken hususlar
  • Azure CLI parametrelerinde tırnak işaretlerini kullanın
  • Azure CLI'de, Bash, PowerShell ve Cmd söz dizimi farklılıklarını öğren de Bash, PowerShell ve Cmd.exe söz dizimini karşılaştır.

PowerShell'de Azure CLI çalıştırırken hata işleme farklılıkları ve sekme tamamlama özelliğini etkinleştirme olanağı da vardır. Daha fazla bilgi için şu makalelere bakın:

ZIP Paketi

Önemli

Bu paket şu anda önizleme aşamasındadır.

Azure CLI Windows yüklemek için ZIP paketini kullanabilirsiniz. Bu paket, yönetici ayrıcalığınız olmadığında kullanışlıdır.

Paketi bir klasöre açın, ardından Cmd veya PowerShell kullanarak <unzipped folder path>\bin\az.cmd çalıştırarak Azure CLI çağırın.

az komutunu doğrudan çalıştırmak istiyorsanız, Azure CLI PATH ortam değişkeninize eklemek için aşağıdaki adımları izleyin.

  1. Başlat Menüsü'ne gidin ve için environment variablesarama yapın. Edit the system environment variables’a tıklayın.
  2. Environment Variables... düğmesine tıklayın.
  3. User variables for <username> kutusunda Path seçin ve Edit... düğmesine tıklayın.
  4. New düğmesine tıklayın ve <unzipped folder path>\bin öğesini listeye ekleyin.
  5. Terminalinizi yeniden başlatın. Artık az komutlarını çalıştırabiliyor olmalısınız.

En son sürüm

En yeni Azure CLI ZIP (64 bit)

Belirli sürüm

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

Zip paketini belirli bir sürüme indirmek için URL'deki https://azcliprod.blob.core.windows.net/zip/azure-cli-<version>-x64.zipsürüm kesimini değiştirin.

Örneğin, Azure CLI sürüm 2.57.0'ın 64 bit ZIP'ini yüklemek için URL'niz https://azcliprod.blob.core.windows.net/zip/azure-cli-2.57.0-x64.zip olacaktır.

Kullanılabilir Azure CLI sürümleri Azure CLI sürüm notlarında bulunabilir. ZIP paketi sürüm 2.57.0'dan edinilebilir. Yalnızca 64 bit kullanılabilir.

Azure CLI çalıştırma

Yüklemeden sonra, etkin terminal pencerelerini kapatın ve yeniden açın. Azure CLI PowerShell'den veya Windows Komut İsteminden az komutuyla çalıştırın.

Azure CLI komutları yürütebilmeniz için önce Azure oturum açmanız gerekir. Etkileşimli olarak oturum açmak için kullanın az login. Kimlik doğrulaması hakkında bilgi için Azure CLI ile Azure'a oturum açma kısmına bakın.

az login

Yaygın bir ilk adım, etkin aboneliğinizi denetlemektir.

az account show

Yükleme sorunlarını giderme

Azure CLI Windows yüklerken karşılaşılan bazı yaygın sorunlar aşağıdadır. Burada ele alınmayan bir sorunla karşılaşırsanız GitHub<>de bir sorun oluşturun.

PATH değişkeni ayarlanmadı

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

Proxy bağlantıyı engelliyor

Proxy'niz bağlantıyı engellediğinden MSI yükleyicisini indiremiyorsanız, proxy'nizin yapılandırıldığından emin olun. Windows 11 için bu ayarlar Settings > Network & Internet > Proxy bölmesinde 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, PowerShell veya Komut İstemcisi üzerinden Azure CLI kullanarak Azure hizmetlerine erişmek için de gereklidir. PowerShell'de bu yapılandırmayı aşağıdaki komutla gerçekleştirirsiniz:

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

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

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

Daha fazla bilgi için Azure CLI sorun giderme kılavuzundaki Proxy arkasında çalışma bölümüne bakın.

Yavaş yanıt süreleri

64 bit Azure CLI'ye Geçiş Yapma"ya Bakın

PowerShell'de sekme tamamlamayı etkinleştirme

"Azure CLI tamamlayıcıları" olarak da bilinen sekme tamamlama, ipuçları sağlamak, keşfi etkinleştirmek ve giriş hızını artırmak için tamamlamalar sunar. 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 ve çoğu Linux dağıtımında varsayılan olarak etkindir. Azure CLI sürüm 2.49'dan başlayarak, PowerShell'deki 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 güncelleştirme

Azure CLI, 2.11.0 sürümünden başlayarak 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'dan önceki Azure CLI sürümler için, Azure CLI'da açıklandığı gibi yeniden yükleyerek güncelleştirin.

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

64-bit Azure CLI kullanmaya geçin

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

Azure CLI'nin 64 bit sürümüne geçmek için şu adımları izleyin:

  1. az --version çalıştırarak geçerli Azure CLI sürümünüzü ve yüklü uzantıları denetleyin.
  2. Uzantılar yeniden yükleme gerektirir. 32 bit sürüme geri dönmeye karar vererek geçerli uzantı klasörünü %userprofile%\.azure\cliextensions yeniden adlandırarak yedekleyin. 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ı az extension add --name <extension> --version <version> komutunu çalıştırarak 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 Uzantıları nasıl yükleyebilirim? bölümüne bakın.

Geçiş sonrasında sorunlarla karşılaşırsanız 64 bit sürümü kaldırabilir ve 32 bit MSI'yi yeniden yükleyebilirsiniz. 32 bit uzantılar klasörünüzü yedeklediyseniz, değişiklikten sonra uzantı klasörünüzü geri yükleyin veya yeniden adlandırın.

Kaldır

Azure CLI kaldırmaya karar verirseniz, gittiğinize üzüldük. Kaldırmadan önce az feedback komutunu kullanarak nelerin iyileştirilebileceğini veya düzeltilebileceğini bize bildirin. Hedefimiz, Azure CLI hatasız ve kullanıcı dostu hale getirmektir. Bir hata bulduysanız, bir GitHub sorunu açmanızı rica ederiz.

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

Platforma 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 başlangıç > Control Panel > Programlar > Program kaldırma

Bu ekrana girdikten sonra program arama çubuğuna Azure CLI yazın. Kaldırılacak program, Azure için Microsoft CLI 2.0 olarak listelenmiştir. 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 konumundan silin.

Sonraki Adımlar

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

Azure CLI ile giriş yapın

  • Last updated on