az vm run-command

  • Referensi

Mengelola perintah eksekusi pada Komputer Virtual.

Untuk mengetahui informasi selengkapnya, lihat https://docs.microsoft.com/azure/virtual-machines/windows/run-command atau https://docs.microsoft.com/azure/virtual-machines/linux/run-command.

Perintah

Nama Deskripsi Jenis Status
az vm run-command create

Operasi untuk membuat perintah jalankan.

 Inti GA
az vm run-command delete

Operasi untuk menghapus perintah jalankan.

 Inti GA
az vm run-command invoke

Jalankan perintah jalankan tertentu pada vm.

 Inti GA
az vm run-command list

Mencantumkan perintah eksekusi dari VM atau lokasi.

 Inti GA
az vm run-command show

Dapatkan perintah jalankan tertentu.

 Inti GA
az vm run-command update

Operasi untuk memperbarui perintah jalankan.

 Inti GA
az vm run-command wait

Tempatkan CLI dalam status tunggu hingga kondisi perintah res virtual-machine-run-terpenuhi.

 Inti GA

az vm run-command create

Edit

Operasi untuk membuat perintah jalankan.

az vm run-command create --name
                         --resource-group
                         --vm-name
                         [--async-execution {false, true}]
                         [--command-id]
                         [--error-blob-uri]
                         [--location]
                         [--no-wait]
                         [--output-blob-uri]
                         [--parameters]
                         [--protected-parameters]
                         [--run-as-password]
                         [--run-as-user]
                         [--script]
                         [--script-uri]
                         [--tags]
                         [--timeout-in-seconds]

Contoh

Buat perintah jalankan.

az vm run-command create --resource-group "myResourceGroup" --location "West US" --async-execution false --parameters arg1=param1 arg2=value1 --run-as-password "<runAsPassword>" --run-as-user "user1" --script "Write-Host Hello World!" --timeout-in-seconds 3600 --run-command-name "myRunCommand" --vm-name "myVM"

Buat perintah jalankan dengan mengunggah aliran output skrip ke blob penyimpanan Azure (SAS URI).

az vm run-command create --resource-group "myResourceGroup" --location "West US" --script "Write-Host Hello World!" --run-command-name "myRunCommand" --vm-name "myVM" --output-blob-uri "https://mystorageaccount.blob.core.windows.net/mycontainer/RuncommandOutput.txt?sp=racw&st=2022-10-17T19:02:15Z&se=2022-10-18T03:02:15Z&spr=https&sv=2021-06-08&sr=b&sig=3BxtEasfdasdfasdfdYki9yvYsqc60V0%3D"

Parameter yang Diperlukan

--name --run-command-name

Nama perintah eksekusi komputer virtual.

--resource-group -g

Nama grup sumber daya. Anda dapat mengonfigurasi grup default menggunakan az configure --defaults group=<name>.

--vm-name

Nama mesin virtual.

Parameter Opsional

--async-execution

Opsional. Jika diatur ke true, provisi akan selesai segera setelah skrip dimulai dan tidak akan menunggu skrip selesai.

nilai yang diterima: false, true
--command-id

Tentukan commandId dari skrip bawaan yang telah ditentukan sebelumnya.

--error-blob-uri

Tentukan blob penyimpanan Azure tempat aliran kesalahan skrip akan diunggah.

--location -l

Lokasi. Nilai dari: az account list-locations. Anda dapat mengonfigurasi lokasi default menggunakan az configure --defaults location=<location>.

--no-wait

Jangan menunggu operasi jangka panjang selesai.

nilai default: False
--output-blob-uri

Tentukan blob penyimpanan Azure (SAS URI) tempat aliran output skrip akan diunggah.

--parameters

Parameter yang digunakan oleh skrip.

Penggunaan: --parameters arg1=XX arg2=XX.

--protected-parameters

Parameter yang digunakan oleh skrip.

Penggunaan: --protected-parameters credentials=somefoo secret=somebar.

--run-as-password

Kata sandi jika diperlukan untuk menggunakan parameter run-as-user. Ini akan dienkripsi dan tidak dicatat.

--run-as-user

Secara default, proses skrip berjalan di bawah sistem/pengguna root. Tentukan pengguna kustom untuk menghosting proses.

--script

Tentukan konten skrip yang akan dijalankan pada VM.

--script-uri

Tentukan lokasi pengunduhan skrip.

--tags

Tag yang dipisahkan spasi: key[=value] [key[=value] ...]. Gunakan "" untuk menghapus tag yang ada.

--timeout-in-seconds

Batas waktu dalam detik untuk menjalankan perintah jalankan.

Parameter Global
--debug

Meningkatkan verbositas pengelogan untuk menampilkan semua log debug.

--help -h

Menampilkan pesan bantuan ini dan keluar.

--only-show-errors

Hanya menampilkan kesalahan, menyembunyikan peringatan.

--output -o

Format output.

nilai yang diterima: json, jsonc, none, table, tsv, yaml, yamlc
nilai default: json
--query

String kueri JMESPath. Lihat http://jmespath.org/ untuk informasi selengkapnya beserta contohnya.

--subscription

Nama atau ID langganan. Anda dapat mengonfigurasi langganan default menggunakan az account set -s NAME_OR_ID.

--verbose

Meningkatkan verbositas pengelogan. Gunakan --debug untuk log waktu lengkap.

az vm run-command delete

Edit

Operasi untuk menghapus perintah jalankan.

az vm run-command delete --name
                         [--ids]
                         [--no-wait]
                         [--resource-group]
                         [--subscription]
                         [--vm-name]
                         [--yes]

Contoh

Menghapus perintah jalankan.

az vm run-command delete --resource-group "myResourceGroup" --run-command-name "myRunCommand" --vm-name "myVM"

Parameter yang Diperlukan

--name --run-command-name

Nama perintah eksekusi komputer virtual.

Parameter Opsional

--ids

Satu atau beberapa ID sumber daya (dibatasi ruang). Ini harus menjadi ID sumber daya lengkap yang berisi semua informasi argumen 'Id Sumber Daya'. Anda harus menyediakan argumen --ids atau 'Resource Id' lainnya.

--no-wait

Jangan menunggu operasi jangka panjang selesai.

nilai default: False
--resource-group -g

Nama grup sumber daya. Anda dapat mengonfigurasi grup default menggunakan az configure --defaults group=<name>.

--subscription

Nama atau ID langganan. Anda dapat mengonfigurasi langganan default menggunakan az account set -s NAME_OR_ID.

--vm-name

Nama mesin virtual.

--yes -y

Jangan meminta konfirmasi.

nilai default: False
Parameter Global
--debug

Meningkatkan verbositas pengelogan untuk menampilkan semua log debug.

--help -h

Menampilkan pesan bantuan ini dan keluar.

--only-show-errors

Hanya menampilkan kesalahan, menyembunyikan peringatan.

--output -o

Format output.

nilai yang diterima: json, jsonc, none, table, tsv, yaml, yamlc
nilai default: json
--query

String kueri JMESPath. Lihat http://jmespath.org/ untuk informasi selengkapnya beserta contohnya.

--subscription

Nama atau ID langganan. Anda dapat mengonfigurasi langganan default menggunakan az account set -s NAME_OR_ID.

--verbose

Meningkatkan verbositas pengelogan. Gunakan --debug untuk log waktu lengkap.

az vm run-command invoke

Edit

Jalankan perintah jalankan tertentu pada vm.

az vm run-command show mengembalikan informasi bermanfaat pada setiap run-command. Temukan Jalankan command-id melalui az vmss run-command list.

az vm run-command invoke --command-id
                         [--ids]
                         [--name]
                         [--no-wait]
                         [--parameters]
                         [--resource-group]
                         [--scripts]
                         [--subscription]

Contoh

Instal nginx pada VM linux.

az vm run-command invoke -g MyResourceGroup -n MyVm --command-id RunShellScript --scripts "sudo apt-get update && sudo apt-get install -y nginx"

Jalankan perintah shell pada VM linux dengan parameter.

az vm run-command invoke -g MyResourceGroup -n MyVm --command-id RunShellScript --scripts 'echo $1 $2' --parameters hello world

Jalankan skrip powershell pada VM windows dengan parameter. Skrip yang disediakan sebaris. Waspadalah terhadap pengutipan tunggal di CMD.exe.

az vm run-command invoke  --command-id RunPowerShellScript --name win-vm -g my-resource-group  \
    --scripts 'param([string]$arg1,[string]$arg2)' \
    'Write-Host This is a sample script with parameters $arg1 and $arg2' \
    --parameters 'arg1=somefoo' 'arg2=somebar'

Jalankan skrip powershell pada VM windows dengan parameter. Skrip yang disediakan dari file.

# script.ps1
#   param(
#       [string]$arg1,
#       [string]$arg2
#   )
#   Write-Host This is a sample script with parameters $arg1 and $arg2

az vm run-command invoke  --command-id RunPowerShellScript --name win-vm -g my-resource-group \
    --scripts @script.ps1 --parameters "arg1=somefoo" "arg2=somebar"

Parameter yang Diperlukan

--command-id

Id perintah.

nilai dari: az vm run-command list

Parameter Opsional

--ids

Satu atau beberapa ID sumber daya (dibatasi ruang). Ini harus menjadi ID sumber daya lengkap yang berisi semua informasi argumen 'Id Sumber Daya'. Anda harus menyediakan argumen --ids atau 'Resource Id' lainnya.

--name -n

Nama Komputer Virtual. Anda dapat mengonfigurasi default menggunakan az configure --defaults vm=<name>.

--no-wait

Jangan menunggu operasi jangka panjang selesai.

nilai default: False
--parameters

Parameter yang dipisahkan spasi dalam format '[name=]value'.

--resource-group -g

Nama grup sumber daya. Anda dapat mengonfigurasi grup default menggunakan az configure --defaults group=<name>.

--scripts

Baris skrip yang dipisahkan spasi. Gunakan @{file} untuk memuat skrip dari file.

--subscription

Nama atau ID langganan. Anda dapat mengonfigurasi langganan default menggunakan az account set -s NAME_OR_ID.

Parameter Global
--debug

Meningkatkan verbositas pengelogan untuk menampilkan semua log debug.

--help -h

Menampilkan pesan bantuan ini dan keluar.

--only-show-errors

Hanya menampilkan kesalahan, menyembunyikan peringatan.

--output -o

Format output.

nilai yang diterima: json, jsonc, none, table, tsv, yaml, yamlc
nilai default: json
--query

String kueri JMESPath. Lihat http://jmespath.org/ untuk informasi selengkapnya beserta contohnya.

--subscription

Nama atau ID langganan. Anda dapat mengonfigurasi langganan default menggunakan az account set -s NAME_OR_ID.

--verbose

Meningkatkan verbositas pengelogan. Gunakan --debug untuk log waktu lengkap.

az vm run-command list

Edit

Mencantumkan perintah eksekusi dari VM atau lokasi.

Anda dapat menentukan "--resource-group" dan "--vm-name" untuk mendapatkan semua perintah eksekusi komputer virtual. Atau Anda dapat menentukan "--location" untuk mencantumkan semua perintah eksekusi yang tersedia untuk langganan di lokasi.

az vm run-command list [--expand]
                       [--location]
                       [--resource-group]
                       [--vm-name]

Contoh

Mencantumkan perintah eksekusi di komputer virtual.

az vm run-command list --resource-group "myResourceGroup" --vm-name "myVM"

Cantumkan semua perintah eksekusi yang tersedia untuk langganan di lokasi.

az vm run-command list --location "SoutheastAsia"

Parameter Opsional

--expand

Ekspresi perluas untuk diterapkan pada operasi.

--location -l

Lokasi. Nilai dari: az account list-locations. Anda dapat mengonfigurasi lokasi default menggunakan az configure --defaults location=<location>.

--resource-group -g

Nama grup sumber daya. Anda dapat mengonfigurasi grup default menggunakan az configure --defaults group=<name>.

--vm-name

Nama mesin virtual.

Parameter Global
--debug

Meningkatkan verbositas pengelogan untuk menampilkan semua log debug.

--help -h

Menampilkan pesan bantuan ini dan keluar.

--only-show-errors

Hanya menampilkan kesalahan, menyembunyikan peringatan.

--output -o

Format output.

nilai yang diterima: json, jsonc, none, table, tsv, yaml, yamlc
nilai default: json
--query

String kueri JMESPath. Lihat http://jmespath.org/ untuk informasi selengkapnya beserta contohnya.

--subscription

Nama atau ID langganan. Anda dapat mengonfigurasi langganan default menggunakan az account set -s NAME_OR_ID.

--verbose

Meningkatkan verbositas pengelogan. Gunakan --debug untuk log waktu lengkap.

az vm run-command show

Edit

Dapatkan perintah jalankan tertentu.

Anda dapat menentukan "--resource-group", "--run-command-name" dan "--vm-name" untuk mendapatkan perintah eksekusi di komputer virtual. Atau Anda dapat menentukan "--command-id" dan "--location" untuk mendapatkan perintah eksekusi untuk langganan di lokasi.

az vm run-command show [--command-id]
                       [--ids]
                       [--instance-view]
                       [--location]
                       [--name]
                       [--resource-group]
                       [--subscription]
                       [--vm-name]

Contoh

Dapatkan perintah jalankan di komputer virtual.

az vm run-command show --resource-group "myResourceGroup" --run-command-name "myRunCommand" --vm-name "myVM"

Dapatkan perintah jalankan tertentu untuk langganan di lokasi.

az vm run-command show --command-id "RunPowerShellScript" --location "SoutheastAsia"

Parameter Opsional

--command-id

Id perintah.

--ids

Satu atau beberapa ID sumber daya (dibatasi ruang). Ini harus menjadi ID sumber daya lengkap yang berisi semua informasi argumen 'Id Sumber Daya'. Anda harus menyediakan argumen --ids atau 'Resource Id' lainnya.

--instance-view

Tampilan instans perintah jalankan.

nilai default: False
--location -l

Lokasi. Nilai dari: az account list-locations. Anda dapat mengonfigurasi lokasi default menggunakan az configure --defaults location=<location>.

--name --run-command-name

Nama perintah eksekusi komputer virtual.

--resource-group -g

Nama grup sumber daya. Anda dapat mengonfigurasi grup default menggunakan az configure --defaults group=<name>.

--subscription

Nama atau ID langganan. Anda dapat mengonfigurasi langganan default menggunakan az account set -s NAME_OR_ID.

--vm-name

Nama mesin virtual.

Parameter Global
--debug

Meningkatkan verbositas pengelogan untuk menampilkan semua log debug.

--help -h

Menampilkan pesan bantuan ini dan keluar.

--only-show-errors

Hanya menampilkan kesalahan, menyembunyikan peringatan.

--output -o

Format output.

nilai yang diterima: json, jsonc, none, table, tsv, yaml, yamlc
nilai default: json
--query

String kueri JMESPath. Lihat http://jmespath.org/ untuk informasi selengkapnya beserta contohnya.

--subscription

Nama atau ID langganan. Anda dapat mengonfigurasi langganan default menggunakan az account set -s NAME_OR_ID.

--verbose

Meningkatkan verbositas pengelogan. Gunakan --debug untuk log waktu lengkap.

az vm run-command update

Edit

Operasi untuk memperbarui perintah jalankan.

az vm run-command update --name
                         [--async-execution {false, true}]
                         [--command-id]
                         [--error-blob-uri]
                         [--ids]
                         [--location]
                         [--no-wait]
                         [--output-blob-uri]
                         [--parameters]
                         [--protected-parameters]
                         [--resource-group]
                         [--run-as-password]
                         [--run-as-user]
                         [--script]
                         [--script-uri]
                         [--subscription]
                         [--tags]
                         [--timeout-in-seconds]
                         [--vm-name]

Contoh

Perbarui perintah jalankan.

az vm run-command update --resource-group "myResourceGroup" --location "West US" --async-execution false --parameters arg1=param1 arg2=value1 --run-as-password "<runAsPassword>" --run-as-user "user1" --script "Write-Host Hello World!" --timeout-in-seconds 3600 --run-command-name "myRunCommand" --vm-name "myVM"

Perbarui perintah jalankan dengan mengunggah aliran output skrip ke blob penyimpanan Azure (SAS URI).

az vm run-command update --resource-group "myResourceGroup" --location "West US" --script "Write-Host Hello World!" --run-command-name "myRunCommand" --vm-name "myVM" --output-blob-uri "https://mystorageaccount.blob.core.windows.net/mycontainer/RuncommandOutput.txt?sp=racw&st=2022-10-17T19:02:15Z&se=2022-10-18T03:02:15Z&spr=https&sv=2021-06-08&sr=b&sig=3BxtEasfdasdfasdfdYki9yvYsqc60V0%3D"

Parameter yang Diperlukan

--name --run-command-name

Nama perintah eksekusi komputer virtual.

Parameter Opsional

--async-execution

Opsional. Jika diatur ke true, provisi akan selesai segera setelah skrip dimulai dan tidak akan menunggu skrip selesai.

nilai yang diterima: false, true
--command-id

Tentukan commandId dari skrip bawaan yang telah ditentukan sebelumnya.

--error-blob-uri

Tentukan blob penyimpanan Azure tempat aliran kesalahan skrip akan diunggah.

--ids

Satu atau beberapa ID sumber daya (dibatasi ruang). Ini harus menjadi ID sumber daya lengkap yang berisi semua informasi argumen 'Id Sumber Daya'. Anda harus menyediakan argumen --ids atau 'Resource Id' lainnya.

--location -l

Lokasi. Nilai dari: az account list-locations. Anda dapat mengonfigurasi lokasi default menggunakan az configure --defaults location=<location>.

--no-wait

Jangan menunggu operasi jangka panjang selesai.

nilai default: False
--output-blob-uri

Tentukan blob penyimpanan Azure (SAS URI) tempat aliran output skrip akan diunggah.

--parameters

Parameter yang digunakan oleh skrip.

Penggunaan: --parameters arg1=XX arg2=XX.

--protected-parameters

Parameter yang digunakan oleh skrip.

Penggunaan: --protected-parameters credentials=somefoo secret=somebar.

--resource-group -g

Nama grup sumber daya. Anda dapat mengonfigurasi grup default menggunakan az configure --defaults group=<name>.

--run-as-password

Kata sandi jika diperlukan untuk menggunakan parameter run-as-user. Ini akan dienkripsi dan tidak dicatat.

--run-as-user

Secara default, proses skrip berjalan di bawah sistem/pengguna root. Tentukan pengguna kustom untuk menghosting proses.

--script

Tentukan konten skrip yang akan dijalankan pada VM.

--script-uri

Tentukan lokasi pengunduhan skrip.

--subscription

Nama atau ID langganan. Anda dapat mengonfigurasi langganan default menggunakan az account set -s NAME_OR_ID.

--tags

Tag yang dipisahkan spasi: key[=value] [key[=value] ...]. Gunakan "" untuk menghapus tag yang ada.

--timeout-in-seconds

Batas waktu dalam detik untuk menjalankan perintah jalankan.

--vm-name

Nama mesin virtual.

Parameter Global
--debug

Meningkatkan verbositas pengelogan untuk menampilkan semua log debug.

--help -h

Menampilkan pesan bantuan ini dan keluar.

--only-show-errors

Hanya menampilkan kesalahan, menyembunyikan peringatan.

--output -o

Format output.

nilai yang diterima: json, jsonc, none, table, tsv, yaml, yamlc
nilai default: json
--query

String kueri JMESPath. Lihat http://jmespath.org/ untuk informasi selengkapnya beserta contohnya.

--subscription

Nama atau ID langganan. Anda dapat mengonfigurasi langganan default menggunakan az account set -s NAME_OR_ID.

--verbose

Meningkatkan verbositas pengelogan. Gunakan --debug untuk log waktu lengkap.

az vm run-command wait

Edit

Tempatkan CLI dalam status tunggu hingga kondisi perintah res virtual-machine-run-terpenuhi.

az vm run-command wait [--command-id]
                       [--created]
                       [--custom]
                       [--deleted]
                       [--exists]
                       [--ids]
                       [--instance-view]
                       [--interval]
                       [--location]
                       [--name]
                       [--resource-group]
                       [--subscription]
                       [--timeout]
                       [--updated]
                       [--vm-name]

Parameter Opsional

--command-id

Id perintah.

--created

Tunggu hingga dibuat dengan 'provisioningState' di 'Berhasil'.

nilai default: False
--custom

Tunggu hingga kondisi memenuhi kueri JMESPath kustom. Misalnya provisioningState!='InProgress', instanceView.statuses[?code=='PowerState/running'].

--deleted

Tunggu hingga dihapus.

nilai default: False
--exists

Tunggu hingga sumber daya ada.

nilai default: False
--ids

Satu atau beberapa ID sumber daya (dibatasi ruang). Ini harus menjadi ID sumber daya lengkap yang berisi semua informasi argumen 'Id Sumber Daya'. Anda harus menyediakan argumen --ids atau 'Resource Id' lainnya.

--instance-view

Tampilan instans perintah jalankan.

nilai default: False
--interval

Interval polling dalam hitungan detik.

nilai default: 30
--location -l

Lokasi. Nilai dari: az account list-locations. Anda dapat mengonfigurasi lokasi default menggunakan az configure --defaults location=<location>.

--name --run-command-name

Nama perintah eksekusi komputer virtual.

--resource-group -g

Nama grup sumber daya. Anda dapat mengonfigurasi grup default menggunakan az configure --defaults group=<name>.

--subscription

Nama atau ID langganan. Anda dapat mengonfigurasi langganan default menggunakan az account set -s NAME_OR_ID.

--timeout

Tunggu maksimum dalam detik.

nilai default: 3600
--updated

Tunggu hingga diperbarui dengan provisioningState di 'Berhasil'.

nilai default: False
--vm-name

Nama mesin virtual.

Parameter Global
--debug

Meningkatkan verbositas pengelogan untuk menampilkan semua log debug.

--help -h

Menampilkan pesan bantuan ini dan keluar.

--only-show-errors

Hanya menampilkan kesalahan, menyembunyikan peringatan.

--output -o

Format output.

nilai yang diterima: json, jsonc, none, table, tsv, yaml, yamlc
nilai default: json
--query

String kueri JMESPath. Lihat http://jmespath.org/ untuk informasi selengkapnya beserta contohnya.

--subscription

Nama atau ID langganan. Anda dapat mengonfigurasi langganan default menggunakan az account set -s NAME_OR_ID.

--verbose

Meningkatkan verbositas pengelogan. Gunakan --debug untuk log waktu lengkap.