Bagikan melalui

Menginstal Azure CLI di Windows

Azure Command-Line Interface (CLI) adalah alat baris perintah lintas platform yang dapat diinstal secara lokal di komputer Windows. Anda dapat menggunakan Azure CLI untuk Windows untuk terhubung ke Azure dan menjalankan perintah administratif di sumber daya Azure. Azure CLI juga dapat digunakan dari browser melalui Azure Cloud Shell atau dijalankan dari dalam kontainer Docker.

Untuk Windows, Azure CLI diinstal melalui MSI atau paket ZIP, yang memberi Anda akses ke Azure CLI melalui PowerShell atau Windows Command Prompt (cmd.exe). Saat Anda melakukan penginstalan untuk Subsistem Windows untuk Linux (WSL), paket tersedia untuk distribusi Linux Anda. Lihat halaman penginstalan utama untuk daftar pengelola paket yang didukung atau cara menginstal secara manual dengan WSL.

Versi Azure CLI saat ini adalah 2.81.0. Untuk informasi tentang rilis terbaru, lihat catatan rilis. Untuk menemukan versi yang terinstal dan melihat apakah Anda perlu memperbarui, jalankan az version.

Menginstal atau memperbarui

MSI dan ZIP yang dapat didistribusikan digunakan untuk menginstal atau memperbarui Azure CLI di Windows. Anda tidak perlu menghapus instalan versi saat ini sebelum menggunakan penginstal MSI karena MSI memperbarui versi yang ada.

Penting

Setelah penginstalan selesai, Anda harus menutup dan membuka kembali jendela terminal aktif apa pun untuk menggunakan Azure CLI.

WinGet (Pengelola Paket Windows)

Gunakan WinGet, Manajer paket Microsoft untuk Windows, untuk menginstal dan mengelola pembaruan untuk Azure CLI. Secara default, Winget menginstal Azure CLI 64-bit pada sistem operasi 64-bit.

Nota

WinGet tersedia secara default di Windows 11 dan versi modern Windows 10. Namun, mungkin tidak diinstal di versi Windows yang lebih lama. Lihat dokumentasi winget untuk instruksi penginstalan.

winget install --exact --id Microsoft.AzureCLI

Pilihan --exact adalah untuk memastikan bahwa paket Azure CLI resmi diinstal. Perintah ini menginstal versi terbaru secara default. Untuk menentukan versi, tambahkan --version <version> dengan versi yang Anda inginkan ke dalam perintah. Berikut adalah sebuah contoh:

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

Microsoft Installer (MSI)

Versi terbaru

Unduh dan instal Azure CLI rilis terbaru. Saat alat penginstal bertanya apakah alat ini dapat membuat perubahan pada komputer Anda, pilih kotak "Ya".

MSI terbaru dari Azure CLI (32-bit)

MSI terbaru dari Azure CLI (64-bit)

Jika Anda sudah menginstal Azure CLI sebelumnya, menjalankan MSI 32-bit atau 64-bit akan menimpa instalasi yang sudah ada.

Versi spesifik

Jika mau, Anda dapat mengunduh versi Azure CLI tertentu dengan menggunakan URL.

Untuk mengunduh penginstal MSI untuk versi tertentu, ubah segmen versi di URL https://azcliprod.blob.core.windows.net/msi/azure-cli-<version>.msi (32-bit) atau https://azcliprod.blob.core.windows.net/msi/azure-cli-<version>-x64.msi (64-bit).

Misalnya, untuk menginstal MSI 32-bit Azure CLI versi 2.51.0, URL Anda adalah https://azcliprod.blob.core.windows.net/msi/azure-cli-2.51.0.msi. Penginstalan 64-bit yang sesuai adalah https://azcliprod.blob.core.windows.net/msi/azure-cli-2.51.0-x64.msi.

Versi Azure CLI yang tersedia dapat ditemukan di catatan rilis Azure CLI. MSI 64-bit tersedia dari versi 2.51.0.

Microsoft Installer (MSI) dengan PowerShell

Untuk menginstal Azure CLI menggunakan PowerShell, mulai PowerShell sebagai administrator dan jalankan perintah berikut:

$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

Ini akan mengunduh dan menginstal penginstal 32-bit terbaru dari Azure CLI untuk Windows. Jika Anda lebih suka penginstalan 64-bit, ubah URL menjadi https://aka.ms/installazurecliwindowsx64. Jika Azure CLI sudah diinstal, alat penginstal akan menimpa versi yang ada.

Untuk menginstal versi tertentu, ganti argumen -Uri dengan URL yang dijelaskan di bagian berikutnya. Berikut adalah contoh penggunaan alat penginstal 32-bit dari Azure CLI versi 2.51.0 di PowerShell:

$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

Versi spesifik

Untuk mengunduh penginstal MSI untuk versi tertentu, ubah segmen versi di URL https://azcliprod.blob.core.windows.net/msi/azure-cli-<version>.msi (32-bit) atau https://azcliprod.blob.core.windows.net/msi/azure-cli-<version>-x64.msi (64-bit).

Misalnya, untuk menginstal MSI 32-bit Azure CLI versi 2.51.0, URL Anda adalah https://azcliprod.blob.core.windows.net/msi/azure-cli-2.51.0.msi. Penginstalan 64-bit yang sesuai adalah https://azcliprod.blob.core.windows.net/msi/azure-cli-2.51.0-x64.msi.

Versi Azure CLI yang tersedia dapat ditemukan di catatan rilis Azure CLI. MSI 64-bit tersedia dari versi 2.51.0.

Perbedaan sintaks antara Bash dan PowerShell

Meskipun sebagian besar dokumentasi Azure CLI ditulis dan diuji dalam shell Bash, Anda juga dapat menginstal dan menjalankan Azure CLI menggunakan PowerShell. Ada perbedaan sintaks yang halus antara Bash dan PowerShell. Tinjau artikel ini untuk menghindari kesalahan pembuatan skrip:

Saat menjalankan Azure CLI di PowerShell, ada juga perbedaan penanganan kesalahan dan kemampuan untuk mengaktifkan penyelesaian tab. Lihat artikel ini untuk informasi selengkapnya:

Paket ZIP

Penting

Paket ini sedang dalam pratinjau.

Anda dapat menggunakan paket ZIP untuk menginstal Azure CLI di Windows. Paket ini berguna ketika Anda tidak memiliki hak administratif.

Unzip paket ke folder, lalu menggunakan Cmd atau PowerShell, panggil Azure CLI dengan menjalankan <unzipped folder path>\bin\az.cmd.

Jika Anda ingin menjalankan perintah secara az langsung, ikuti langkah-langkah di bawah ini untuk menambahkan Azure CLI ke variabel lingkungan Anda PATH .

  1. Buka Menu Mulai dan cari environment variables. Klik Edit the system environment variables.
  2. Klik tombol Environment Variables... .
  3. Dalam kotak User variables for <username> , pilih Path dan klik tombol Edit... .
  4. Klik tombol New dan tambahkan <unzipped folder path>\bin ke dalam daftar.
  5. Mulai ulang terminal Anda. Sekarang, Anda seharusnya bisa menjalankan perintah az.

Versi terbaru

ZIP terbaru dari Azure CLI (64-bit)

Versi spesifik

Jika mau, Anda dapat mengunduh versi Azure CLI tertentu dengan menggunakan URL.

Untuk mengunduh paket ZIP untuk versi tertentu, ubah segmen versi di URL https://azcliprod.blob.core.windows.net/zip/azure-cli-<version>-x64.zip.

Misalnya, untuk menginstal ZIP 64-bit Azure CLI versi 2.57.0, URL Anda adalah https://azcliprod.blob.core.windows.net/zip/azure-cli-2.57.0-x64.zip.

Versi Azure CLI yang tersedia dapat ditemukan di catatan rilis Azure CLI. Paket ZIP tersedia dari versi 2.57.0. Hanya 64-bit yang tersedia.

Menjalankan Azure CLI

Setelah penginstalan, tutup dan buka kembali jendela terminal aktif apa pun. Jalankan Azure CLI dengan az perintah dari PowerShell atau Prompt Perintah Windows.

Sebelum dapat menjalankan perintah Azure CLI, Anda harus masuk ke Azure. Untuk masuk secara interaktif, gunakan az login. Untuk informasi tentang autentikasi, lihat Masuk ke Azure dengan Azure CLI.

az login

Langkah pertama yang umum adalah memeriksa langganan aktif Anda.

az account show

Pemecahan masalah penginstalan

Berikut beberapa masalah umum yang muncul saat menginstal Azure CLI di Windows. Jika masalah Anda tidak tercantum di sini, ajukan masalah di GitHub.

Variabel PATH tidak diatur

Penyebab paling umum dari masalah ini adalah tidak memulai ulang jendela terminal aktif setelah penginstalan. Tutup dan buka kembali jendela terminal aktif apa pun.

Koneksi diblokir oleh proksi

Jika Anda tidak dapat mengunduh penginstal MSI karena proksi Memblokir koneksi, pastikan Anda telah mengonfigurasi proksi. Untuk Windows 11, pengaturan ini dikelola di panel Settings > Network & Internet > Proxy . Hubungi administrator sistem Anda untuk pengaturan yang diperlukan, atau untuk situasi di mana komputer Anda mungkin dikendalikan melalui konfigurasi atau memerlukan pengaturan lanjutan.

Penting

Pengaturan ini juga diperlukan untuk dapat mengakses layanan Azure dengan Azure CLI, baik dari PowerShell atau Prompt Perintah. Di PowerShell, Anda melakukan konfigurasi ini dengan perintah berikut:

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

Untuk mendapatkan MSI, proksi Anda perlu mengizinkan koneksi HTTPS ke alamat berikut:

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

Untuk informasi selengkapnya, lihat Bekerja di belakang proksi di panduan pemecahan masalah Azure CLI.

Waktu respons lambat

Lihat Migrasi ke Azure CLI 64-bit

Mengaktifkan penyelesaian tab di PowerShell

Penyelesaian tab, juga dikenal sebagai "Penyelesai Azure CLI", menyediakan penyelesaian pada masukan untuk memberikan petunjuk, mengaktifkan penemuan, dan mempercepat entri input. Nama perintah, nama grup perintah, parameter, dan nilai parameter tertentu dapat secara otomatis dimasukkan ke dalam baris perintah dengan menekan tombol Tab .

Penyelesaian tab diaktifkan secara default di Azure Cloud Shell dan di sebagian besar distribusi Linux. Mulai dari Azure CLI versi 2.49, Anda dapat mengaktifkan penyelesaian tab untuk Azure CLI di PowerShell. Ikuti langkah-langkah ini:

  1. Buat atau edit profil yang disimpan dalam variabel $PROFILE. Cara paling sederhana adalah menjalankan notepad $PROFILE di PowerShell. Untuk informasi selengkapnya, lihat Cara membuat profil dan Profil serta kebijakan eksekusi.

  2. Tambahkan kode berikut ke profil PowerShell Anda:

    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. Untuk menampilkan semua opsi yang tersedia di menu, tambahkan Set-PSReadlineKeyHandler -Key Tab -Function MenuComplete ke profil PowerShell Anda.

Memperbarui Azure CLI

Dimulai dengan versi 2.11.0, Azure CLI menyediakan perintah dalam alat untuk memperbarui ke versi terbaru.

az upgrade

Perintah ini juga memperbarui semua ekstensi yang diinstal secara default. Untuk opsi lainnya az upgrade , lihat halaman referensi perintah. Untuk versi Azure CLI sebelum 2.11.0, perbarui dengan menginstal ulang seperti yang dijelaskan dalam Menginstal Azure CLI.

Jika Anda menggunakan distribusi ZIP, hapus folder penginstalan lama dan ekstrak versi baru ke lokasi yang sama.

Migrasi ke Azure CLI 64-bit

Mulai dari 2.51.0, Azure CLI juga menyediakan MSI 64-bit, yang direkomendasikan untuk performa yang lebih baik.

Ikuti langkah-langkah ini untuk bermigrasi ke Azure CLI versi 64-bit:

  1. Periksa versi Azure CLI Anda saat ini dan ekstensi yang diinstal dengan menjalankan az --version.
  2. Ekstensi memerlukan penginstalan ulang. Cadangkan folder ekstensi %userprofile%\.azure\cliextensions saat ini dengan mengganti namanya jika Anda ingin kembali ke versi 32-bit. Folder ini dibuat secara otomatis ketika Anda menginstal ulang ekstensi.
  3. Unduh dan instal penginstal 64-bit terbaru seperti yang dijelaskan dalam Instal atau perbarui. MSI 32-bit secara otomatis dihapus instalasinya.
  4. Instal ekstensi dengan menjalankan az extension add --name <extension> --version <version>. Jika Anda tidak ingin menginstal ulang ekstensi secara manual, Azure CLI meminta Anda untuk menginstal ekstensi pada penggunaan pertama. Untuk informasi selengkapnya tentang menginstal ekstensi, lihat Cara menginstal ekstensi.

Jika Anda mengalami masalah setelah migrasi, Anda dapat menghapus instalan versi 64-bit dan menginstal ulang MSI 32-bit. Jika Anda membuat cadangan folder ekstensi 32-bit, pulihkan atau ganti nama folder ekstensi Anda setelah perubahan.

Uninstal

Jika Anda memutuskan untuk menghapus instalan Azure CLI, kami menyayangkan keputusan Anda. Sebelum Anda menghapus instalan, gunakan perintah az feedback untuk memberi tahu kami area yang dapat ditingkatkan atau diperbaiki. Tujuan kami adalah membuat Azure CLI bebas bug dan mudah digunakan. Jika Anda menemukan bug, kami akan menghargainya jika Anda mengajukan masalah GitHub.

Hapus instalan Azure CLI dari daftar "Aplikasi dan Fitur" Windows. Untuk mencopot atau menghapus instalasi:

Plattform Petunjuk
Windows 11 Mulai > Pengaturan > Aplikasi > Terinstal
Windows 10 Mulai Pengaturan Aplikasi Aplikasi & Fitur
Windows 8 dan Windows 7 Buka > Panel Kontrol > Program > Copot pemasangan program

Setelah berada di layar ini, ketik Azure CLI ke dalam bilah pencarian program. Program yang akan dihapus instalannya tercantum sebagai Microsoft CLI 2.0 untuk Azure. Pilih aplikasi ini, lalu pilih tombol Uninstall .

Menghapus data

Jika Anda tidak ingin menginstal ulang Azure CLI, hapus datanya dari C:\Users\<username>\.azure\msal_token_cache.bin atau C:\Users\<username>\.azure\msal_token_cache.json.

Langkah Selanjutnya

Sekarang setelah Anda menginstal Azure CLI di Windows, pelajari tentang berbagai cara untuk masuk.

Masuk dengan Azure CLI

  • Last updated on