Saran dan Komentar

Memulai dengan Azure CLI

  • Artikel
  • 4 menit untuk membaca

Selamat datang di Azure Command-Line Interface (CLI)! Artikel ini memperkenalkan CLI dan membantu Anda menyelesaikan tugas-tugas umum.

Catatan

Dalam skrip dan di situs dokumentasi Microsoft, contoh Azure CLI ditulis untuk shell bash. Contoh satu baris akan berjalan di platform apa pun. Contoh yang lebih panjang yang mencakup kelanjutan baris (\) atau penetapan variabel harus diubah agar berfungsi di shell lain, termasuk PowerShell.

Menginstal atau menjalankan di Azure Cloud Shell

Cara termudah untuk mempelajari cara menggunakan Azure CLI adalah menjalankannya di lingkungan Azure Cloud Shell melalui browser. Untuk mempelajari Cloud Shell, lihat Panduan mulai cepat untuk Bash di Azure Cloud Shell.

Jika Anda sudah siap menginstal CLI, lihat petunjuk penginstalan.

Setelah menginstal CLI untuk pertama kalinya, periksa apakah ini diinstal dan Anda memiliki versi yang benar dengan menjalankan az --version.

Catatan

Jika Anda menggunakan model penyebaran klasik Azure, instal Azure classic CLI.

Cara masuk ke Azure CLI

Sebelum menggunakan perintah Azure CLI dengan penginstalan lokal, Anda harus masuk menggunakan az login.

  1. Jalankan perintah login.

    az login

    Jika CLI dapat membuka browser default Anda, CLI akan memulai alur kode otorisasi dan membuka browser default untuk memuat halaman masuk Azure.

    Jika tidak, ini akan memulai alur kode perangkat dan memberi tahu Anda untuk membuka halaman browser di https://aka.ms/devicelogin dan memasukkan kode yang ditampilkan di terminal Anda.

    Jika tidak ada browser web yang tersedia atau browser web gagal dibuka, Anda dapat memaksa alur kode perangkat dengan az login --use-device-code.

  2. Masuk menggunakan info masuk akun Anda di browser.

Setelah masuk, Anda melihat 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 untuk beralih. Untuk informasi selengkapnya tentang pemilihan langganan, lihat Menggunakan beberapa langganan Azure.

Ada beberapa cara untuk masuk secara non-interaktif, yang dibahas secara mendetail di Masuk dengan Azure CLI.

Perintah Azure CLI umum

Tabel ini mencantumkan beberapa perintah umum yang digunakan dalam CLI dan tautan ke dokumentasi referensinya.

Jenis Sumber Daya Grup perintah Azure CLI
Grup sumber daya az group
Komputer virtual az vm
Akun penyimpanan az storage account
Key Vault az keyvault
Aplikasi web az webapp
Database SQL az sql server
CosmosDB az cosmosdb

Menemukan perintah

Perintah Azure CLI diatur sebagai perintah grup. Setiap grup mewakili layanan Azure, dan perintah beroperasi di layanan tersebut.

Untuk mencari perintah, gunakan az find. Misalnya, untuk mencari nama perintah yang berisi secret, gunakan perintah berikut:

az find secret

Gunakan argumen --help untuk mendapatkan daftar lengkap perintah dan sub-kelompok dari grup. Misalnya, untuk menemukan perintah CLI untuk bekerja dengan Kelompok Keamanan Jaringan (NSG):

az network nsg --help

CLI memiliki penyelesaian tab penuh untuk perintah di bawah shell bash.

Argumen yang tersedia secara global

Ada beberapa argumen yang tersedia untuk setiap 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 meliputi json, jsonc (JSON berwarna), tsv (Nilai yang Dipisahkan Tab), table (tabel ASCII yang dapat dibaca manusia), dan yaml. Secara default, CLI menghasilkan json. 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.

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

Ada juga plugin Visual Studio Code yang menawarkan pengalaman interaktif, termasuk dokumentasi pengisian otomatis dan mouse-over.

Pelajari dasar-dasar CLI dengan mulai cepat dan tutorial

Untuk mempelajari cara menggunakan Azure CLI, coba tutorial mendalam untuk menyiapkan mesin virtual dan menggunakan kelebihan CLI untuk mengkueri sumber daya Azure.

Tutorial membuat mesin virtual dengan Azure CLI

Ada juga panduan mulai cepat untuk layanan populer lainnya.

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

Lihat juga