Aracılığıyla paylaş

Azure CLI'yi Windows'a 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. 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, PowerShell veya Windows Komut İstemi (cmd.exe ) aracılığıyla Azure 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.81.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çmalısınız.

WinGet (Windows Paket Yöneticisi)

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'yi 64 bit işletim sistemlerine yükler.

Uyarı

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

winget install --exact --id Microsoft.AzureCLI

Bu --exact seçenek, 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'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'yi daha önce yüklediyseniz, 32-bit veya 64-bit MSI'den birini çalıştırmanız durumunda mevcut kurulumun üzerine yazacaktı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 ş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)

Azure CLI'yi PowerShell kullanarak yüklemek için PowerShell'i yönetici olarak 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 işlem, Windows için Azure CLI'nın 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 2.51.0'ın 32 bit yükleyicisini 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, 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 ş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ı

Azure CLI belgelerinin çoğu Bash kabuğunda yazılmış ve test edilmiş olsa da, PowerShell kullanarak Azure CLI'yı yükleyip ç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 PowerShell'de çalıştırırken hata işleme farklılıkları ve sekme tamamlama özelliğini etkinleştirme özelliği de 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'yi Windows'a yüklemek için ZIP paketini kullanabilirsiniz. Bu paket, yönetici ayrıcalığınız olmadığında kullanışlıdır.

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

Komutu doğrudan çalıştırmak az istiyorsanız, Azure CLI'yi ortam değişkeninize PATH 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

Azure CLI'nın en son ZIP'i (64 bit)

Belirli sürüm

İsterseniz, URL kullanarak Azure CLI'nın 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 olacaktır https://azcliprod.blob.core.windows.net/zip/azure-cli-2.57.0-x64.zip.

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'yi çalıştırma

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

Azure CLI komutlarını yürütebilmeniz için önce Azure'da 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 bkz. Azure CLI ile Azure'da oturum açma.

az login

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, 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 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, PowerShell veya Komut İstemi'nden Azure CLI ile Azure hizmetlerine erişebilmesi 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 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ştirme

"Azure CLI tamamlayıcıları" olarak da bilinen sekme tamamlama işlevi, kullanıcıya ipuçları sunmak, keşfi kolaylaştırmak ve bilgi girişini hızlandırmak amacıyla 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 .

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. Azure CLI'nin 2.11.0 sürümünden önceki sürümleri için, Azure CLI'yi Yükleme bölümünde açıklandığı şekilde yeniden yükleyerek güncelleyin.

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'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'nın 64 bit sürümüne geçmek için şu adımları izleyin:

  1. komutunu çalıştırarak az --versiongeçerli Azure CLI sürümünüzü ve yüklü uzantılarınızı 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'yı 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'yi hatasız ve kullanıcı dostu hale getirmektir. Bir hata bulduysanız, bir GitHub sorunu açarsanızçok seviniriz.

Azure CLI'yi 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 Denetim Masası > Başlat > Programlar > Bir programı kaldır

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 klasöründen 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

  • Last updated on