Instal 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 untuk Windows juga dapat digunakan dari browser melalui Azure Cloud Shell atau dijalankan dari dalam kontainer Docker.

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

Versi Azure CLI saat ini adalah 2.37.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 yang dapat didistribusikan digunakan untuk menginstal atau memperbarui Azure CLI di Windows. Anda tidak perlu menghapus instalan versi saat ini sebelum menggunakan alat penginstal MSI karena MSI akan memperbarui versi yang ada.

Alat Penginstal Microsoft (MSI)

Versi terbaru

Unduh dan instal Azure CLI rilis terbaru. Jika alat penginstal bertanya apakah dapat membuat perubahan pada komputer Anda, klik kotak "Ya". Setelah penginstalan selesai, Anda harus menutup dan membuka kembali jendela Perintah Windows atau PowerShell yang aktif untuk menggunakan Azure CLI.

Azure CLI rilis terbaru

Versi spesifik

Untuk mengunduh alat penginstal MSI untuk versi tertentu, ubah segmen versi di URL https://azcliprod.blob.core.windows.net/msi/azure-cli-<version>.msi dan unduh. Versi yang tersedia dapat ditemukan di Catatan rilis Azure CLI.

Alat penginstal Microsoft (MSI) dengan Perintah

Perintah PowerShell

Anda juga dapat menginstal Azure CLI menggunakan PowerShell. Mulai PowerShell sebagai administrator dan jalankan perintah berikut:

Catatan

PowerShell harus dijalankan sebagai administrator.

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'; rm .\AzureCLI.msi

Ini akan mengunduh dan menginstal Azure CLI versi terbaru untuk Windows. Jika Anda sudah menginstal versi, alat penginstal akan memperbarui versi yang ada.

Untuk menginstal versi tertentu, ganti argumen -Uri dengan https://azcliprod.blob.core.windows.net/msi/azure-cli-<version>.msi berserta segmen versi yang diubah. Versi yang tersedia dapat ditemukan di Catatan rilis Azure CLI.

Catatan

Setelah selesai menginstal, Anda harus membuka kembali PowerShell untuk menggunakan Azure CLI.

Perintah Azure CLI (hanya untuk pembaruan)

CLI menyediakan perintah dalam alat untuk memperbarui ke versi terbaru:

az upgrade

Catatan

Perintah az upgrade ditambahkan dalam versi 2.11.0 dan tidak akan berfungsi dengan versi sebelum 2.11.0. Versi lama dapat diperbarui dengan memasang ulang seperti yang dijelaskan di Memasang Azure CLI.

Perintah ini juga akan memperbarui semua ekstensi yang diinstal secara default. Untuk opsi az upgrade lebih lanjut, lihat halaman referensi perintah.

Menjalankan Azure CLI

Anda kini dapat menjalankan Azure CLI dengan perintah az dari Perintah Windows atau PowerShell.

Pemecahan Masalah

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

Koneksi blok proksi

Jika Anda tidak dapat mengunduh alat penginstal MSI karena proksi Anda memblokir koneksi, pastikan Anda telah mengonfigurasi proksi dengan benar. Untuk Windows 10, pengaturan ini dikelola di panel Settings > Network & Internet > Proxy. Hubungi administrator sistem untuk mengetahui pengaturan yang diperlukan, atau untuk situasi saat mesin Anda mungkin dikelola konfigurasi atau memerlukan pengaturan tingkat lanjut.

Penting

Pengaturan ini juga diperlukan agar layanan Azure dapat diakses dengan CLI, baik dari PowerShell atau Perintah. Di PowerShell, Anda dapat melakukannya 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/

Hapus instalasi

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 menghapus instalan:

Platform	Instruksi
Windows 10	Mulai > Pengaturan > Aplikasi
Windows 8 dan Windows 7	Mulai > Panel Kontrol > Program > Hapus instalan 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 klik tombol Uninstall.

Menghapus data

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

Langkah berikutnya

Setelah Anda menginstal Azure CLI di Windows, ikuti tur singkat tentang fitur dan perintah umumnya.

Mulai menggunakan Azure CLI