Gambar Microsoft.VirtualMachineImagesTemplates
Definisi sumber daya Bicep
Jenis sumber daya imageTemplates dapat disebarkan ke:
- Grup sumber daya - Lihat perintah penyebaran grup sumber daya
Untuk daftar properti yang diubah di setiap versi API, lihat mengubah log.
Format sumber daya
Untuk membuat sumber daya Microsoft.VirtualMachineImages/imageTemplates, tambahkan Bicep berikut ke templat Anda.
resource symbolicname 'Microsoft.VirtualMachineImages/imageTemplates@2022-02-14' = {
name: 'string'
location: 'string'
tags: {
tagName1: 'tagValue1'
tagName2: 'tagValue2'
}
identity: {
type: 'string'
userAssignedIdentities: {}
}
properties: {
buildTimeoutInMinutes: int
customize: [
{
name: 'string'
type: 'string'
// For remaining properties, see ImageTemplateCustomizer objects
}
]
distribute: [
{
artifactTags: {}
runOutputName: 'string'
type: 'string'
// For remaining properties, see ImageTemplateDistributor objects
}
]
source: {
type: 'string'
// For remaining properties, see ImageTemplateSource objects
}
stagingResourceGroup: 'string'
validate: {
continueDistributeOnFailure: bool
inVMValidations: [
{
name: 'string'
type: 'string'
// For remaining properties, see ImageTemplateInVMValidator objects
}
]
sourceValidationOnly: bool
}
vmProfile: {
osDiskSizeGB: int
userAssignedIdentities: [
'string'
]
vmSize: 'string'
vnetConfig: {
proxyVmSize: 'string'
subnetId: 'string'
}
}
}
}
Objek ImageTemplateCustomizer
Atur properti jenis untuk menentukan jenis objek.
Untuk File, gunakan:
type: 'File'
destination: 'string'
sha256Checksum: 'string'
sourceUri: 'string'
Untuk PowerShell, gunakan:
type: 'PowerShell'
inline: [
'string'
]
runAsSystem: bool
runElevated: bool
scriptUri: 'string'
sha256Checksum: 'string'
validExitCodes: [
int
]
Untuk Shell, gunakan:
type: 'Shell'
inline: [
'string'
]
scriptUri: 'string'
sha256Checksum: 'string'
Untuk WindowsRestart, gunakan:
type: 'WindowsRestart'
restartCheckCommand: 'string'
restartCommand: 'string'
restartTimeout: 'string'
Untuk WindowsUpdate, gunakan:
type: 'WindowsUpdate'
filters: [
'string'
]
searchCriteria: 'string'
updateLimit: int
Objek ImageTemplateDistributor
Atur properti jenis untuk menentukan jenis objek.
Untuk ManagedImage, gunakan:
type: 'ManagedImage'
imageId: 'string'
location: 'string'
Untuk SharedImage, gunakan:
type: 'SharedImage'
excludeFromLatest: bool
galleryImageId: 'string'
replicationRegions: [
'string'
]
storageAccountType: 'string'
Untuk VHD, gunakan:
type: 'VHD'
Objek ImageTemplateSource
Atur properti jenis untuk menentukan jenis objek.
Untuk ManagedImage, gunakan:
type: 'ManagedImage'
imageId: 'string'
Untuk PlatformImage, gunakan:
type: 'PlatformImage'
offer: 'string'
planInfo: {
planName: 'string'
planProduct: 'string'
planPublisher: 'string'
}
publisher: 'string'
sku: 'string'
version: 'string'
Untuk SharedImageVersion, gunakan:
type: 'SharedImageVersion'
imageVersionId: 'string'
Objek ImageTemplateInVMValidator
Atur properti jenis untuk menentukan jenis objek.
Untuk PowerShell, gunakan:
type: 'PowerShell'
inline: [
'string'
]
runAsSystem: bool
runElevated: bool
scriptUri: 'string'
sha256Checksum: 'string'
validExitCodes: [
int
]
Untuk Shell, gunakan:
type: 'Shell'
inline: [
'string'
]
scriptUri: 'string'
sha256Checksum: 'string'
Nilai properti
imageTemplates
| Nama | Deskripsi | Nilai |
|---|---|---|
| nama | Nama sumber daya | string (diperlukan) |
| lokasi | Lokasi geografis tempat sumber daya berada | string (diperlukan) |
| tag | Tag sumber daya. | Kamus nama dan nilai tag. Lihat Tag dalam templat |
| identity | Identitas templat gambar, jika dikonfigurasi. | ImageTemplateIdentity (diperlukan) |
| properti | Properti templat gambar | ImageTemplateProperties |
ImageTemplateIdentity
| Nama | Deskripsi | Nilai |
|---|---|---|
| jenis | Jenis identitas yang digunakan untuk templat gambar. Jenis 'Tidak Ada' akan menghapus identitas apa pun dari templat gambar. | 'Tidak Ada' 'UserAssigned' |
| userAssignedIdentities | Daftar identitas pengguna yang terkait dengan templat gambar. Referensi kunci kamus identitas pengguna akan menjadi id sumber daya ARM dalam formulir: '/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ManagedIdentity/userAssignedIdentities/{identityName}'. | objek |
ImageTemplateProperties
| Nama | Deskripsi | Nilai |
|---|---|---|
| buildTimeoutInMinutes | Durasi maksimum untuk menunggu saat membangun templat citra (mencakup semua kustomisasi, validasi, dan distribusi). Hilangkan atau tentukan 0 untuk menggunakan default (4 jam). | int |
| Menyesuaikan | Menentukan properti yang digunakan untuk menjelaskan langkah-langkah penyesuaian gambar, seperti Sumber gambar dll | ImageTemplateCustomizer[] |
| Mendistribusikan | Distribusi menargetkan ke mana output gambar perlu masuk. | ImageTemplateDistributor[] (diperlukan) |
| sumber | Menentukan properti yang digunakan untuk menjelaskan gambar sumber. | ImageTemplateSource (diperlukan) |
| stagingResourceGroup | Id grup sumber daya penahapan dalam langganan yang sama dengan templat gambar yang akan digunakan untuk membangun gambar. Jika bidang ini kosong, grup sumber daya dengan nama acak akan dibuat. Jika grup sumber daya yang ditentukan di bidang ini tidak ada, grup sumber daya akan dibuat dengan nama yang sama. Jika grup sumber daya yang ditentukan ada, grup sumber daya harus kosong dan di wilayah yang sama dengan templat gambar. Grup sumber daya yang dibuat akan dihapus selama penghapusan templat jika bidang ini kosong atau grup sumber daya yang ditentukan tidak ada, tetapi jika grup sumber daya yang ditentukan ada sumber daya yang dibuat dalam grup sumber daya akan dihapus selama penghapusan templat dan grup sumber daya itu sendiri akan tetap ada. | string |
| validate | Opsi konfigurasi dan daftar validasi yang akan dilakukan pada gambar yang dihasilkan. | ImageTemplatePropertiesValidate |
| vmProfile | Menjelaskan bagaimana komputer virtual disiapkan untuk membangun gambar | ImageTemplateVmProfile |
ImageTemplateCustomizer
| Nama | Deskripsi | Nilai |
|---|---|---|
| nama | Nama yang Mudah Diingat untuk memberikan konteks tentang apa yang dilakukan langkah penyesuaian ini | string |
| jenis | Mengatur jenis objek | File PowerShell Shell WindowsRestart WindowsUpdate (diperlukan) |
ImageTemplateFileCustomizer
| Nama | Deskripsi | Nilai |
|---|---|---|
| jenis | Jenis alat kustomisasi yang ingin Anda gunakan pada Gambar. Misalnya, "Shell" bisa menjadi penyesuai shell | 'File' (diperlukan) |
| tujuan | Jalur absolut ke file (dengan struktur direktori berlapis yang sudah dibuat) tempat file (dari sourceUri) akan diunggah ke di VM | string |
| sha256Checksum | Checksum SHA256 dari file yang disediakan di bidang sourceUri di atas | string |
| sourceUri | URI file yang akan diunggah untuk menyesuaikan VM. Ini bisa menjadi tautan github, SAS URI untuk Azure Storage, dll | string |
ImageTemplatePowerShellCustomizer
| Nama | Deskripsi | Nilai |
|---|---|---|
| jenis | Jenis alat kustomisasi yang ingin Anda gunakan pada Gambar. Misalnya, "Shell" bisa menjadi penyesuai shell | 'PowerShell' (diperlukan) |
| inline | Array perintah PowerShell untuk dijalankan | string[] |
| runAsSystem | Jika ditentukan, skrip PowerShell akan dijalankan dengan hak istimewa yang ditingkatkan menggunakan pengguna Sistem Lokal. Hanya dapat benar ketika bidang runElevated di atas diatur ke true. | bool |
| runElevated | Jika ditentukan, skrip PowerShell akan dijalankan dengan hak istimewa yang ditingkatkan | bool |
| scriptUri | URI skrip PowerShell yang akan dijalankan untuk penyesuaian. Ini bisa menjadi tautan github, SAS URI untuk Azure Storage, dll | string |
| sha256Checksum | Checksum SHA256 dari skrip shell daya yang disediakan di bidang scriptUri di atas | string |
| validExitCodes | Kode keluar yang valid untuk skrip PowerShell. [Default: 0] | int[] |
ImageTemplateShellCustomizer
| Nama | Deskripsi | Nilai |
|---|---|---|
| jenis | Jenis alat kustomisasi yang ingin Anda gunakan pada Gambar. Misalnya, "Shell" bisa menjadi penyesuai shell | 'Shell' (diperlukan) |
| inline | Array perintah shell untuk dijalankan | string[] |
| scriptUri | URI skrip shell yang akan dijalankan untuk penyesuaian. Ini bisa menjadi tautan github, SAS URI untuk Azure Storage, dll | string |
| sha256Checksum | Checksum SHA256 dari skrip shell yang disediakan di bidang scriptUri | string |
ImageTemplateRestartCustomizer
| Nama | Deskripsi | Nilai |
|---|---|---|
| jenis | Jenis alat kustomisasi yang ingin Anda gunakan pada Gambar. Misalnya, "Shell" bisa menjadi penyesuai shell | 'WindowsRestart' (diperlukan) |
| restartCheckCommand | Perintah untuk memeriksa apakah hidupkan ulang berhasil [Default: ''] | string |
| restartCommand | Perintah untuk menjalankan restart [Default: 'shutdown /r /f /t 0 /c "packer restart"'] | string |
| restartTimeout | Waktu habis hidupkan ulang yang ditentukan sebagai string besaran dan unit, misalnya '5m' (5 menit) atau '2 jam' (2 jam) [Default: '5m'] | string |
ImageTemplateWindowsUpdateCustomizer
| Nama | Deskripsi | Nilai |
|---|---|---|
| jenis | Jenis alat kustomisasi yang ingin Anda gunakan pada Gambar. Misalnya, "Shell" bisa menjadi penyesuai shell | 'WindowsUpdate' (diperlukan) |
| filter | Array filter untuk memilih pembaruan yang akan diterapkan. Hilangkan atau tentukan array kosong untuk menggunakan default (tanpa filter). Lihat tautan di atas untuk contoh dan deskripsi terperinci tentang bidang ini. | string[] |
| searchCriteria | Kriteria untuk mencari pembaruan. Hilangkan atau tentukan string kosong untuk menggunakan default (cari semua). Lihat tautan di atas untuk contoh dan deskripsi terperinci tentang bidang ini. | string |
| updateLimit | Jumlah maksimum pembaruan yang akan diterapkan pada satu waktu. Menghilangkan atau menentukan 0 untuk menggunakan default (1000) | int |
ImageTemplateDistributor
| Nama | Deskripsi | Nilai |
|---|---|---|
| artifactTags | Tag yang akan diterapkan ke artefak setelah dibuat/diperbarui oleh distributor. | objek |
| runOutputName | Nama yang akan digunakan untuk RunOutput terkait. | string (diperlukan) |
| jenis | Mengatur jenis objek | ManagedImage SharedImage VHD (diperlukan) |
ImageTemplateManagedImageDistributor
| Nama | Deskripsi | Nilai |
|---|---|---|
| jenis | Jenis distribusi. | 'ManagedImage' (diperlukan) |
| imageId | Id Sumber Daya Gambar Disk Terkelola | string (diperlukan) |
| lokasi | Lokasi Azure untuk gambar, harus cocok jika gambar sudah ada | string (diperlukan) |
ImageTemplateSharedImageDistributor
| Nama | Deskripsi | Nilai |
|---|---|---|
| jenis | Jenis distribusi. | 'SharedImage' (diperlukan) |
| excludeFromLatest | Bendera yang menunjukkan apakah versi gambar yang dibuat harus dikecualikan dari yang terbaru. Hilangkan untuk menggunakan default (false). | bool |
| galleryImageId | Id Sumber Daya gambar Shared Image Gallery | string (diperlukan) |
| replicationRegions | Daftar wilayah tempat gambar akan direplikasi | string[] (diperlukan) |
| storageAccountType | Jenis akun penyimpanan yang akan digunakan untuk menyimpan gambar bersama. Hilangkan untuk menggunakan default (Standard_LRS). | 'Standard_LRS' 'Standard_ZRS' |
ImageTemplateVhdDistributor
| Nama | Deskripsi | Nilai |
|---|---|---|
| jenis | Jenis distribusi. | 'VHD' (diperlukan) |
ImageTemplateSource
| Nama | Deskripsi | Nilai |
|---|---|---|
| jenis | Mengatur jenis objek | ManagedImage PlatformImage SharedImageVersion (diperlukan) |
ImageTemplateManagedImageSource
| Nama | Deskripsi | Nilai |
|---|---|---|
| jenis | Menentukan jenis gambar sumber yang ingin Anda mulai. | 'ManagedImage' (diperlukan) |
| imageId | ID sumber daya ARM dari gambar terkelola dalam langganan pelanggan | string (diperlukan) |
ImageTemplatePlatformImageSource
| Nama | Deskripsi | Nilai |
|---|---|---|
| jenis | Menentukan jenis gambar sumber yang ingin Anda mulai. | 'PlatformImage' (diperlukan) |
| offer | Penawaran gambar dari Gambar Galeri Azure. | string |
| planInfo | Konfigurasi opsional paket pembelian untuk gambar platform. | PlatformImagePurchasePlan |
| penerbit | Penerbit Gambar di Gambar Galeri Azure. | string |
| sku | Sku gambar dari Gambar Galeri Azure. | string |
| versi | Versi gambar dari Gambar Galeri Azure. Jika 'terbaru' ditentukan di sini, versi dievaluasi ketika build gambar berlangsung, bukan saat templat dikirimkan. | string |
PlatformImagePurchasePlan
| Nama | Deskripsi | Nilai |
|---|---|---|
| planName | Nama paket pembelian. | string (diperlukan) |
| planProduct | Produk dari paket pembelian. | string (diperlukan) |
| planPublisher | Penerbit paket pembelian. | string (diperlukan) |
ImageTemplateSharedImageVersionSource
| Nama | Deskripsi | Nilai |
|---|---|---|
| jenis | Menentukan jenis gambar sumber yang ingin Anda mulai. | 'SharedImageVersion' (diperlukan) |
| imageVersionId | ID sumber daya ARM dari versi gambar di galeri gambar bersama | string (diperlukan) |
ImageTemplatePropertiesValidate
| Nama | Deskripsi | Nilai |
|---|---|---|
| continueDistributeOnFailure | Jika validasi gagal dan bidang ini diatur ke false, gambar output tidak akan didistribusikan. Ini adalah perilaku default. Jika validasi gagal dan bidang ini diatur ke true, gambar output masih akan didistribusikan. Harap gunakan opsi ini dengan hati-hati karena dapat mengakibatkan citra buruk didistribusikan untuk digunakan. Dalam kedua kasus (benar atau salah), eksekusi gambar end to end akan dilaporkan gagal jika terjadi kegagalan validasi. [Catatan: Bidang ini tidak berpengaruh jika validasi berhasil.] | bool |
| inVMValidations | Daftar validasi yang akan dilakukan. | ImageTemplateInVMValidator[] |
| sourceValidationOnly | Jika bidang ini diatur ke true, gambar yang ditentukan di bagian 'sumber' akan langsung divalidasi. Tidak ada build terpisah yang akan dijalankan untuk menghasilkan dan kemudian memvalidasi gambar yang disesuaikan. | bool |
ImageTemplateInVMValidator
| Nama | Deskripsi | Nilai |
|---|---|---|
| nama | Nama yang Mudah Diingat untuk memberikan konteks tentang apa yang dilakukan langkah validasi ini | string |
| jenis | Mengatur jenis objek | PowerShell Shell (diperlukan) |
ImageTemplatePowerShellValidator
| Nama | Deskripsi | Nilai |
|---|---|---|
| jenis | Jenis validasi yang ingin Anda gunakan pada Gambar. Misalnya, "Shell" bisa menjadi validasi shell | 'PowerShell' (diperlukan) |
| inline | Array perintah PowerShell untuk dijalankan | string[] |
| runAsSystem | Jika ditentukan, skrip PowerShell akan dijalankan dengan hak istimewa yang ditingkatkan menggunakan pengguna Sistem Lokal. Hanya dapat benar ketika bidang runElevated di atas diatur ke true. | bool |
| runElevated | Jika ditentukan, skrip PowerShell akan dijalankan dengan hak istimewa yang ditingkatkan | bool |
| scriptUri | URI skrip PowerShell yang akan dijalankan untuk validasi. Ini bisa menjadi tautan github, URI Azure Storage, dll | string |
| sha256Checksum | Checksum SHA256 dari skrip shell daya yang disediakan di bidang scriptUri di atas | string |
| validExitCodes | Kode keluar yang valid untuk skrip PowerShell. [Default: 0] | int[] |
ImageTemplateShellValidator
| Nama | Deskripsi | Nilai |
|---|---|---|
| jenis | Jenis validasi yang ingin Anda gunakan pada Gambar. Misalnya, "Shell" bisa menjadi validasi shell | 'Shell' (diperlukan) |
| inline | Array perintah shell untuk dijalankan | string[] |
| scriptUri | URI skrip shell yang akan dijalankan untuk validasi. Ini bisa menjadi tautan github, URI Azure Storage, dll | string |
| sha256Checksum | Checksum SHA256 dari skrip shell yang disediakan di bidang scriptUri | string |
ImageTemplateVmProfile
| Nama | Deskripsi | Nilai |
|---|---|---|
| osDiskSizeGB | Ukuran disk OS dalam GB. Hilangkan atau tentukan 0 untuk menggunakan ukuran disk OS default Azure. | int |
| userAssignedIdentities | Array opsional ID sumber daya dari identitas terkelola yang ditetapkan pengguna untuk dikonfigurasi pada VM build dan VM validasi. Ini mungkin termasuk identitas templat gambar. | string[] |
| vmSize | Ukuran komputer virtual yang digunakan untuk membangun, menyesuaikan, dan menangkap gambar. Hilangkan atau tentukan string kosong untuk menggunakan default (Standard_D1_v2 untuk gambar Gen1 dan Standard_D2ds_v4 untuk gambar Gen2). | string |
| vnetConfig | Konfigurasi opsional jaringan virtual yang akan digunakan untuk menyebarkan VM build dan VM validasi. Abaikan jika tidak ada jaringan virtual tertentu yang perlu digunakan. | VirtualNetworkConfig |
VirtualNetworkConfig
| Nama | Deskripsi | Nilai |
|---|---|---|
| proxyVmSize | Ukuran komputer virtual proksi yang digunakan untuk meneruskan lalu lintas ke VM build dan VM validasi. Hilangkan atau tentukan string kosong untuk menggunakan default (Standard_A1_v2). | string |
| subnetId | Id sumber daya subnet yang sudah ada sebelumnya. | string |
Templat Mulai Cepat
Templat mulai cepat berikut menyebarkan jenis sumber daya ini.
| Templat | Deskripsi |
|---|---|
Azure Image Builder dengan Azure Windows Baseline |
Membuat lingkungan Azure Image Builder dan membangun gambar Windows Server dengan Windows Updates terbaru dan Azure Windows Baseline yang diterapkan. |
| Mengonfigurasi layanan Dev Box |
Templat ini akan membuat semua sumber daya admin Dev Box sesuai panduan mulai cepat Dev Box. Anda dapat melihat semua sumber daya yang dibuat, atau langsung masuk ke DevPortal.microsoft.com untuk membuat Dev Box pertama Anda. |
Definisi sumber daya templat ARM
Jenis sumber daya imageTemplates dapat disebarkan ke:
- Grup sumber daya - Lihat perintah penyebaran grup sumber daya
Untuk daftar properti yang diubah di setiap versi API, lihat log perubahan.
Format sumber daya
Untuk membuat sumber daya Microsoft.VirtualMachineImages/imageTemplates, tambahkan JSON berikut ke templat Anda.
{
"type": "Microsoft.VirtualMachineImages/imageTemplates",
"apiVersion": "2022-02-14",
"name": "string",
"location": "string",
"tags": {
"tagName1": "tagValue1",
"tagName2": "tagValue2"
},
"identity": {
"type": "string",
"userAssignedIdentities": {}
},
"properties": {
"buildTimeoutInMinutes": "int",
"customize": [
{
"name": "string",
"type": "string"
// For remaining properties, see ImageTemplateCustomizer objects
}
],
"distribute": [
{
"artifactTags": {},
"runOutputName": "string",
"type": "string"
// For remaining properties, see ImageTemplateDistributor objects
}
],
"source": {
"type": "string"
// For remaining properties, see ImageTemplateSource objects
},
"stagingResourceGroup": "string",
"validate": {
"continueDistributeOnFailure": "bool",
"inVMValidations": [
{
"name": "string",
"type": "string"
// For remaining properties, see ImageTemplateInVMValidator objects
}
],
"sourceValidationOnly": "bool"
},
"vmProfile": {
"osDiskSizeGB": "int",
"userAssignedIdentities": [ "string" ],
"vmSize": "string",
"vnetConfig": {
"proxyVmSize": "string",
"subnetId": "string"
}
}
}
}
Objek ImageTemplateCustomizer
Atur properti jenis untuk menentukan jenis objek.
Untuk File, gunakan:
"type": "File",
"destination": "string",
"sha256Checksum": "string",
"sourceUri": "string"
Untuk PowerShell, gunakan:
"type": "PowerShell",
"inline": [ "string" ],
"runAsSystem": "bool",
"runElevated": "bool",
"scriptUri": "string",
"sha256Checksum": "string",
"validExitCodes": [ "int" ]
Untuk Shell, gunakan:
"type": "Shell",
"inline": [ "string" ],
"scriptUri": "string",
"sha256Checksum": "string"
Untuk WindowsRestart, gunakan:
"type": "WindowsRestart",
"restartCheckCommand": "string",
"restartCommand": "string",
"restartTimeout": "string"
Untuk WindowsUpdate, gunakan:
"type": "WindowsUpdate",
"filters": [ "string" ],
"searchCriteria": "string",
"updateLimit": "int"
Objek ImageTemplateDistributor
Atur properti jenis untuk menentukan jenis objek.
Untuk ManagedImage, gunakan:
"type": "ManagedImage",
"imageId": "string",
"location": "string"
Untuk SharedImage, gunakan:
"type": "SharedImage",
"excludeFromLatest": "bool",
"galleryImageId": "string",
"replicationRegions": [ "string" ],
"storageAccountType": "string"
Untuk VHD, gunakan:
"type": "VHD"
Objek ImageTemplateSource
Atur properti jenis untuk menentukan jenis objek.
Untuk ManagedImage, gunakan:
"type": "ManagedImage",
"imageId": "string"
Untuk PlatformImage, gunakan:
"type": "PlatformImage",
"offer": "string",
"planInfo": {
"planName": "string",
"planProduct": "string",
"planPublisher": "string"
},
"publisher": "string",
"sku": "string",
"version": "string"
Untuk SharedImageVersion, gunakan:
"type": "SharedImageVersion",
"imageVersionId": "string"
Objek ImageTemplateInVMValidator
Atur properti jenis untuk menentukan jenis objek.
Untuk PowerShell, gunakan:
"type": "PowerShell",
"inline": [ "string" ],
"runAsSystem": "bool",
"runElevated": "bool",
"scriptUri": "string",
"sha256Checksum": "string",
"validExitCodes": [ "int" ]
Untuk Shell, gunakan:
"type": "Shell",
"inline": [ "string" ],
"scriptUri": "string",
"sha256Checksum": "string"
Nilai properti
imageTemplates
| Nama | Deskripsi | Nilai |
|---|---|---|
| jenis | Jenis sumber daya | 'Microsoft.VirtualMachineImages/imageTemplates' |
| apiVersion | Versi api sumber daya | '2022-02-14' |
| nama | Nama sumber daya | string (diperlukan) |
| lokasi | Lokasi geografis tempat sumber daya berada | string (diperlukan) |
| tag | Tag sumber daya. | Kamus nama dan nilai tag. Lihat Tag dalam templat |
| identity | Identitas templat gambar, jika dikonfigurasi. | ImageTemplateIdentity (diperlukan) |
| properti | Properti templat gambar | ImageTemplateProperties |
ImageTemplateIdentity
| Nama | Deskripsi | Nilai |
|---|---|---|
| jenis | Jenis identitas yang digunakan untuk templat gambar. Jenis 'Tidak Ada' akan menghapus identitas apa pun dari templat gambar. | 'Tidak Ada' 'UserAssigned' |
| userAssignedIdentities | Daftar identitas pengguna yang terkait dengan templat gambar. Referensi kunci kamus identitas pengguna akan menjadi id sumber daya ARM dalam formulir: '/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ManagedIdentity/userAssignedIdentities/{identityName}'. | objek |
ImageTemplateProperties
| Nama | Deskripsi | Nilai |
|---|---|---|
| buildTimeoutInMinutes | Durasi maksimum untuk menunggu saat membangun templat citra (mencakup semua kustomisasi, validasi, dan distribusi). Hilangkan atau tentukan 0 untuk menggunakan default (4 jam). | int |
| Menyesuaikan | Menentukan properti yang digunakan untuk menjelaskan langkah-langkah penyesuaian gambar, seperti Sumber gambar dll | ImageTemplateCustomizer[] |
| Mendistribusikan | Distribusi menargetkan ke mana output gambar perlu masuk. | ImageTemplateDistributor[] (diperlukan) |
| sumber | Menentukan properti yang digunakan untuk menjelaskan gambar sumber. | ImageTemplateSource (diperlukan) |
| stagingResourceGroup | Id grup sumber daya penahapan dalam langganan yang sama dengan templat gambar yang akan digunakan untuk membangun gambar. Jika bidang ini kosong, grup sumber daya dengan nama acak akan dibuat. Jika grup sumber daya yang ditentukan di bidang ini tidak ada, grup sumber daya akan dibuat dengan nama yang sama. Jika grup sumber daya yang ditentukan ada, grup sumber daya harus kosong dan di wilayah yang sama dengan templat gambar. Grup sumber daya yang dibuat akan dihapus selama penghapusan templat jika bidang ini kosong atau grup sumber daya yang ditentukan tidak ada, tetapi jika grup sumber daya yang ditentukan ada sumber daya yang dibuat dalam grup sumber daya akan dihapus selama penghapusan templat dan grup sumber daya itu sendiri akan tetap ada. | string |
| validate | Opsi konfigurasi dan daftar validasi yang akan dilakukan pada gambar yang dihasilkan. | ImageTemplatePropertiesValidate |
| vmProfile | Menjelaskan bagaimana komputer virtual disiapkan untuk membangun gambar | ImageTemplateVmProfile |
ImageTemplateCustomizer
| Nama | Deskripsi | Nilai |
|---|---|---|
| nama | Nama yang Mudah Diingat untuk memberikan konteks tentang apa yang dilakukan langkah penyesuaian ini | string |
| jenis | Mengatur jenis objek | File PowerShell Shell WindowsRestart WindowsUpdate (diperlukan) |
ImageTemplateFileCustomizer
| Nama | Deskripsi | Nilai |
|---|---|---|
| jenis | Jenis alat kustomisasi yang ingin Anda gunakan pada Gambar. Misalnya, "Shell" bisa menjadi penyesuai shell | 'File' (diperlukan) |
| tujuan | Jalur absolut ke file (dengan struktur direktori berlapis yang sudah dibuat) tempat file (dari sourceUri) akan diunggah ke di VM | string |
| sha256Checksum | Checksum SHA256 dari file yang disediakan di bidang sourceUri di atas | string |
| sourceUri | URI file yang akan diunggah untuk menyesuaikan VM. Ini bisa menjadi tautan github, SAS URI untuk Azure Storage, dll | string |
ImageTemplatePowerShellCustomizer
| Nama | Deskripsi | Nilai |
|---|---|---|
| jenis | Jenis alat kustomisasi yang ingin Anda gunakan pada Gambar. Misalnya, "Shell" bisa menjadi penyesuai shell | 'PowerShell' (diperlukan) |
| inline | Array perintah PowerShell untuk dijalankan | string[] |
| runAsSystem | Jika ditentukan, skrip PowerShell akan dijalankan dengan hak istimewa yang ditingkatkan menggunakan pengguna Sistem Lokal. Hanya dapat benar ketika bidang runElevated di atas diatur ke true. | bool |
| runElevated | Jika ditentukan, skrip PowerShell akan dijalankan dengan hak istimewa yang ditingkatkan | bool |
| scriptUri | URI skrip PowerShell yang akan dijalankan untuk penyesuaian. Ini bisa menjadi tautan github, SAS URI untuk Azure Storage, dll | string |
| sha256Checksum | Checksum SHA256 dari skrip shell daya yang disediakan di bidang scriptUri di atas | string |
| validExitCodes | Kode keluar yang valid untuk skrip PowerShell. [Default: 0] | int[] |
ImageTemplateShellCustomizer
| Nama | Deskripsi | Nilai |
|---|---|---|
| jenis | Jenis alat kustomisasi yang ingin Anda gunakan pada Gambar. Misalnya, "Shell" bisa menjadi penyesuai shell | 'Shell' (diperlukan) |
| inline | Array perintah shell untuk dijalankan | string[] |
| scriptUri | URI skrip shell yang akan dijalankan untuk penyesuaian. Ini bisa menjadi tautan github, SAS URI untuk Azure Storage, dll | string |
| sha256Checksum | Checksum SHA256 dari skrip shell yang disediakan di bidang scriptUri | string |
ImageTemplateRestartCustomizer
| Nama | Deskripsi | Nilai |
|---|---|---|
| jenis | Jenis alat kustomisasi yang ingin Anda gunakan pada Gambar. Misalnya, "Shell" bisa menjadi penyesuai shell | 'WindowsRestart' (diperlukan) |
| restartCheckCommand | Perintah untuk memeriksa apakah hidupkan ulang berhasil [Default: ''] | string |
| restartCommand | Perintah untuk menjalankan restart [Default: 'shutdown /r /f /t 0 /c "packer restart"'] | string |
| restartTimeout | Waktu habis hidupkan ulang yang ditentukan sebagai string besaran dan unit, misalnya '5m' (5 menit) atau '2 jam' (2 jam) [Default: '5m'] | string |
ImageTemplateWindowsUpdateCustomizer
| Nama | Deskripsi | Nilai |
|---|---|---|
| jenis | Jenis alat kustomisasi yang ingin Anda gunakan pada Gambar. Misalnya, "Shell" bisa menjadi penyesuai shell | 'WindowsUpdate' (diperlukan) |
| filter | Array filter untuk memilih pembaruan yang akan diterapkan. Hilangkan atau tentukan array kosong untuk menggunakan default (tanpa filter). Lihat tautan di atas untuk contoh dan deskripsi terperinci dari bidang ini. | string[] |
| searchCriteria | Kriteria untuk mencari pembaruan. Hilangkan atau tentukan string kosong untuk menggunakan default (cari semua). Lihat tautan di atas untuk contoh dan deskripsi terperinci dari bidang ini. | string |
| updateLimit | Jumlah maksimum pembaruan yang akan diterapkan pada satu waktu. Hilangkan atau tentukan 0 untuk menggunakan default (1000) | int |
ImageTemplateDistributor
| Nama | Deskripsi | Nilai |
|---|---|---|
| artifactTags | Tag yang akan diterapkan ke artefak setelah dibuat/diperbarui oleh distributor. | objek |
| runOutputName | Nama yang akan digunakan untuk RunOutput terkait. | string (diperlukan) |
| jenis | Mengatur jenis objek | ManagedImage SharedImage VHD (diperlukan) |
ImageTemplateManagedImageDistributor
| Nama | Deskripsi | Nilai |
|---|---|---|
| jenis | Jenis distribusi. | 'ManagedImage' (diperlukan) |
| imageId | Id Sumber Daya Dari Gambar Disk Terkelola | string (diperlukan) |
| lokasi | Lokasi Azure untuk gambar, harus cocok jika gambar sudah ada | string (diperlukan) |
ImageTemplateSharedImageDistributor
| Nama | Deskripsi | Nilai |
|---|---|---|
| jenis | Jenis distribusi. | 'SharedImage' (diperlukan) |
| excludeFromLatest | Bendera yang menunjukkan apakah versi gambar yang dibuat harus dikecualikan dari yang terbaru. Hilangkan untuk menggunakan default (false). | bool |
| galleryImageId | Id Sumber Daya gambar Shared Image Gallery | string (diperlukan) |
| replicationRegions | Daftar wilayah tempat gambar akan direplikasi | string[] (diperlukan) |
| storageAccountType | Jenis akun penyimpanan yang akan digunakan untuk menyimpan gambar bersama. Hilangkan untuk menggunakan default (Standard_LRS). | 'Standard_LRS' 'Standard_ZRS' |
ImageTemplateVhdDistributor
| Nama | Deskripsi | Nilai |
|---|---|---|
| jenis | Jenis distribusi. | 'VHD' (diperlukan) |
ImageTemplateSource
| Nama | Deskripsi | Nilai |
|---|---|---|
| jenis | Mengatur jenis objek | ManagedImage PlatformImage SharedImageVersion (diperlukan) |
ImageTemplateManagedImageSource
| Nama | Deskripsi | Nilai |
|---|---|---|
| jenis | Menentukan jenis gambar sumber yang ingin Anda mulai. | 'ManagedImage' (diperlukan) |
| imageId | ID sumber daya ARM dari gambar terkelola dalam langganan pelanggan | string (diperlukan) |
ImageTemplatePlatformImageSource
| Nama | Deskripsi | Nilai |
|---|---|---|
| jenis | Menentukan jenis gambar sumber yang ingin Anda mulai. | 'PlatformImage' (diperlukan) |
| offer | Penawaran gambar dari Gambar Galeri Azure. | string |
| planInfo | Konfigurasi opsional paket pembelian untuk gambar platform. | PlatformImagePurchasePlan |
| penerbit | Penerbit Gambar di Gambar Galeri Azure. | string |
| sku | Sku gambar dari Gambar Galeri Azure. | string |
| versi | Versi gambar dari Gambar Galeri Azure. Jika 'terbaru' ditentukan di sini, versi dievaluasi ketika build gambar berlangsung, bukan saat templat dikirimkan. | string |
PlatformImagePurchasePlan
| Nama | Deskripsi | Nilai |
|---|---|---|
| planName | Nama paket pembelian. | string (diperlukan) |
| planProduct | Produk dari paket pembelian. | string (diperlukan) |
| planPublisher | Penerbit paket pembelian. | string (diperlukan) |
ImageTemplateSharedImageVersionSource
| Nama | Deskripsi | Nilai |
|---|---|---|
| jenis | Menentukan jenis gambar sumber yang ingin Anda mulai. | 'SharedImageVersion' (diperlukan) |
| imageVersionId | ID sumber daya ARM dari versi gambar di galeri gambar bersama | string (diperlukan) |
ImageTemplatePropertiesValidate
| Nama | Deskripsi | Nilai |
|---|---|---|
| continueDistributeOnFailure | Jika validasi gagal dan bidang ini diatur ke false, gambar output tidak akan didistribusikan. Ini adalah perilaku default. Jika validasi gagal dan bidang ini diatur ke true, gambar output masih akan didistribusikan. Harap gunakan opsi ini dengan hati-hati karena dapat mengakibatkan gambar buruk didistribusikan untuk digunakan. Dalam kedua kasus (benar atau salah), eksekusi gambar ujung ke ujung akan dilaporkan gagal jika terjadi kegagalan validasi. [Catatan: Bidang ini tidak berpengaruh jika validasi berhasil.] | bool |
| inVMValidations | Daftar validasi yang akan dilakukan. | ImageTemplateInVMValidator[] |
| sourceValidationOnly | Jika bidang ini diatur ke true, gambar yang ditentukan di bagian 'sumber' akan langsung divalidasi. Tidak ada build terpisah yang akan dijalankan untuk menghasilkan dan kemudian memvalidasi gambar yang disesuaikan. | bool |
ImageTemplateInVMValidator
| Nama | Deskripsi | Nilai |
|---|---|---|
| nama | Nama yang Mudah Diingat untuk memberikan konteks tentang apa yang dilakukan langkah validasi ini | string |
| jenis | Mengatur jenis objek | PowerShell Shell (diperlukan) |
ImageTemplatePowerShellValidator
| Nama | Deskripsi | Nilai |
|---|---|---|
| jenis | Jenis validasi yang ingin Anda gunakan pada Gambar. Misalnya, "Shell" bisa menjadi validasi shell | 'PowerShell' (diperlukan) |
| inline | Array perintah PowerShell untuk dijalankan | string[] |
| runAsSystem | Jika ditentukan, skrip PowerShell akan dijalankan dengan hak istimewa yang ditingkatkan menggunakan pengguna Sistem Lokal. Hanya dapat benar ketika bidang runElevated di atas diatur ke true. | bool |
| runElevated | Jika ditentukan, skrip PowerShell akan dijalankan dengan hak istimewa yang ditingkatkan | bool |
| scriptUri | URI skrip PowerShell yang akan dijalankan untuk validasi. Ini bisa menjadi tautan github, URI Azure Storage, dll | string |
| sha256Checksum | Checksum SHA256 dari skrip shell daya yang disediakan di bidang scriptUri di atas | string |
| validExitCodes | Kode keluar yang valid untuk skrip PowerShell. [Default: 0] | int[] |
ImageTemplateShellValidator
| Nama | Deskripsi | Nilai |
|---|---|---|
| jenis | Jenis validasi yang ingin Anda gunakan pada Gambar. Misalnya, "Shell" bisa menjadi validasi shell | 'Shell' (diperlukan) |
| inline | Array perintah shell untuk dijalankan | string[] |
| scriptUri | URI skrip shell yang akan dijalankan untuk validasi. Ini bisa menjadi tautan github, URI Azure Storage, dll | string |
| sha256Checksum | Checksum SHA256 dari skrip shell yang disediakan di bidang scriptUri | string |
ImageTemplateVmProfile
| Nama | Deskripsi | Nilai |
|---|---|---|
| osDiskSizeGB | Ukuran disk OS dalam GB. Hilangkan atau tentukan 0 untuk menggunakan ukuran disk OS default Azure. | int |
| userAssignedIdentities | Array opsional ID sumber daya dari identitas terkelola yang ditetapkan pengguna untuk dikonfigurasi pada VM build dan VM validasi. Ini mungkin termasuk identitas templat gambar. | string[] |
| vmSize | Ukuran komputer virtual yang digunakan untuk membangun, menyesuaikan, dan mengambil gambar. Hilangkan atau tentukan string kosong untuk menggunakan default (Standard_D1_v2 untuk gambar Gen1 dan Standard_D2ds_v4 untuk gambar Gen2). | string |
| vnetConfig | Konfigurasi opsional jaringan virtual yang digunakan untuk menyebarkan VM build dan VM validasi. Abaikan jika tidak ada jaringan virtual tertentu yang perlu digunakan. | VirtualNetworkConfig |
VirtualNetworkConfig
| Nama | Deskripsi | Nilai |
|---|---|---|
| proxyVmSize | Ukuran komputer virtual proksi yang digunakan untuk meneruskan lalu lintas ke VM build dan VM validasi. Hilangkan atau tentukan string kosong untuk menggunakan default (Standard_A1_v2). | string |
| subnetId | Id sumber daya dari subnet yang sudah ada sebelumnya. | string |
Templat Mulai Cepat
Templat mulai cepat berikut menyebarkan jenis sumber daya ini.
| Templat | Deskripsi |
|---|---|
| Azure Image Builder dengan Azure Windows Baseline |
Membuat lingkungan Azure Image Builder dan membangun gambar Windows Server dengan Windows Updates terbaru dan Azure Windows Baseline diterapkan. |
| Mengonfigurasi layanan Dev Box |
Templat ini akan membuat semua sumber daya admin Dev Box sesuai panduan mulai cepat Dev Box. Anda dapat melihat semua sumber daya yang dibuat, atau langsung masuk ke DevPortal.microsoft.com untuk membuat Dev Box pertama Anda. |
Definisi sumber daya Terraform (penyedia AzAPI)
Jenis sumber daya imageTemplates dapat disebarkan ke:
- Grup sumber daya
Untuk daftar properti yang diubah di setiap versi API, lihat mengubah log.
Format sumber daya
Untuk membuat sumber daya Microsoft.VirtualMachineImages/imageTemplates, tambahkan Terraform berikut ke templat Anda.
resource "azapi_resource" "symbolicname" {
type = "Microsoft.VirtualMachineImages/imageTemplates@2022-02-14"
name = "string"
location = "string"
parent_id = "string"
tags = {
tagName1 = "tagValue1"
tagName2 = "tagValue2"
}
identity {
type = "UserAssigned"
identity_ids = []
}
body = jsonencode({
properties = {
buildTimeoutInMinutes = int
customize = [
{
name = "string"
type = "string"
// For remaining properties, see ImageTemplateCustomizer objects
}
]
distribute = [
{
artifactTags = {}
runOutputName = "string"
type = "string"
// For remaining properties, see ImageTemplateDistributor objects
}
]
source = {
type = "string"
// For remaining properties, see ImageTemplateSource objects
}
stagingResourceGroup = "string"
validate = {
continueDistributeOnFailure = bool
inVMValidations = [
{
name = "string"
type = "string"
// For remaining properties, see ImageTemplateInVMValidator objects
}
]
sourceValidationOnly = bool
}
vmProfile = {
osDiskSizeGB = int
userAssignedIdentities = [
"string"
]
vmSize = "string"
vnetConfig = {
proxyVmSize = "string"
subnetId = "string"
}
}
}
})
}
Objek ImageTemplateCustomizer
Atur properti jenis untuk menentukan jenis objek.
Untuk File, gunakan:
type = "File"
destination = "string"
sha256Checksum = "string"
sourceUri = "string"
Untuk PowerShell, gunakan:
type = "PowerShell"
inline = [
"string"
]
runAsSystem = bool
runElevated = bool
scriptUri = "string"
sha256Checksum = "string"
validExitCodes = [
int
]
Untuk Shell, gunakan:
type = "Shell"
inline = [
"string"
]
scriptUri = "string"
sha256Checksum = "string"
Untuk WindowsRestart, gunakan:
type = "WindowsRestart"
restartCheckCommand = "string"
restartCommand = "string"
restartTimeout = "string"
Untuk WindowsUpdate, gunakan:
type = "WindowsUpdate"
filters = [
"string"
]
searchCriteria = "string"
updateLimit = int
Objek ImageTemplateDistributor
Atur properti jenis untuk menentukan jenis objek.
Untuk ManagedImage, gunakan:
type = "ManagedImage"
imageId = "string"
location = "string"
Untuk SharedImage, gunakan:
type = "SharedImage"
excludeFromLatest = bool
galleryImageId = "string"
replicationRegions = [
"string"
]
storageAccountType = "string"
Untuk VHD, gunakan:
type = "VHD"
Objek ImageTemplateSource
Atur properti jenis untuk menentukan jenis objek.
Untuk ManagedImage, gunakan:
type = "ManagedImage"
imageId = "string"
Untuk PlatformImage, gunakan:
type = "PlatformImage"
offer = "string"
planInfo = {
planName = "string"
planProduct = "string"
planPublisher = "string"
}
publisher = "string"
sku = "string"
version = "string"
Untuk SharedImageVersion, gunakan:
type = "SharedImageVersion"
imageVersionId = "string"
Objek ImageTemplateInVMValidator
Atur properti jenis untuk menentukan jenis objek.
Untuk PowerShell, gunakan:
type = "PowerShell"
inline = [
"string"
]
runAsSystem = bool
runElevated = bool
scriptUri = "string"
sha256Checksum = "string"
validExitCodes = [
int
]
Untuk Shell, gunakan:
type = "Shell"
inline = [
"string"
]
scriptUri = "string"
sha256Checksum = "string"
Nilai properti
imageTemplates
| Nama | Deskripsi | Nilai |
|---|---|---|
| jenis | Jenis sumber daya | "Microsoft.VirtualMachineImages/imageTemplates@2022-02-14" |
| nama | Nama sumber daya | string (diperlukan) |
| lokasi | Lokasi geografis tempat sumber daya berada | string (diperlukan) |
| parent_id | Untuk menyebarkan ke grup sumber daya, gunakan ID grup sumber daya tersebut. | string (diperlukan) |
| tag | Tag sumber daya. | Kamus nama dan nilai tag. |
| identitas | Identitas templat gambar, jika dikonfigurasi. | ImageTemplateIdentity (diperlukan) |
| properti | Properti templat gambar | ImageTemplateProperties |
ImageTemplateIdentity
| Nama | Deskripsi | Nilai |
|---|---|---|
| jenis | Jenis identitas yang digunakan untuk templat gambar. Jenis 'Tidak Ada' akan menghapus identitas apa pun dari templat gambar. | "UserAssigned" |
| identity_ids | Daftar identitas pengguna yang terkait dengan templat gambar. Referensi kunci kamus identitas pengguna akan menjadi id sumber daya ARM dalam formulir: '/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ManagedIdentity/userAssignedIdentities/{identityName}'. | Array ID identitas pengguna. |
ImageTemplateProperties
| Nama | Deskripsi | Nilai |
|---|---|---|
| buildTimeoutInMinutes | Durasi maksimum untuk menunggu saat membangun templat citra (mencakup semua kustomisasi, validasi, dan distribusi). Hilangkan atau tentukan 0 untuk menggunakan default (4 jam). | int |
| Menyesuaikan | Menentukan properti yang digunakan untuk menjelaskan langkah-langkah penyesuaian gambar, seperti Sumber gambar dll | ImageTemplateCustomizer[] |
| Mendistribusikan | Distribusi menargetkan ke mana output gambar perlu masuk. | ImageTemplateDistributor[] (diperlukan) |
| sumber | Menentukan properti yang digunakan untuk menjelaskan gambar sumber. | ImageTemplateSource (diperlukan) |
| stagingResourceGroup | Id grup sumber daya penahapan dalam langganan yang sama dengan templat gambar yang akan digunakan untuk membangun gambar. Jika bidang ini kosong, grup sumber daya dengan nama acak akan dibuat. Jika grup sumber daya yang ditentukan di bidang ini tidak ada, grup sumber daya akan dibuat dengan nama yang sama. Jika grup sumber daya yang ditentukan ada, grup sumber daya harus kosong dan di wilayah yang sama dengan templat gambar. Grup sumber daya yang dibuat akan dihapus selama penghapusan templat jika bidang ini kosong atau grup sumber daya yang ditentukan tidak ada, tetapi jika grup sumber daya yang ditentukan ada sumber daya yang dibuat dalam grup sumber daya akan dihapus selama penghapusan templat dan grup sumber daya itu sendiri akan tetap ada. | string |
| validate | Opsi konfigurasi dan daftar validasi yang akan dilakukan pada gambar yang dihasilkan. | ImageTemplatePropertiesValidate |
| vmProfile | Menjelaskan bagaimana komputer virtual disiapkan untuk membangun gambar | ImageTemplateVmProfile |
ImageTemplateCustomizer
| Nama | Deskripsi | Nilai |
|---|---|---|
| nama | Nama yang Mudah Diingat untuk memberikan konteks tentang apa yang dilakukan langkah penyesuaian ini | string |
| jenis | Mengatur jenis objek | File PowerShell Shell WindowsRestart WindowsUpdate (diperlukan) |
ImageTemplateFileCustomizer
| Nama | Deskripsi | Nilai |
|---|---|---|
| jenis | Jenis alat kustomisasi yang ingin Anda gunakan pada Gambar. Misalnya, "Shell" bisa menjadi penyesuai shell | "File" (diperlukan) |
| tujuan | Jalur absolut ke file (dengan struktur direktori berlapis yang sudah dibuat) tempat file (dari sourceUri) akan diunggah ke di VM | string |
| sha256Checksum | Checksum SHA256 dari file yang disediakan di bidang sourceUri di atas | string |
| sourceUri | URI file yang akan diunggah untuk menyesuaikan VM. Ini bisa menjadi tautan github, SAS URI untuk Azure Storage, dll | string |
ImageTemplatePowerShellCustomizer
| Nama | Deskripsi | Nilai |
|---|---|---|
| jenis | Jenis alat kustomisasi yang ingin Anda gunakan pada Gambar. Misalnya, "Shell" bisa menjadi penyesuai shell | "PowerShell" (diperlukan) |
| inline | Array perintah PowerShell untuk dijalankan | string[] |
| runAsSystem | Jika ditentukan, skrip PowerShell akan dijalankan dengan hak istimewa yang ditingkatkan menggunakan pengguna Sistem Lokal. Hanya dapat benar ketika bidang runElevated di atas diatur ke true. | bool |
| runElevated | Jika ditentukan, skrip PowerShell akan dijalankan dengan hak istimewa yang ditingkatkan | bool |
| scriptUri | URI skrip PowerShell yang akan dijalankan untuk penyesuaian. Ini bisa menjadi tautan github, SAS URI untuk Azure Storage, dll | string |
| sha256Checksum | Checksum SHA256 dari skrip shell daya yang disediakan di bidang scriptUri di atas | string |
| validExitCodes | Kode keluar yang valid untuk skrip PowerShell. [Default: 0] | int[] |
ImageTemplateShellCustomizer
| Nama | Deskripsi | Nilai |
|---|---|---|
| jenis | Jenis alat kustomisasi yang ingin Anda gunakan pada Gambar. Misalnya, "Shell" bisa menjadi penyesuai shell | "Shell" (diperlukan) |
| inline | Array perintah shell untuk dijalankan | string[] |
| scriptUri | URI skrip shell yang akan dijalankan untuk penyesuaian. Ini bisa menjadi tautan github, SAS URI untuk Azure Storage, dll | string |
| sha256Checksum | Checksum SHA256 dari skrip shell yang disediakan di bidang scriptUri | string |
ImageTemplateRestartCustomizer
| Nama | Deskripsi | Nilai |
|---|---|---|
| jenis | Jenis alat kustomisasi yang ingin Anda gunakan pada Gambar. Misalnya, "Shell" bisa menjadi penyesuai shell | "WindowsRestart" (diperlukan) |
| restartCheckCommand | Perintah untuk memeriksa apakah hidupkan ulang berhasil [Default: ''] | string |
| restartCommand | Perintah untuk menjalankan restart [Default: 'shutdown /r /f /t 0 /c "packer restart"'] | string |
| restartTimeout | Waktu habis hidupkan ulang yang ditentukan sebagai string besaran dan unit, misalnya '5m' (5 menit) atau '2 jam' (2 jam) [Default: '5m'] | string |
ImageTemplateWindowsUpdateCustomizer
| Nama | Deskripsi | Nilai |
|---|---|---|
| jenis | Jenis alat kustomisasi yang ingin Anda gunakan pada Gambar. Misalnya, "Shell" bisa menjadi penyesuai shell | "WindowsUpdate" (diperlukan) |
| filter | Array filter untuk memilih pembaruan yang akan diterapkan. Hilangkan atau tentukan array kosong untuk menggunakan default (tanpa filter). Lihat tautan di atas untuk contoh dan deskripsi terperinci dari bidang ini. | string[] |
| searchCriteria | Kriteria untuk mencari pembaruan. Hilangkan atau tentukan string kosong untuk menggunakan default (cari semua). Lihat tautan di atas untuk contoh dan deskripsi terperinci dari bidang ini. | string |
| updateLimit | Jumlah maksimum pembaruan yang akan diterapkan pada satu waktu. Hilangkan atau tentukan 0 untuk menggunakan default (1000) | int |
ImageTemplateDistributor
| Nama | Deskripsi | Nilai |
|---|---|---|
| artifactTags | Tag yang akan diterapkan ke artefak setelah dibuat/diperbarui oleh distributor. | objek |
| runOutputName | Nama yang akan digunakan untuk RunOutput terkait. | string (diperlukan) |
| jenis | Mengatur jenis objek | ManagedImage SharedImage VHD (diperlukan) |
ImageTemplateManagedImageDistributor
| Nama | Deskripsi | Nilai |
|---|---|---|
| jenis | Jenis distribusi. | "ManagedImage" (diperlukan) |
| imageId | Id Sumber Daya Dari Gambar Disk Terkelola | string (diperlukan) |
| lokasi | Lokasi Azure untuk gambar, harus cocok jika gambar sudah ada | string (diperlukan) |
ImageTemplateSharedImageDistributor
| Nama | Deskripsi | Nilai |
|---|---|---|
| jenis | Jenis distribusi. | "SharedImage" (diperlukan) |
| excludeFromLatest | Bendera yang menunjukkan apakah versi gambar yang dibuat harus dikecualikan dari yang terbaru. Hilangkan untuk menggunakan default (false). | bool |
| galleryImageId | Id Sumber Daya gambar Shared Image Gallery | string (diperlukan) |
| replicationRegions | Daftar wilayah tempat gambar akan direplikasi | string[] (diperlukan) |
| storageAccountType | Jenis akun penyimpanan yang akan digunakan untuk menyimpan gambar bersama. Hilangkan untuk menggunakan default (Standard_LRS). | "Standard_LRS" "Standard_ZRS" |
ImageTemplateVhdDistributor
| Nama | Deskripsi | Nilai |
|---|---|---|
| jenis | Jenis distribusi. | "VHD" (diperlukan) |
ImageTemplateSource
| Nama | Deskripsi | Nilai |
|---|---|---|
| jenis | Mengatur jenis objek | ManagedImage PlatformImage SharedImageVersion (diperlukan) |
ImageTemplateManagedImageSource
| Nama | Deskripsi | Nilai |
|---|---|---|
| jenis | Menentukan jenis gambar sumber yang ingin Anda mulai. | "ManagedImage" (diperlukan) |
| imageId | ID sumber daya ARM dari gambar terkelola dalam langganan pelanggan | string (diperlukan) |
ImageTemplatePlatformImageSource
| Nama | Deskripsi | Nilai |
|---|---|---|
| jenis | Menentukan jenis gambar sumber yang ingin Anda mulai. | "PlatformImage" (diperlukan) |
| offer | Penawaran gambar dari Gambar Galeri Azure. | string |
| planInfo | Konfigurasi opsional paket pembelian untuk gambar platform. | PlatformImagePurchasePlan |
| penerbit | Penerbit Gambar di Gambar Galeri Azure. | string |
| sku | Sku gambar dari Gambar Galeri Azure. | string |
| versi | Versi gambar dari Gambar Galeri Azure. Jika 'terbaru' ditentukan di sini, versi dievaluasi ketika build gambar berlangsung, bukan saat templat dikirimkan. | string |
PlatformImagePurchasePlan
| Nama | Deskripsi | Nilai |
|---|---|---|
| planName | Nama paket pembelian. | string (diperlukan) |
| planProduct | Produk dari paket pembelian. | string (diperlukan) |
| planPublisher | Penerbit paket pembelian. | string (diperlukan) |
ImageTemplateSharedImageVersionSource
| Nama | Deskripsi | Nilai |
|---|---|---|
| jenis | Menentukan jenis gambar sumber yang ingin Anda mulai. | "SharedImageVersion" (diperlukan) |
| imageVersionId | ID sumber daya ARM dari versi gambar di galeri gambar bersama | string (diperlukan) |
ImageTemplatePropertiesValidate
| Nama | Deskripsi | Nilai |
|---|---|---|
| continueDistributeOnFailure | Jika validasi gagal dan bidang ini diatur ke false, gambar output tidak akan didistribusikan. Ini adalah perilaku default. Jika validasi gagal dan bidang ini diatur ke true, gambar output masih akan didistribusikan. Harap gunakan opsi ini dengan hati-hati karena dapat mengakibatkan citra buruk didistribusikan untuk digunakan. Dalam kedua kasus (benar atau salah), eksekusi gambar end to end akan dilaporkan gagal jika terjadi kegagalan validasi. [Catatan: Bidang ini tidak berpengaruh jika validasi berhasil.] | bool |
| inVMValidations | Daftar validasi yang akan dilakukan. | ImageTemplateInVMValidator[] |
| sourceValidationOnly | Jika bidang ini diatur ke true, gambar yang ditentukan di bagian 'sumber' akan langsung divalidasi. Tidak ada build terpisah yang akan dijalankan untuk menghasilkan dan kemudian memvalidasi gambar yang disesuaikan. | bool |
ImageTemplateInVMValidator
| Nama | Deskripsi | Nilai |
|---|---|---|
| nama | Nama yang Mudah Diingat untuk memberikan konteks tentang apa yang dilakukan langkah validasi ini | string |
| jenis | Mengatur jenis objek | PowerShell Shell (diperlukan) |
ImageTemplatePowerShellValidator
| Nama | Deskripsi | Nilai |
|---|---|---|
| jenis | Jenis validasi yang ingin Anda gunakan pada Gambar. Misalnya, "Shell" bisa menjadi validasi shell | "PowerShell" (diperlukan) |
| inline | Array perintah PowerShell untuk dijalankan | string[] |
| runAsSystem | Jika ditentukan, skrip PowerShell akan dijalankan dengan hak istimewa yang ditingkatkan menggunakan pengguna Sistem Lokal. Hanya dapat benar ketika bidang runElevated di atas diatur ke true. | bool |
| runElevated | Jika ditentukan, skrip PowerShell akan dijalankan dengan hak istimewa yang ditingkatkan | bool |
| scriptUri | URI skrip PowerShell yang akan dijalankan untuk validasi. Ini bisa menjadi tautan github, URI Azure Storage, dll | string |
| sha256Checksum | Checksum SHA256 dari skrip shell daya yang disediakan di bidang scriptUri di atas | string |
| validExitCodes | Kode keluar yang valid untuk skrip PowerShell. [Default: 0] | int[] |
ImageTemplateShellValidator
| Nama | Deskripsi | Nilai |
|---|---|---|
| jenis | Jenis validasi yang ingin Anda gunakan pada Gambar. Misalnya, "Shell" bisa menjadi validasi shell | "Shell" (diperlukan) |
| inline | Array perintah shell untuk dijalankan | string[] |
| scriptUri | URI skrip shell yang akan dijalankan untuk validasi. Ini bisa menjadi tautan github, URI Azure Storage, dll | string |
| sha256Checksum | Checksum SHA256 dari skrip shell yang disediakan di bidang scriptUri | string |
ImageTemplateVmProfile
| Nama | Deskripsi | Nilai |
|---|---|---|
| osDiskSizeGB | Ukuran disk OS dalam GB. Hilangkan atau tentukan 0 untuk menggunakan ukuran disk OS default Azure. | int |
| userAssignedIdentities | Array opsional ID sumber daya dari identitas terkelola yang ditetapkan pengguna untuk dikonfigurasi pada VM build dan VM validasi. Ini mungkin termasuk identitas templat gambar. | string[] |
| vmSize | Ukuran komputer virtual yang digunakan untuk membangun, menyesuaikan, dan menangkap gambar. Hilangkan atau tentukan string kosong untuk menggunakan default (Standard_D1_v2 untuk gambar Gen1 dan Standard_D2ds_v4 untuk gambar Gen2). | string |
| vnetConfig | Konfigurasi opsional jaringan virtual yang akan digunakan untuk menyebarkan VM build dan VM validasi. Abaikan jika tidak ada jaringan virtual tertentu yang perlu digunakan. | VirtualNetworkConfig |
VirtualNetworkConfig
| Nama | Deskripsi | Nilai |
|---|---|---|
| proxyVmSize | Ukuran komputer virtual proksi yang digunakan untuk meneruskan lalu lintas ke VM build dan VM validasi. Hilangkan atau tentukan string kosong untuk menggunakan default (Standard_A1_v2). | string |
| subnetId | Id sumber daya subnet yang sudah ada sebelumnya. | string |
Saran dan Komentar
Segera hadir: Sepanjang tahun 2024 kami akan menghentikan penggunaan GitHub Issues sebagai mekanisme umpan balik untuk konten dan menggantinya dengan sistem umpan balik baru. Untuk mengetahui informasi selengkapnya, lihat: https://aka.ms/ContentUserFeedback.
Kirim dan lihat umpan balik untuk