Bagikan melalui


az blueprint assignment

Catatan

Referensi ini adalah bagian dari ekstensi cetak biru untuk Azure CLI (versi 2.50.0 atau yang lebih tinggi). Ekstensi akan secara otomatis menginstal pertama kali Anda menjalankan perintah penetapan cetak biru az. Pelajari lebih lanjut tentang ekstensi.

Perintah untuk mengelola penetapan cetak biru.

Perintah

Nama Deskripsi Jenis Status
az blueprint assignment create

Buat penetapan cetak biru.

Ekstensi GA
az blueprint assignment delete

Menghapus penetapan cetak biru.

Ekstensi Pratinjau
az blueprint assignment list

Mencantumkan penetapan cetak biru dalam langganan.

Ekstensi Pratinjau
az blueprint assignment show

Dapatkan penetapan cetak biru.

Ekstensi Pratinjau
az blueprint assignment update

Perbarui penetapan cetak biru.

Ekstensi GA
az blueprint assignment wait

Tempatkan CLI dalam status tunggu hingga kondisi Penetapan Cetak Biru terpenuhi.

Ekstensi GA
az blueprint assignment who

Dapatkan ObjectId Nama Prinsipal Blueprint Servie.

Ekstensi Pratinjau

az blueprint assignment create

Buat penetapan cetak biru.

az blueprint assignment create --name
                               [--blueprint-version]
                               [--description]
                               [--display-name]
                               [--identity-type {None, SystemAssigned, UserAssigned}]
                               [--location]
                               [--locks-excluded-principals]
                               [--locks-mode {AllResourcesDoNotDelete, AllResourcesReadOnly, None}]
                               [--management-group]
                               [--parameters]
                               [--resource-group-value]
                               [--subscription]
                               [--user-assigned-identity]

Contoh

Penugasan dengan identitas terkelola yang ditetapkan sistem

az blueprint assignment create --subscription MySubscription --name \
MyBlueprintAssignment --location eastus --identity-type SystemAssigned \
--description "Enforce pre-defined MyBlueprint to this subscription." \
--blueprint-version "/providers/Microsoft.Management/managementGroups/ContosoOnlineGroup/provid \
ers/Microsoft.Blueprint/blueprints/MyBlueprint/versions/v2" \
--resource-group-value artifact_name=rg-art-1 name=rg1 location=westus \
--resource-group-value artifact_name=rg-art-2 name=rg2 location=eastus \
--parameters "path/to/parameter/file" \

Penugasan dengan identitas terkelola yang ditetapkan pengguna

az blueprint assignment create --subscription MySubscription --name \
MyBlueprintAssignment --location eastus --identity-type UserAssigned \
--user-assigned-identity "/subscriptions/00000000-0000-0000-0000-000000000000 \
/resourcegroups/myResourceGroup/providers/Microsoft.ManagedIdentity/userAssignedIdentities/myIdentity"\
--description "Enforce pre-defined MyBlueprint to this subscription." \
--blueprint-version "/providers/Microsoft.Management/managementGroups/ContosoOnlineGroup \
/providers/Microsoft.Blueprint/blueprints/MyBlueprint/versions/v2" \
--resource-group-value artifact_name=rg-art-1 name=rg1 location=eastus \
--parameters "path/to/parameter/file" \

Parameter yang Diperlukan

--name -n

Nama penetapan cetak biru.

Parameter Opsional

--blueprint-version

ID sumber daya dari versi definisi cetak biru yang diterbitkan.

--description

Multibaris menjelaskan sumber daya ini.

--display-name

String satu baris menjelaskan sumber daya ini.

--identity-type

Jenis identitas terkelola.

Nilai yang diterima: None, SystemAssigned, UserAssigned
Nilai default: SystemAssigned
--location -l

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

--locks-excluded-principals

Daftar prinsipal AAD yang dikecualikan dari kunci cetak biru. Hingga 5 prinsipal diizinkan.

--locks-mode

Mode kunci.

Nilai yang diterima: AllResourcesDoNotDelete, AllResourcesReadOnly, None
--management-group -m

Gunakan grup manajemen untuk cakupan target penetapan cetak biru. Ini dicadangkan untuk digunakan di masa mendatang. Gunakan --subscription sebagai gantinya.

--parameters -p

Nilai parameter penetapan cetak biru. Ini bisa berupa string JSON atau jalur file JSON.

--resource-group-value

Pasangan Key=Value untuk grup sumber daya. Kunci termasuk 'artifact_name'(wajib), 'nama', 'lokasi'.

--subscription -s

Gunakan langganan untuk cakupan target penetapan cetak biru. Susbcripsi default akan digunakan jika opsi tidak ditentukan.

--user-assigned-identity

Identitas terkelola yang ditetapkan pengguna yang terkait dengan sumber daya.

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 blueprint assignment delete

Pratinjau

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

Menghapus penetapan cetak biru.

az blueprint assignment delete --name
                               [--delete-behavior {all, none}]
                               [--management-group]
                               [--subscription]
                               [--yes]

Contoh

Menghapus penugasan

az blueprint assignment delete --subscription MySubscription --name MyBlueprintAssignment

Parameter yang Diperlukan

--name -n

Nama penetapan cetak biru.

Parameter Opsional

--delete-behavior

Saat deleteBehavior=all, sumber daya yang dibuat oleh penetapan cetak biru akan dihapus.

Nilai yang diterima: all, none
--management-group -m

Gunakan grup manajemen untuk cakupan cetak biru.

--subscription -s

Gunakan langganan untuk cakupan cetak biru. Jika --management-group tidak ditentukan, --nilai langganan atau langganan default akan digunakan sebagai cakupan.

--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 blueprint assignment list

Pratinjau

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

Mencantumkan penetapan cetak biru dalam langganan.

az blueprint assignment list [--management-group]
                             [--max-items]
                             [--next-token]
                             [--subscription]

Contoh

Mencantumkan penetapan

az blueprint assignment list --subscription MySubscription

Parameter Opsional

--management-group -m

Gunakan grup manajemen untuk cakupan cetak biru.

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

--subscription -s

Gunakan langganan untuk cakupan cetak biru. Jika --management-group tidak ditentukan, --nilai langganan atau langganan default akan digunakan sebagai cakupan.

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 blueprint assignment show

Pratinjau

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

Dapatkan penetapan cetak biru.

az blueprint assignment show --name
                             [--management-group]
                             [--subscription]

Contoh

Perlihatkan penugasan

az blueprint assignment show --subscription MySubscription --name MyBlueprintAssignment

Parameter yang Diperlukan

--name -n

Nama penetapan cetak biru.

Parameter Opsional

--management-group -m

Gunakan grup manajemen untuk cakupan cetak biru.

--subscription -s

Gunakan langganan untuk cakupan cetak biru. Jika --management-group tidak ditentukan, --nilai langganan atau langganan default akan digunakan sebagai cakupan.

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 blueprint assignment update

Perbarui penetapan cetak biru.

az blueprint assignment update --name
                               [--blueprint-version]
                               [--description]
                               [--display-name]
                               [--identity-type {None, SystemAssigned, UserAssigned}]
                               [--location]
                               [--locks-excluded-principals]
                               [--locks-mode {AllResourcesDoNotDelete, AllResourcesReadOnly, None}]
                               [--management-group]
                               [--parameters]
                               [--resource-group-value]
                               [--subscription]
                               [--user-assigned-identity]

Parameter yang Diperlukan

--name -n

Nama penetapan cetak biru.

Parameter Opsional

--blueprint-version

ID sumber daya dari versi definisi cetak biru yang diterbitkan.

--description

Multibaris menjelaskan sumber daya ini.

--display-name

String satu baris menjelaskan sumber daya ini.

--identity-type

Jenis identitas terkelola.

Nilai yang diterima: None, SystemAssigned, UserAssigned
--location -l

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

--locks-excluded-principals

Daftar prinsipal AAD yang dikecualikan dari kunci cetak biru. Hingga 5 prinsipal diizinkan.

--locks-mode

Mode kunci.

Nilai yang diterima: AllResourcesDoNotDelete, AllResourcesReadOnly, None
--management-group -m

Gunakan grup manajemen untuk cakupan target penetapan cetak biru. Ini dicadangkan untuk digunakan di masa mendatang. Gunakan --subscription sebagai gantinya.

--parameters -p

Nilai parameter penetapan cetak biru. Ini bisa berupa string JSON atau jalur file JSON.

--resource-group-value

Pasangan Key=Value untuk grup sumber daya. Kunci termasuk 'artifact_name'(wajib), 'nama', 'lokasi'.

--subscription -s

Gunakan langganan untuk cakupan target penetapan cetak biru. Susbcripsi default akan digunakan jika opsi tidak ditentukan.

--user-assigned-identity

Identitas terkelola yang ditetapkan pengguna yang terkait dengan sumber daya.

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 blueprint assignment wait

Tempatkan CLI dalam status tunggu hingga kondisi Penetapan Cetak Biru terpenuhi.

az blueprint assignment wait --name
                             [--created]
                             [--custom]
                             [--deleted]
                             [--exists]
                             [--interval]
                             [--management-group]
                             [--subscription]
                             [--timeout]
                             [--updated]

Contoh

Jeda menjalankan baris skrip CLI berikutnya hingga Penetapan Cetak Biru berhasil disediakan.

az blueprint assignment wait --subscription MySubscription \ --name MyBlueprintAssignment --created

Parameter yang Diperlukan

--name -n

Nama penetapan cetak biru.

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

Interval polling dalam hitungan detik.

Nilai default: 30
--management-group -m

Gunakan grup manajemen untuk cakupan target penetapan cetak biru. Ini dicadangkan untuk digunakan di masa mendatang. Gunakan --subscription sebagai gantinya.

--subscription -s

Gunakan langganan untuk cakupan target penetapan cetak biru. Susbcripsi default akan digunakan jika opsi tidak ditentukan.

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

az blueprint assignment who

Pratinjau

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

Dapatkan ObjectId Nama Prinsipal Blueprint Servie.

az blueprint assignment who --name
                            [--management-group]
                            [--subscription]

Contoh

Mendapatkan objectId SPN

az blueprint assignment who --subscription MySubscription --name MyBlueprintAssignment

Parameter yang Diperlukan

--name -n

Nama penetapan cetak biru.

Parameter Opsional

--management-group -m

Gunakan grup manajemen untuk cakupan cetak biru.

--subscription -s

Gunakan langganan untuk cakupan cetak biru. Jika --management-group tidak ditentukan, --nilai langganan atau langganan default akan digunakan sebagai cakupan.

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.