Bagikan melalui

az devcenter admin pool

  • Referensi

Catatan

Referensi ini adalah bagian dari ekstensi devcenter untuk Azure CLI (versi 2.67.0 atau yang lebih tinggi). Ekstensi akan secara otomatis menginstal pertama kali Anda menjalankan perintah az devcenter admin pool . Pelajari lebih lanjut tentang ekstensi.

Mengelola kumpulan.

Perintah

Nama Deskripsi Jenis Status
az devcenter admin pool create

Buat kumpulan.

 Ekstensi GA
az devcenter admin pool delete

Menghapus kumpulan.

 Ekstensi GA
az devcenter admin pool list

Mencantumkan kumpulan untuk proyek.

 Ekstensi GA
az devcenter admin pool run-health-check

Memicu refresh status kumpulan.

 Ekstensi GA
az devcenter admin pool show

Dapatkan kolam renang.

 Ekstensi GA
az devcenter admin pool update

Memperbarui kumpulan.

 Ekstensi GA
az devcenter admin pool wait

Tempatkan CLI dalam status tunggu hingga kondisi terpenuhi.

 Ekstensi GA

az devcenter admin pool create

Buat kumpulan.

az devcenter admin pool create --local-administrator {Disabled, Enabled}
                               --name
                               --project
                               --resource-group
                               [--devbox-definition-image-reference]
                               [--devbox-definition-name]
                               [--devbox-definition-sku]
                               [--devbox-definition-type {Reference, Value}]
                               [--display-name]
                               [--location]
                               [--managed-virtual-network-regions]
                               [--network-connection-name]
                               [--no-wait {0, 1, f, false, n, no, t, true, y, yes}]
                               [--single-sign-on-status {Disabled, Enabled}]
                               [--stop-on-disconnect]
                               [--stop-on-no-connect]
                               [--tags]
                               [--virtual-network-type {Managed, Unmanaged}]

Contoh

Membuat kumpulan menggunakan jaringan yang tidak dikelola

az devcenter admin pool create --location "eastus" --devbox-definition-name "WebDevBox" --network-connection-name "Network1-westus2" --pool-name "DevPool" --project-name "DevProject" --resource-group "rg1" --local-administrator "Enabled" --virtual-network-type "Unmanaged" --single-sign-on-status "Enabled"

Membuat kumpulan menggunakan jaringan terkelola

az devcenter admin pool create --location "eastus" --devbox-definition-name "WebDevBox" --network-connection-name "Network1-westus2" --pool-name "DevPool" --project-name "DevProject" --resource-group "rg1" --local-administrator "Enabled" --virtual-network-type "Managed" --managed-virtual-network-region ["westus3"] --single-sign-on-status "Enabled"

Membuat kumpulan dengan berhenti pada pemutusan sambungan diaktifkan

az devcenter admin pool create --location "eastus" --devbox-definition-name "WebDevBox" --network-connection-name "Network1-westus2" --pool-name "DevPool" --project-name "DevProject" --resource-group "rg1" --local-administrator "Enabled" --virtual-network-type "Unmanaged" --single-sign-on-status "Enabled" --stop-on-disconnect status="Enabled" grace-period-minutes="60"

Membuat kumpulan menggunakan definisi gambar

az devcenter admin pool create --location "eastus" --network-connection-name "Network1-westus2" --pool-name "DevPool" --project-name "DevProject" --resource-group "rg1" --local-administrator "Enabled" --virtual-network-type "Unmanaged" --single-sign-on-status "Enabled" --devbox-definition-type "Value" --devbox-definition-image-reference id="/subscriptions/0ac520ee-14c0-480f-b6c9-0a90c58ffff/resourceGroups/rg1/providers/Microsoft.DevCenter/projects/DevProject/images/~Catalog~image2~project-sample-2" --devbox-definition-sku name=""general_i_8c32gb256ssd_v2"

Parameter yang Diperlukan

--local-administrator

Menunjukkan apakah pemilik kotak dev di kumpulan ini ditambahkan sebagai administrator lokal pada kotak dev.

Nilai yang diterima: Disabled, Enabled
--name --pool-name -n

Nama kumpulan.

--project --project-name

Nama proyek. Gunakan az configure -d project=<project_name> untuk mengonfigurasi default.

--resource-group -g

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

Parameter Opsional

--devbox-definition-image-reference -i
Pratinjau

Informasi referensi gambar untuk definisi komputer yang dibuat dari kumpulan ini. Akan diabaikan jika parameter devbox-definition-type adalah Referensi atau tidak disediakan. Mendukung shorthand-sintaks, json-file dan yaml-file. Coba "??" untuk menunjukkan lebih banyak.

--devbox-definition-name -d

Nama definisi kotak pengembangan dalam proyek induk kumpulan ini. Akan diabaikan jika parameter devbox-definition-type adalah Value.

--devbox-definition-sku -s
Pratinjau

SKU untuk Dev Box yang dibuat dari Kumpulan. Akan diabaikan jika parameter devbox-definition-type adalah Referensi atau tidak disediakan. Mendukung shorthand-sintaks, json-file dan yaml-file. Coba "??" untuk menunjukkan lebih banyak.

--devbox-definition-type -t

Menunjukkan apakah kumpulan dibuat dari Definisi Dev Box yang ada atau jika kumpulan disediakan secara langsung.

Nilai yang diterima: Reference, Value
--display-name

Nama tampilan kumpulan.

--location -l

Lokasi geografis tempat sumber daya berada. Nilai dari: az account list-locations. Anda dapat mengonfigurasi lokasi default menggunakan az configure --defaults location=<location>. Ketika tidak ditentukan, lokasi grup sumber daya akan digunakan.

--managed-virtual-network-regions -m

Wilayah jaringan virtual terkelola (diperlukan saat managedNetworkType Dikelola). Mendukung shorthand-sintaks, json-file dan yaml-file. Coba "??" untuk menunjukkan lebih banyak.

--network-connection-name -c

Nama koneksi jaringan dalam proyek induk kumpulan ini.

--no-wait

Jangan menunggu operasi jangka panjang selesai.

Nilai yang diterima: 0, 1, f, false, n, no, t, true, y, yes
--single-sign-on-status

Menunjukkan apakah Dev Boxes di kumpulan ini dibuat dengan akses menyeluruh diaktifkan. juga mengharuskan akses menyeluruh diaktifkan pada penyewa.

Nilai yang diterima: Disabled, Enabled
--stop-on-disconnect

Hentikan pemutusan pengaturan konfigurasi untuk kotak dev yang dibuat di kumpulan ini. Mendukung shorthand-sintaks, json-file dan yaml-file. Coba "??" untuk menunjukkan lebih banyak.

--stop-on-no-connect
Pratinjau

Hentikan tidak ada pengaturan konfigurasi sambungkan untuk Dev Boxes yang dibuat di kumpulan ini. 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.

--virtual-network-type

Menunjukkan apakah kumpulan menggunakan Virtual Network yang dikelola oleh Microsoft atau jaringan yang disediakan pelanggan.

Nilai yang diterima: Managed, Unmanaged
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 devcenter admin pool delete

Menghapus kumpulan.

az devcenter admin pool delete [--ids]
                               [--name]
                               [--no-wait {0, 1, f, false, n, no, t, true, y, yes}]
                               [--project]
                               [--resource-group]
                               [--subscription]
                               [--yes]

Contoh

Hapus

az devcenter admin pool delete --name "DevPool" --project-name "DevProject" --resource-group "rg1"

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 --pool-name -n

Nama kumpulan.

--no-wait

Jangan menunggu operasi jangka panjang selesai.

Nilai yang diterima: 0, 1, f, false, n, no, t, true, y, yes
--project --project-name

Nama proyek. Gunakan az configure -d project=<project_name> untuk mengonfigurasi default.

--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 devcenter admin pool list

Mencantumkan kumpulan untuk proyek.

az devcenter admin pool list --project
                             --resource-group
                             [--max-items]
                             [--next-token]

Contoh

List

az devcenter admin pool list --project-name "DevProject" --resource-group "rg1"

Parameter yang Diperlukan

--project --project-name

Nama proyek. Gunakan az configure -d project=<project_name> untuk mengonfigurasi default.

--resource-group -g

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

Parameter Opsional

--max-items

Jumlah total item yang akan dikembalikan dalam output perintah. Jika jumlah total item yang tersedia lebih dari nilai yang ditentukan, token disediakan dalam output perintah. Untuk melanjutkan penomoran halaman, berikan nilai token dalam --next-token argumen perintah berikutnya.

--next-token

Token untuk menentukan tempat untuk memulai paginating. Ini adalah nilai token dari respons yang dipotong sebelumnya.

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 devcenter admin pool run-health-check

Memicu refresh status kumpulan.

az devcenter admin pool run-health-check [--ids]
                                         [--name]
                                         [--no-wait {0, 1, f, false, n, no, t, true, y, yes}]
                                         [--project]
                                         [--resource-group]
                                         [--subscription]

Contoh

Jalankan pemeriksaan kesehatan

az devcenter admin pool run-health-check --name "DevPool" --project-name "DevProject" --resource-group "rg1"

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 --pool-name -n

Nama kumpulan.

--no-wait

Jangan menunggu operasi jangka panjang selesai.

Nilai yang diterima: 0, 1, f, false, n, no, t, true, y, yes
--project --project-name

Nama proyek. Gunakan az configure -d project=<project_name> untuk mengonfigurasi default.

--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 devcenter admin pool show

Dapatkan kolam renang.

az devcenter admin pool show [--ids]
                             [--name]
                             [--project]
                             [--resource-group]
                             [--subscription]

Contoh

Dapatkan

az admin pool show --name "DevPool" --project-name "DevProject" --resource-group "rg1"

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 --pool-name -n

Nama kumpulan.

--project --project-name

Nama proyek. Gunakan az configure -d project=<project_name> untuk mengonfigurasi default.

--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 devcenter admin pool update

Memperbarui kumpulan.

az devcenter admin pool update [--add]
                               [--devbox-definition-image-reference]
                               [--devbox-definition-name]
                               [--devbox-definition-sku]
                               [--devbox-definition-type {Reference, Value}]
                               [--display-name]
                               [--force-string {0, 1, f, false, n, no, t, true, y, yes}]
                               [--ids]
                               [--local-administrator {Disabled, Enabled}]
                               [--managed-virtual-network-regions]
                               [--name]
                               [--network-connection-name]
                               [--no-wait {0, 1, f, false, n, no, t, true, y, yes}]
                               [--project]
                               [--remove]
                               [--resource-group]
                               [--set]
                               [--single-sign-on-status {Disabled, Enabled}]
                               [--stop-on-disconnect]
                               [--stop-on-no-connect]
                               [--subscription]
                               [--tags]
                               [--virtual-network-type {Managed, Unmanaged}]

Contoh

Pembaruan

az devcenter admin pool update --devbox-definition-name "WebDevBox2" --pool-name "DevPool" --project-name "DevProject" --resource-group "rg1" --stop-on-disconnect status="Disabled"

Parameter Opsional

--add

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

--devbox-definition-image-reference -i
Pratinjau

Informasi referensi gambar untuk definisi komputer yang dibuat dari kumpulan ini. Akan diabaikan jika parameter devbox-definition-type adalah Referensi atau tidak disediakan. Mendukung shorthand-sintaks, json-file dan yaml-file. Coba "??" untuk menunjukkan lebih banyak.

--devbox-definition-name -d

Nama definisi kotak pengembangan dalam proyek induk kumpulan ini. Akan diabaikan jika parameter devbox-definition-type adalah Value.

--devbox-definition-sku -s
Pratinjau

SKU untuk Dev Box yang dibuat dari Kumpulan. Akan diabaikan jika parameter devbox-definition-type adalah Referensi atau tidak disediakan. Mendukung shorthand-sintaks, json-file dan yaml-file. Coba "??" untuk menunjukkan lebih banyak.

--devbox-definition-type -t

Menunjukkan apakah kumpulan dibuat dari Definisi Dev Box yang ada atau jika kumpulan disediakan secara langsung.

Nilai yang diterima: Reference, Value
--display-name

Nama tampilan kumpulan.

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

--local-administrator

Menunjukkan apakah pemilik kotak dev di kumpulan ini ditambahkan sebagai administrator lokal pada kotak dev.

Nilai yang diterima: Disabled, Enabled
--managed-virtual-network-regions -m

Wilayah jaringan virtual terkelola (diperlukan saat managedNetworkType Dikelola). Mendukung shorthand-sintaks, json-file dan yaml-file. Coba "??" untuk menunjukkan lebih banyak.

--name --pool-name -n

Nama kumpulan.

--network-connection-name -c

Nama koneksi jaringan dalam proyek induk kumpulan ini.

--no-wait

Jangan menunggu operasi jangka panjang selesai.

Nilai yang diterima: 0, 1, f, false, n, no, t, true, y, yes
--project --project-name

Nama proyek. Gunakan az configure -d project=<project_name> untuk mengonfigurasi default.

--remove

Menghapus properti atau elemen dari daftar. Contoh: --remove property.list <indexToRemove> ATAU --remove propertyToRemove.

--resource-group -g

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

--set

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

--single-sign-on-status

Menunjukkan apakah Dev Boxes di kumpulan ini dibuat dengan akses menyeluruh diaktifkan. juga mengharuskan akses menyeluruh diaktifkan pada penyewa.

Nilai yang diterima: Disabled, Enabled
--stop-on-disconnect

Hentikan pemutusan pengaturan konfigurasi untuk kotak dev yang dibuat di kumpulan ini. Mendukung shorthand-sintaks, json-file dan yaml-file. Coba "??" untuk menunjukkan lebih banyak.

--stop-on-no-connect
Pratinjau

Hentikan tidak ada pengaturan konfigurasi sambungkan untuk Dev Boxes yang dibuat di kumpulan ini. 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.

--virtual-network-type

Menunjukkan apakah kumpulan menggunakan Virtual Network yang dikelola oleh Microsoft atau jaringan yang disediakan pelanggan.

Nilai yang diterima: Managed, Unmanaged
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 devcenter admin pool wait

Tempatkan CLI dalam status tunggu hingga kondisi terpenuhi.

az devcenter admin pool wait [--created]
                             [--custom]
                             [--deleted]
                             [--exists]
                             [--ids]
                             [--interval]
                             [--name]
                             [--project]
                             [--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
--name --pool-name -n

Nama kumpulan.

--project --project-name

Nama proyek. Gunakan az configure -d project=<project_name> untuk mengonfigurasi default.

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