az connectedmachine run-command

  • Pratinjau
  • Referensi

Catatan

Referensi ini adalah bagian dari ekstensi connectedmachine untuk Azure CLI (versi 2.49.0 atau yang lebih tinggi). Ekstensi akan secara otomatis menginstal pertama kali Anda menjalankan perintah run-command az connectedmachine. Pelajari lebih lanjut tentang ekstensi.

Grup perintah ini dalam pratinjau dan sedang dalam pengembangan. Tingkat referensi dan dukungan: https://aka.ms/CLI_refstatus

Mengelola perintah eksekusi di Server dengan Dukungan Azure Arc.

Perintah

Nama Deskripsi Jenis Status
az connectedmachine run-command create

Buat operasi untuk membuat atau memperbarui perintah jalankan.

 Ekstensi Pratinjau
az connectedmachine run-command delete

Hapus operasi untuk menghapus perintah jalankan.

 Ekstensi Pratinjau
az connectedmachine run-command list

Mencantumkan operasi untuk mendapatkan semua perintah eksekusi komputer non-Azure.

 Ekstensi Pratinjau
az connectedmachine run-command show

Dapatkan operasi untuk mendapatkan perintah jalankan.

 Ekstensi Pratinjau
az connectedmachine run-command update

Perbarui operasi untuk membuat atau memperbarui perintah jalankan.

 Ekstensi Pratinjau
az connectedmachine run-command wait

Tempatkan CLI dalam status tunggu hingga kondisi terpenuhi.

 Ekstensi Pratinjau

az connectedmachine run-command create

Pratinjau

Grup perintah 'az connectedmachine run-command' sedang dalam pratinjau dan sedang dalam pengembangan. Tingkat referensi dan dukungan: https://aka.ms/CLI_refstatus

Buat operasi untuk membuat atau memperbarui perintah jalankan.

az connectedmachine run-command create --machine-name
                                       --name
                                       --resource-group
                                       [--async {0, 1, f, false, n, no, t, true, y, yes}]
                                       [--command-id]
                                       [--error-blob-managed-identity]
                                       [--error-blob-uri]
                                       [--location]
                                       [--no-wait {0, 1, f, false, n, no, t, true, y, yes}]
                                       [--output-blob-managed-identity]
                                       [--output-blob-uri]
                                       [--parameters]
                                       [--password]
                                       [--protected-parameters]
                                       [--run-as-user]
                                       [--script]
                                       [--script-uri]
                                       [--script-uri-managed-id]
                                       [--tags]
                                       [--timeout]

Contoh

Contoh perintah untuk run-command create

az connectedmachine run-command create --resource-group "myResourceGroup" --location "West US" --async false --parameters "[{"name":"param1","value":"value1"}]" --password "<runAsPassword>" --user "user1" --script "Write-Host Hello World!" --timeout 3600 --name "myRunCommand" --machine-name "myMachine" --subscription "mySubscription"
az connectedmachine run-command create --resource-group "myResourceGroup" --location "West US" --script "Write-Host Hello World!" --name "myRunCommand" --machine-name "myMachine" --output-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" --subscription "mySubscription"

Parameter yang Diperlukan

--machine-name

Nama mesin hibrid.

--name --run-command-name -n

Nama perintah jalankan.

--resource-group -g

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

Parameter Opsional

--async --async-execution

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

nilai yang diterima: 0, 1, f, false, n, no, t, true, y, yes
nilai default: False
--command-id

Menentukan commandId dari skrip bawaan yang telah ditentukan sebelumnya.

--error-blob-managed-identity --error-id

Identitas terkelola yang ditetapkan pengguna yang memiliki akses ke blob penyimpanan errorBlobUri. Gunakan objek kosong jika identitas yang ditetapkan sistem. Pastikan identitas terkelola telah diberikan akses ke kontainer blob dengan penetapan peran 'Kontributor Data Blob Penyimpanan'. Dalam kasus identitas yang ditetapkan pengguna, pastikan Anda menambahkannya di bawah identitas VM. Untuk informasi selengkapnya tentang identitas terkelola dan Jalankan Perintah, lihat https://aka.ms/ManagedIdentity dan https://aka.ms/RunCommandManaged Dukung shorthand-sintaks, json-file dan yaml-file. Coba "??" untuk menunjukkan lebih banyak.

--error-blob-uri --error-uri

Menentukan blob penyimpanan Azure tempat aliran kesalahan skrip akan diunggah. Gunakan URI SAS dengan baca, tambahkan, buat, tulis akses ATAU gunakan identitas terkelola untuk menyediakan akses VM ke blob. Lihat parameter errorBlobManagedIdentity.

--location -l

Lokasi geografis tempat sumber daya berada Ketika tidak ditentukan, lokasi grup sumber daya akan digunakan.

--no-wait

Jangan menunggu operasi jangka panjang selesai.

nilai yang diterima: 0, 1, f, false, n, no, t, true, y, yes
--output-blob-managed-identity --output-id

Identitas terkelola yang ditetapkan pengguna yang memiliki akses ke blob penyimpanan outputBlobUri. Gunakan objek kosong jika identitas yang ditetapkan sistem. Pastikan identitas terkelola telah diberikan akses ke kontainer blob dengan penetapan peran 'Kontributor Data Blob Penyimpanan'. Dalam kasus identitas yang ditetapkan pengguna, pastikan Anda menambahkannya di bawah identitas VM. Untuk informasi selengkapnya tentang identitas terkelola dan Jalankan Perintah, lihat https://aka.ms/ManagedIdentity dan https://aka.ms/RunCommandManaged Dukung shorthand-sintaks, json-file dan yaml-file. Coba "??" untuk menunjukkan lebih banyak.

--output-blob-uri --output-uri

Menentukan blob penyimpanan Azure tempat aliran output skrip akan diunggah. Gunakan URI SAS dengan baca, tambahkan, buat, tulis akses ATAU gunakan identitas terkelola untuk menyediakan akses VM ke blob. Lihat parameter outputBlobManagedIdentity.

--parameters

Parameter yang digunakan oleh skrip. Mendukung shorthand-sintaks, json-file dan yaml-file. Coba "??" untuk menunjukkan lebih banyak.

--password --run-as-password

Menentukan kata sandi akun pengguna pada komputer saat menjalankan perintah jalankan.

--protected-parameters

Parameter yang digunakan oleh skrip. Mendukung shorthand-sintaks, json-file dan yaml-file. Coba "??" untuk menunjukkan lebih banyak.

--run-as-user --user

Menentukan akun pengguna pada komputer saat menjalankan perintah jalankan.

--script

Menentukan konten skrip yang akan dijalankan pada komputer.

--script-uri

Menentukan lokasi pengunduhan skrip. Ini dapat berupa URI SAS dari blob penyimpanan Azure dengan akses baca atau URI publik.

--script-uri-managed-id --script-uri-managed-identity

Identitas terkelola yang ditetapkan pengguna yang memiliki akses ke scriptUri jika terjadi blob penyimpanan Azure. Gunakan objek kosong jika identitas yang ditetapkan sistem. Pastikan blob penyimpanan Azure ada, dan identitas terkelola telah diberikan akses ke kontainer blob dengan penetapan peran 'Pembaca Data Blob Penyimpanan'. Dalam kasus identitas yang ditetapkan pengguna, pastikan Anda menambahkannya di bawah identitas VM. Untuk informasi selengkapnya tentang identitas terkelola dan Jalankan Perintah, lihat https://aka.ms/ManagedIdentity dan https://aka.ms/RunCommandManaged. Mendukung shorthand-sintaks, json-file dan yaml-file. Coba "??" untuk menunjukkan lebih banyak.

--tags

Tag sumber daya. Mendukung shorthand-sintaks, json-file dan yaml-file. Coba "??" untuk menunjukkan lebih banyak.

--timeout --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 connectedmachine run-command delete

Pratinjau

Grup perintah 'az connectedmachine run-command' sedang dalam pratinjau dan sedang dalam pengembangan. Tingkat referensi dan dukungan: https://aka.ms/CLI_refstatus

Hapus operasi untuk menghapus perintah jalankan.

az connectedmachine run-command delete [--ids]
                                       [--machine-name]
                                       [--name]
                                       [--no-wait {0, 1, f, false, n, no, t, true, y, yes}]
                                       [--resource-group]
                                       [--subscription]
                                       [--yes]

Contoh

Contoh perintah untuk penghapusan run-command

az connectedmachine run-command delete --resource-group "myResourceGroup" --name "myRunCommand" --machine-name "myMachine"

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.

--machine-name

Nama mesin hibrid.

--name --run-command-name -n

Nama perintah jalankan.

--no-wait

Jangan menunggu operasi jangka panjang selesai.

nilai yang diterima: 0, 1, f, false, n, no, t, true, y, yes
--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.

--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 connectedmachine run-command list

Pratinjau

Grup perintah 'az connectedmachine run-command' sedang dalam pratinjau dan sedang dalam pengembangan. Tingkat referensi dan dukungan: https://aka.ms/CLI_refstatus

Mencantumkan operasi untuk mendapatkan semua perintah eksekusi komputer non-Azure.

az connectedmachine run-command list --machine-name
                                     --resource-group
                                     [--expand]

Contoh

Contoh perintah untuk daftar run-command

az connectedmachine run-command list --resource-group "myResourceGroup" --machine-name "myMachine"

Parameter yang Diperlukan

--machine-name

Nama mesin hibrid.

--resource-group -g

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

Parameter Opsional

--expand

Ekspresi perluas untuk diterapkan pada operasi.

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 connectedmachine run-command show

Pratinjau

Grup perintah 'az connectedmachine run-command' sedang dalam pratinjau dan sedang dalam pengembangan. Tingkat referensi dan dukungan: https://aka.ms/CLI_refstatus

Dapatkan operasi untuk mendapatkan perintah jalankan.

az connectedmachine run-command show [--ids]
                                     [--machine-name]
                                     [--name]
                                     [--resource-group]
                                     [--subscription]

Contoh

Contoh perintah untuk run-command show

az connectedmahine run-command show --resource-group "myResourceGroup" --name "myRunCommand" --machine-name "myMachine"

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.

--machine-name

Nama mesin hibrid.

--name --run-command-name -n

Nama perintah jalankan.

--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.

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 connectedmachine run-command update

Pratinjau

Grup perintah 'az connectedmachine run-command' sedang dalam pratinjau dan sedang dalam pengembangan. Tingkat referensi dan dukungan: https://aka.ms/CLI_refstatus

Perbarui operasi untuk membuat atau memperbarui perintah jalankan.

az connectedmachine run-command update [--add]
                                       [--async {0, 1, f, false, n, no, t, true, y, yes}]
                                       [--error-blob-managed-identity]
                                       [--error-blob-uri]
                                       [--force-string {0, 1, f, false, n, no, t, true, y, yes}]
                                       [--ids]
                                       [--machine-name]
                                       [--name]
                                       [--no-wait {0, 1, f, false, n, no, t, true, y, yes}]
                                       [--output-blob-managed-identity]
                                       [--output-blob-uri]
                                       [--parameters]
                                       [--password]
                                       [--protected-parameters]
                                       [--remove]
                                       [--resource-group]
                                       [--run-as-user]
                                       [--set]
                                       [--source]
                                       [--subscription]
                                       [--tags]
                                       [--timeout]

Contoh

Contoh perintah untuk pembaruan run-command

az connetcedmachine run-command update --resource-group "myResourceGroup" --name "myRunCommand" --machine-name "myMachine" --subscription "mySubscription" --tags Tag1=Value1

Parameter Opsional

--add

Tambahkan objek ke daftar objek dengan menentukan jalur dan pasangan nilai kunci. Contoh: --add property.listProperty <key=value, string, atau string JSON>.

--async --async-execution

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

nilai yang diterima: 0, 1, f, false, n, no, t, true, y, yes
--error-blob-managed-identity --error-id

Identitas terkelola yang ditetapkan pengguna yang memiliki akses ke blob penyimpanan errorBlobUri. Gunakan objek kosong jika identitas yang ditetapkan sistem. Pastikan identitas terkelola telah diberikan akses ke kontainer blob dengan penetapan peran 'Kontributor Data Blob Penyimpanan'. Dalam kasus identitas yang ditetapkan pengguna, pastikan Anda menambahkannya di bawah identitas VM. Untuk informasi selengkapnya tentang identitas terkelola dan Jalankan Perintah, lihat https://aka.ms/ManagedIdentity dan https://aka.ms/RunCommandManaged Dukung shorthand-sintaks, json-file dan yaml-file. Coba "??" untuk menunjukkan lebih banyak.

--error-blob-uri --error-uri

Menentukan blob penyimpanan Azure tempat aliran kesalahan skrip akan diunggah. Gunakan URI SAS dengan baca, tambahkan, buat, tulis akses ATAU gunakan identitas terkelola untuk menyediakan akses VM ke blob. Lihat parameter errorBlobManagedIdentity.

--force-string

Saat menggunakan 'set' atau 'add', pertahankan literal string alih-alih mencoba mengonversi ke JSON.

nilai yang diterima: 0, 1, f, false, n, no, t, true, y, yes
--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.

--machine-name

Nama mesin hibrid.

--name --run-command-name -n

Nama perintah jalankan.

--no-wait

Jangan menunggu operasi jangka panjang selesai.

nilai yang diterima: 0, 1, f, false, n, no, t, true, y, yes
--output-blob-managed-identity --output-id

Identitas terkelola yang ditetapkan pengguna yang memiliki akses ke blob penyimpanan outputBlobUri. Gunakan objek kosong jika identitas yang ditetapkan sistem. Pastikan identitas terkelola telah diberikan akses ke kontainer blob dengan penetapan peran 'Kontributor Data Blob Penyimpanan'. Dalam kasus identitas yang ditetapkan pengguna, pastikan Anda menambahkannya di bawah identitas VM. Untuk informasi selengkapnya tentang identitas terkelola dan Jalankan Perintah, lihat https://aka.ms/ManagedIdentity dan https://aka.ms/RunCommandManaged Dukung shorthand-sintaks, json-file dan yaml-file. Coba "??" untuk menunjukkan lebih banyak.

--output-blob-uri --output-uri

Menentukan blob penyimpanan Azure tempat aliran output skrip akan diunggah. Gunakan URI SAS dengan baca, tambahkan, buat, tulis akses ATAU gunakan identitas terkelola untuk menyediakan akses VM ke blob. Lihat parameter outputBlobManagedIdentity.

--parameters

Parameter yang digunakan oleh skrip. Mendukung shorthand-sintaks, json-file dan yaml-file. Coba "??" untuk menunjukkan lebih banyak.

--password --run-as-password

Menentukan kata sandi akun pengguna pada komputer saat menjalankan perintah jalankan.

--protected-parameters

Parameter yang digunakan oleh skrip. Mendukung shorthand-sintaks, json-file dan yaml-file. Coba "??" untuk menunjukkan lebih banyak.

--remove

Menghapus properti atau elemen dari daftar. Contoh: --remove property.list OR --remove propertyToRemove.

--resource-group -g

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

--run-as-user --user

Menentukan akun pengguna pada komputer saat menjalankan perintah jalankan.

--set

Perbarui objek dengan menentukan jalur properti dan nilai yang akan diatur. Contoh: --set property1.property2=.

--source

Sumber skrip perintah eksekusi. Mendukung shorthand-sintaks, json-file dan yaml-file. Coba "??" untuk menunjukkan lebih banyak.

--subscription

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

--tags

Tag sumber daya. Mendukung shorthand-sintaks, json-file dan yaml-file. Coba "??" untuk menunjukkan lebih banyak.

--timeout --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 connectedmachine run-command wait

Pratinjau

Grup perintah 'az connectedmachine run-command' sedang dalam pratinjau dan sedang dalam pengembangan. Tingkat referensi dan dukungan: https://aka.ms/CLI_refstatus

Tempatkan CLI dalam status tunggu hingga kondisi terpenuhi.

az connectedmachine run-command wait [--created]
                                     [--custom]
                                     [--deleted]
                                     [--exists]
                                     [--ids]
                                     [--interval]
                                     [--machine-name]
                                     [--name]
                                     [--resource-group]
                                     [--subscription]
                                     [--timeout]
                                     [--updated]

Parameter Opsional

--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.

--interval

Interval polling dalam hitungan detik.

nilai default: 30
--machine-name

Nama mesin hibrid.

--name --run-command-name -n

Nama perintah jalankan.

--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
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.