Mulai menggunakan Azure CLI

Artikel
03/10/2024

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, seperti Ctrl + F, untuk menjatuhkan dengan cepat ke grup perintah referensi tempat Anda tertarik. Misalnya, indeks artikel terlihat seperti ini untuk az 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 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.
--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