Mulai menggunakan Azure CLI
Selamat datang di Azure Command-Line Interface (CLI)! Artikel ini memperkenalkan CLI dan membantu Anda menyelesaikan tugas-tugas umum.
Menginstal atau menjalankan di Azure Cloud Shell
Cara term mudah untuk mempelajari cara menggunakan Azure CLI adalah dengan menjalankan lingkungan Bash di Azure Cloud Shell melalui browser Anda. Untuk mempelajari Cloud Shell, lihat Panduan mulai cepat untuk Bash di Azure Cloud Shell.
Saat Anda siap menginstal Azure CLI, lihat instruksi penginstalan untuk kontainer Windows, Linux, macOS, dan Docker. Jika Anda menggunakan model penyebaran klasik Azure, instal Azure classic CLI.
Periksa versi Anda dengan menjalankan az --version
. Azure Cloud Shell selalu memiliki versi terbaru Azure CLI yang telah diinstal sebelumnya.
az version
Masuk ke Azure CLI
Sebelum menggunakan perintah Azure CLI dengan penginstalan lokal, Anda harus masuk menggunakan az login.
Jalankan perintah
az login
.az login
Jika Azure CLI dapat membuka browser default Anda, Azure CLI memulai alur kode otorisasi dan membuka browser default untuk memuat halaman masuk Azure.
Jika tidak, ini memulai alur kode perangkat dan menginstruksikan Anda untuk membuka halaman browser di https://aka.ms/devicelogin. Kemudian, masukkan kode yang ditampilkan di terminal Anda.
Jika tidak ada browser atau browser web tidak dapat dibuka, gunakan secara paksa alur kode perangkat dengan az login --use-device-code.
Masuk menggunakan kredensial akun Anda di browser.
Setelah masuk, Anda menerima daftar langganan yang terkait dengan akun Azure Anda. Informasi langganan dengan isDefault: true
adalah langganan yang saat ini diaktifkan setelah masuk. Untuk memilih langganan lain, gunakan perintah az account set dengan ID langganan akun yang diinginkan. Untuk informasi selengkapnya tentang pilihan langganan, lihat Mengelola langganan Azure.
Ada beberapa cara untuk masuk secara non-interaktif, yang dibahas secara mendetail di Masuk dengan Azure CLI.
Menemukan perintah
Perintah Azure CLI diatur sebagai grup perintah. Setiap grup mewakili area layanan Azure. Ada dua opsi untuk menemukan grup perintah:
Gunakan perintah az find. Misalnya, untuk mencari nama perintah yang berisi
vm
, gunakan perintah berikut:az find vm
--help
Gunakan argumen untuk mendapatkan daftar lengkap subgrup dalam grup referensi. Contoh ini mengembalikan semua subgrup untuk komputer virtual:az vm --help
Berikut adalah contoh output dengan garis yang dihilangkan untuk brevity:
Subgroups: application : Manage applications for VM. availability-set : Group resources into availability sets. boot-diagnostics : Troubleshoot the startup of an Azure Virtual Machine. ...
Berikut adalah contoh lain yang menemukan perintah Azure CLI untuk mengelompokkan komputer virtual ke dalam set ketersediaan, subgrup dari
az vm
:az vm availability-set --help
Gunakan
--help
juga untuk mendapatkan daftar parameter dan contoh perintah untuk perintah referensi.az vm create --help
Berikut adalah contoh output dengan garis yang dihilangkan untuk brevity:
Arguments --name [Required] : Name of the virtual machine. ... Authentication Arguments --admin-password : Password for the VM if authentication type is 'Password'. --admin-username : Username for the VM... ... Managed Service Identity Arguments ... Examples Create a VM from a custom managed image. az vm create -g MyResourceGroup -n MyVm --image MyImage ...
Gunakan indeks referensi A ke Z yang mencantumkan semua grup perintah menurut abjad.
Menemukan sampel dan artikel yang diterbitkan
Jika Anda lebih suka mempelajari sintaks Azure CLI dengan melihat contoh yang diterbitkan yang diuji, ada dua indeks konten artikel:
Sampel indeks A hingga Z. Indeks sampel menyediakan daftar sampel Azure CLI yang diurutkan menurut area subjek, grup referensi, dan repositori GitHub.
Artikel indeks A hingga Z. Gunakan tombol pintasan keyboard
find
Anda, sepertiCtrl + F
, untuk menjatuhkan dengan cepat ke grup perintah referensi tempat Anda tertarik. Misalnya, indeks artikel terlihat seperti ini untukaz vm
:Subgrup referensi Artikel Azure CLI memperlihatkan penggunaan referensi az vm Format output untuk perintah Azure CLI Cara menggunakan variabel dalam perintah Azure CLI Mendapatkan informasi VM dengan kueri {Artikel lainnya tercantum di sini.} az vm aem Versi baru ekstensi Azure VM untuk solusi SAP Versi Standar ekstensi Azure VM untuk solusi SAP aplikasi az vm {...}
Gunakan penyelesaian tab
CLI memiliki penyelesaian tab penuh untuk perintah di lingkungan Bash. Untuk mengaktifkan penyelesaian tab di lingkungan PowerShell, lihat Mengaktifkan penyelesaian tab di PowerShell.
Waspadai argumen yang tersedia secara global
Ada beberapa argumen yang tersedia untuk sebagian besar perintah.
--help
mencetak informasi referensi CLI tentang perintah beserta argumennya dan mencantumkan sub-grup dan perintah yang tersedia.--output
mengubah format output. Format output yang tersedia meliputijson
,jsonc
(JSON berwarna),tsv
(Nilai yang Dipisahkan Tab),table
(tabel ASCII yang dapat dibaca manusia), danyaml
. Secara default, CLI menghasilkanjson
. Untuk mempelajari lebih lanjut format output yang tersedia, lihat Format output untuk Azure CLI.--query
menggunakan bahasa kueri JMESPath untuk memfilter output yang ditampilkan dari layanan Azure. Untuk mempelajari kueri lebih lanjut, lihat Mengkueri hasil perintah dengan Azure CLI dan tutorial JMESPath.--verbose
mencetak informasi tentang sumber daya yang dibuat di Azure selama operasi, serta informasi yang berguna lainnya.--debug
mencetak lebih banyak informasi tentang operasi CLI, yang digunakan untuk tujuan penelusuran kesalahan. Jika Anda menemukan bug, masukkan output yang dihasilkan dengan bendera--debug
saat menyerahkan laporan bug. Ini dapat digunakan, misalnya, untuk mengidentifikasi REST API bahwa perintah yang dijalankan dipanggil di bawahnya, dan respons yang diterima dari layanan.--subscription
adalah nama atau ID langganan. Untuk informasi selengkapnya tentang mengatur langganan default Anda, lihat Mengelola langganan Azure dengan Azure CLI.--only-show-errors
menyembunyikan peringatan dalam output perintah dan hanya menunjukkan kesalahan.
Menggunakan mode interaktif
CLI menawarkan mode interaktif yang secara otomatis menampilkan informasi bantuan dan memudahkan pemilihan sub-perintah. Masuk ke mode interaktif dengan perintah az interactive.
az interactive
Untuk informasi selengkapnya tentang mode interaktif, lihat Menjalankan Azure CLI dalam Mode Interaktif.
Ada juga plugin Visual Studio Code yang menawarkan pengalaman interaktif, termasuk dokumentasi pengisian otomatis dan mouse-over.
Pelajari dasar-dasar Azure CLI dengan mulai cepat dan tutorial
Untuk mempelajari cara menggunakan Azure CLI, coba tutorial onboarding kami yang mengajarkan Anda keterampilan berikut saat bekerja dengan Azure Storage:
- Temukan dan ubah langganan default Anda.
- Buat sumber daya Azure yang berisi ID acak dalam nama.
- Atur variabel lingkungan.
- Pelajari perbedaan sintaks antara Bash, PowerShell, dan Cmd.
- Men-debug perintah referensi Azure CLI.
- Dapatkan properti dari file JSON lokal.. Contoh ini menunjukkan cara mendapatkan nilai konfigurasi untuk pengembangan, tahap, dan produksi.
- Menghapus beberapa sumber daya menggunakan skrip.
Catatan
Dalam skrip dan di situs dokumentasi Microsoft, contoh Azure CLI ditulis untuk shell Bash. Sebagian besar contoh satu baris akan berjalan pada platform apa pun. Contoh panjang yang mencakup kelanjutan baris (\
), penetapan variabel, atau tanda kutip perlu dimodifikasi untuk bekerja di shell lain, termasuk PowerShell. Untuk informasi selengkapnya tentang perbedaan sintaks antara lingkungan, lihat Mempelajari perbedaan sintaks antara Bash, PowerShell, dan Cmd.
Berikan umpan balik
Kami menyambut tanggapan Anda untuk CLI untuk membantu kami melakukan perbaikan dan menangani bug. Anda dapat mengajukan masalah di GitHub atau menggunakan fitur bawaan CLI untuk memberikan tanggapan umum terkait perintah az feedback.
az feedback