Microsoft.VirtualMachineImages ImageTemplates
Definizione di risorsa Bicep
Il tipo di risorsa imageTemplates può essere distribuito in:
- Gruppi di risorse - Vedere i comandi di distribuzione dei gruppi di risorse
Per un elenco delle proprietà modificate in ogni versione dell'API, vedere Log delle modifiche.
Formato di risorsa
Per creare una risorsa Microsoft.VirtualMachineImages/imageTemplates, aggiungere il bicep seguente al modello.
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'
}
}
}
}
Oggetti ImageTemplateCustomizer
Impostare la proprietà type per specificare il tipo di oggetto.
Per File usare:
type: 'File'
destination: 'string'
sha256Checksum: 'string'
sourceUri: 'string'
Per PowerShell usare:
type: 'PowerShell'
inline: [
'string'
]
runAsSystem: bool
runElevated: bool
scriptUri: 'string'
sha256Checksum: 'string'
validExitCodes: [
int
]
Per Shell usare:
type: 'Shell'
inline: [
'string'
]
scriptUri: 'string'
sha256Checksum: 'string'
Per WindowsRestart, usare:
type: 'WindowsRestart'
restartCheckCommand: 'string'
restartCommand: 'string'
restartTimeout: 'string'
Per WindowsUpdate, usare:
type: 'WindowsUpdate'
filters: [
'string'
]
searchCriteria: 'string'
updateLimit: int
Oggetti ImageTemplateDistributor
Impostare la proprietà type per specificare il tipo di oggetto.
Per ManagedImage usare:
type: 'ManagedImage'
imageId: 'string'
location: 'string'
Per SharedImage usare:
type: 'SharedImage'
excludeFromLatest: bool
galleryImageId: 'string'
replicationRegions: [
'string'
]
storageAccountType: 'string'
Per il disco rigido virtuale, usare:
type: 'VHD'
Oggetti ImageTemplateSource
Impostare la proprietà type per specificare il tipo di oggetto.
Per ManagedImage usare:
type: 'ManagedImage'
imageId: 'string'
Per PlatformImage usare:
type: 'PlatformImage'
offer: 'string'
planInfo: {
planName: 'string'
planProduct: 'string'
planPublisher: 'string'
}
publisher: 'string'
sku: 'string'
version: 'string'
Per SharedImageVersion, usare:
type: 'SharedImageVersion'
imageVersionId: 'string'
Oggetti ImageTemplateInVMValidator
Impostare la proprietà type per specificare il tipo di oggetto.
Per PowerShell usare:
type: 'PowerShell'
inline: [
'string'
]
runAsSystem: bool
runElevated: bool
scriptUri: 'string'
sha256Checksum: 'string'
validExitCodes: [
int
]
Per Shell usare:
type: 'Shell'
inline: [
'string'
]
scriptUri: 'string'
sha256Checksum: 'string'
Valori delle proprietà
imageTemplates
| Nome | Descrizione | valore |
|---|---|---|
| name | Nome della risorsa | stringa (obbligatorio) |
| posizione | Posizione geografica in cui risiede la risorsa | stringa (obbligatorio) |
| tags | Tag delle risorse. | Dizionario di nomi e valori di tag. Vedere Tag nei modelli |
| identity | Identità del modello di immagine, se configurata. | ImageTemplateIdentity (obbligatorio) |
| properties | Proprietà del modello di immagine | ImageTemplateProperties |
ImageTemplateIdentity
| Nome | Descrizione | Valore |
|---|---|---|
| tipo | Tipo di identità usato per il modello di immagine. Il tipo "Nessuno" rimuoverà le identità dal modello di immagine. | 'Nessuno' 'UserAssigned' |
| userAssignedIdentities | Elenco di identità utente associate al modello di immagine. I riferimenti alla chiave del dizionario identità utente saranno ID risorsa ARM nel formato :'/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ManagedIdentity/userAssignedIdentities/{identityName}'. | object |
ImageTemplateProperties
| Nome | Descrizione | Valore |
|---|---|---|
| buildTimeoutInMinutes | Durata massima di attesa durante la compilazione del modello di immagine (include tutte le personalizzazioni, le convalide e le distribuzioni). Omettere o specificare 0 per usare il valore predefinito (4 ore). | INT |
| personalizzazione | Specifica le proprietà usate per descrivere i passaggi di personalizzazione dell'immagine, ad esempio Origine immagine e così via | ImageTemplateCustomizer[] |
| distribuire | Le destinazioni di distribuzione in cui l'output dell'immagine deve passare. | ImageTemplateDistributor[] (obbligatorio) |
| source | Specifica le proprietà utilizzate per descrivere l'immagine di origine. | ImageTemplateSource (obbligatorio) |
| stagingResourceGroup | ID del gruppo di risorse di staging nella stessa sottoscrizione del modello di immagine che verrà usato per compilare l'immagine. Se questo campo è vuoto, verrà creato un gruppo di risorse con un nome casuale. Se il gruppo di risorse specificato in questo campo non esiste, verrà creato con lo stesso nome. Se il gruppo di risorse specificato esiste, deve essere vuoto e nella stessa area del modello di immagine. Il gruppo di risorse creato verrà eliminato durante l'eliminazione del modello se questo campo è vuoto o il gruppo di risorse specificato non esiste, ma se il gruppo di risorse specificato esiste, le risorse create nel gruppo di risorse verranno eliminate durante l'eliminazione del modello e il gruppo di risorse stesso rimarrà. | string |
| validate | Opzioni di configurazione e elenco di convalide da eseguire sull'immagine risultante. | ImageTemplatePropertiesValidate |
| vmProfile | Descrive come viene configurata la macchina virtuale per la compilazione di immagini | ImageTemplateVmProfile |
ImageTemplateCustomizer
| Nome | Descrizione | valore |
|---|---|---|
| name | Nome descrittivo per fornire contesto sulle operazioni eseguite da questo passaggio di personalizzazione | string |
| type | Impostare il tipo di oggetto | File PowerShell Shell WindowsRestart WindowsUpdate (obbligatorio) |
ImageTemplateFileCustomizer
| Nome | Descrizione | Valore |
|---|---|---|
| tipo | Tipo di strumento di personalizzazione da usare nell'immagine. Ad esempio, "Shell" può essere personalizzatore della shell | 'File' (obbligatorio) |
| destination | Percorso assoluto di un file (con strutture di directory annidate già create) in cui il file (da sourceUri) verrà caricato nella macchina virtuale | string |
| sha256Checksum | CHECKSUM SHA256 del file fornito nel campo sourceUri precedente | string |
| Sourceuri | URI del file da caricare per la personalizzazione della macchina virtuale. Può trattarsi di un collegamento github, di un URI di firma di accesso condiviso per Archiviazione di Azure e così via | string |
ImageTemplatePowerShellCustomizer
| Nome | Descrizione | Valore |
|---|---|---|
| tipo | Tipo di strumento di personalizzazione da usare nell'immagine. Ad esempio, "Shell" può essere personalizzatore della shell | 'PowerShell' (obbligatorio) |
| inline | Matrice di comandi di PowerShell da eseguire | string[] |
| runAsSystem | Se specificato, lo script di PowerShell verrà eseguito con privilegi elevati usando l'utente del sistema locale. Può essere true solo quando il campo runElevated precedente è impostato su true. | bool |
| runElevated | Se specificato, lo script di PowerShell verrà eseguito con privilegi elevati | bool |
| scriptUri | URI dello script di PowerShell da eseguire per la personalizzazione. Può trattarsi di un collegamento github, di un URI di firma di accesso condiviso per Archiviazione di Azure e così via | string |
| sha256Checksum | CHECKSUM SHA256 dello script power shell fornito nel campo scriptUri precedente | string |
| validExitCodes | Codici di uscita validi per lo script di PowerShell. [Impostazione predefinita: 0] | int[] |
ImageTemplateShellCustomizer
| Nome | Descrizione | Valore |
|---|---|---|
| tipo | Tipo di strumento di personalizzazione da usare nell'immagine. Ad esempio, "Shell" può essere personalizzatore della shell | 'Shell' (obbligatorio) |
| inline | Matrice di comandi della shell da eseguire | string[] |
| scriptUri | URI dello script della shell da eseguire per la personalizzazione. Può trattarsi di un collegamento github, di un URI di firma di accesso condiviso per Archiviazione di Azure e così via | string |
| sha256Checksum | CHECKSUM SHA256 dello script della shell fornito nel campo scriptUri | string |
ImageTemplateRestartCustomizer
| Nome | Descrizione | Valore |
|---|---|---|
| tipo | Tipo di strumento di personalizzazione da usare nell'immagine. Ad esempio, "Shell" può essere personalizzatore della shell | 'WindowsRestart' (obbligatorio) |
| restartCheckCommand | Comando per verificare se il riavvio è riuscito [Impostazione predefinita: ''] | string |
| restartCommand | Comando per eseguire il riavvio [Predefinito: 'shutdown /r /f /t 0 /c "packer restart"'] | string |
| restartTimeout | Timeout del riavvio specificato come stringa di grandezza e unità, ad esempio '5m' (5 minuti) o '2h' (2 ore) [Impostazione predefinita: '5m'] | string |
ImageTemplateWindowsUpdateCustomizer
| Nome | Descrizione | Valore |
|---|---|---|
| tipo | Tipo di strumento di personalizzazione da usare nell'immagine. Ad esempio, "Shell" può essere personalizzatore della shell | 'WindowsUpdate' (obbligatorio) |
| filters | Matrice di filtri per selezionare gli aggiornamenti da applicare. Omettere o specificare una matrice vuota per usare il valore predefinito (nessun filtro). Fare riferimento al collegamento precedente per esempi e descrizione dettagliata di questo campo. | string[] |
| searchCriteria | Criteri per la ricerca degli aggiornamenti. Omettere o specificare una stringa vuota per usare il valore predefinito (eseguire ricerche in tutti). Fare riferimento al collegamento precedente per esempi e descrizione dettagliata di questo campo. | string |
| updateLimit | Numero massimo di aggiornamenti da applicare alla volta. Omettere o specificare 0 per usare il valore predefinito (1000) | INT |
ImageTemplateDistributor
| Nome | Descrizione | Valore |
|---|---|---|
| artifactTags | Tag che verranno applicati all'artefatto dopo che è stato creato/aggiornato dal server di distribuzione. | object |
| runOutputName | Nome da utilizzare per l'oggetto RunOutput associato. | stringa (obbligatorio) |
| tipo | Impostare il tipo di oggetto | ManagedImage SharedImage Disco rigido virtuale (obbligatorio) |
ImageTemplateManagedImageDistributor
| Nome | Descrizione | Valore |
|---|---|---|
| tipo | Tipo di distribuzione. | 'ManagedImage' (obbligatorio) |
| imageId | ID risorsa dell'immagine del disco gestito | stringa (obbligatorio) |
| posizione | La posizione di Azure per l'immagine deve corrispondere se l'immagine esiste già | stringa (obbligatorio) |
ImageTemplateSharedImageDistributor
| Nome | Descrizione | Valore |
|---|---|---|
| tipo | Tipo di distribuzione. | 'SharedImage' (obbligatorio) |
| excludeFromLatest | Flag che indica se la versione dell'immagine creata deve essere esclusa dalla versione più recente. Omettere di usare il valore predefinito (false). | bool |
| galleryImageId | ID risorsa dell'immagine Raccolta immagini condivise | stringa (obbligatorio) |
| replicationRegions | Elenco di aree in cui verrà replicata l'immagine | string[] (obbligatorio) |
| storageAccountType | Tipo di account di archiviazione da usare per archiviare l'immagine condivisa. Omettere di usare il valore predefinito (Standard_LRS). | 'Standard_LRS' 'Standard_ZRS' |
ImageTemplateVhdDistributor
| Nome | Descrizione | Valore |
|---|---|---|
| tipo | Tipo di distribuzione. | 'VHD' (obbligatorio) |
ImageTemplateSource
| Nome | Descrizione | Valore |
|---|---|---|
| tipo | Impostare il tipo di oggetto | ManagedImage PlatformImage SharedImageVersion (obbligatorio) |
ImageTemplateManagedImageSource
| Nome | Descrizione | Valore |
|---|---|---|
| tipo | Specifica il tipo di immagine di origine da cui iniziare. | 'ManagedImage' (obbligatorio) |
| imageId | ID risorsa ARM dell'immagine gestita nella sottoscrizione del cliente | stringa (obbligatorio) |
ImageTemplatePlatformImageSource
| Nome | Descrizione | Valore |
|---|---|---|
| tipo | Specifica il tipo di immagine di origine da cui iniziare. | 'PlatformImage' (obbligatorio) |
| offer | Offerta di immagine dalle immagini della raccolta di Azure. | string |
| planInfo | Configurazione facoltativa del piano di acquisto per l'immagine della piattaforma. | PlatformImagePurchasePlan |
| publisher | Image Publisher nelle immagini della raccolta di Azure. | string |
| sku | Sku dell'immagine dalle immagini della raccolta di Azure. | string |
| version | Versione dell'immagine dalle immagini della raccolta di Azure. Se in questo caso viene specificato "latest", la versione viene valutata quando viene eseguita la compilazione dell'immagine, non quando viene inviato il modello. | string |
PlatformImagePurchasePlan
| Nome | Descrizione | Valore |
|---|---|---|
| planName | Nome del piano di acquisto. | stringa (obbligatorio) |
| planProduct | Prodotto del piano di acquisto. | stringa (obbligatorio) |
| planPublisher | Autore del piano di acquisto. | stringa (obbligatorio) |
ImageTemplateSharedImageVersionSource
| Nome | Descrizione | Valore |
|---|---|---|
| tipo | Specifica il tipo di immagine di origine da cui iniziare. | 'SharedImageVersion' (obbligatorio) |
| imageVersionId | ID risorsa ARM della versione dell'immagine nella raccolta di immagini condivise | stringa (obbligatorio) |
ImageTemplatePropertiesValidate
| Nome | Descrizione | Valore |
|---|---|---|
| continueDistributeOnFailure | Se la convalida non riesce e questo campo è impostato su false, le immagini di output non verranno distribuite. Questo è il comportamento predefinito. Se la convalida ha esito negativo e questo campo è impostato su true, le immagini di output verranno comunque distribuite. Usare questa opzione con cautela perché potrebbe causare la distribuzione di immagini non dannose per l'uso. In entrambi i casi (true o false), l'esecuzione dell'immagine end-to-end verrà segnalata come non riuscita in caso di errore di convalida. [Nota: questo campo non ha effetto se la convalida riesce.] | bool |
| inVMValidations | Elenco delle convalide da eseguire. | ImageTemplateInVMValidator[] |
| sourceValidationOnly | Se questo campo è impostato su true, l'immagine specificata nella sezione 'source' verrà convalidata direttamente. Non verrà eseguita alcuna compilazione separata per generare e quindi convalidare un'immagine personalizzata. | bool |
ImageTemplateInVMValidator
| Nome | Descrizione | valore |
|---|---|---|
| name | Nome descrittivo per fornire contesto sulle operazioni eseguite da questo passaggio di convalida | string |
| type | Impostare il tipo di oggetto | PowerShell Shell (obbligatorio) |
ImageTemplatePowerShellValidator
| Nome | Descrizione | Valore |
|---|---|---|
| tipo | Tipo di convalida da usare nell'immagine. Ad esempio, "Shell" può essere convalida della shell | 'PowerShell' (obbligatorio) |
| inline | Matrice di comandi di PowerShell da eseguire | string[] |
| runAsSystem | Se specificato, lo script di PowerShell verrà eseguito con privilegi elevati usando l'utente del sistema locale. Può essere true solo quando il campo runElevated precedente è impostato su true. | bool |
| runElevated | Se specificato, lo script di PowerShell verrà eseguito con privilegi elevati | bool |
| scriptUri | URI dello script di PowerShell da eseguire per la convalida. Può trattarsi di un collegamento github, un URI di Archiviazione di Azure e così via | string |
| sha256Checksum | CHECKSUM SHA256 dello script power shell fornito nel campo scriptUri precedente | string |
| validExitCodes | Codici di uscita validi per lo script di PowerShell. [Impostazione predefinita: 0] | int[] |
ImageTemplateShellValidator
| Nome | Descrizione | Valore |
|---|---|---|
| tipo | Tipo di convalida da usare nell'immagine. Ad esempio, "Shell" può essere convalida della shell | 'Shell' (obbligatorio) |
| inline | Matrice di comandi della shell da eseguire | string[] |
| scriptUri | URI dello script della shell da eseguire per la convalida. Può essere un collegamento github, l'URI di Archiviazione di Azure e così via | string |
| sha256Checksum | CHECKSUM SHA256 dello script della shell fornito nel campo scriptUri | string |
ImageTemplateVmProfile
| Nome | Descrizione | Valore |
|---|---|---|
| osDiskSizeGB | Dimensioni del disco del sistema operativo in GB. Omettere o specificare 0 per usare le dimensioni predefinite del disco del sistema operativo di Azure. | INT |
| userAssignedIdentities | Matrice facoltativa di ID risorsa di identità gestite assegnate dall'utente da configurare nella macchina virtuale di compilazione e nella macchina virtuale di convalida. Ciò può includere l'identità del modello di immagine. | string[] |
| vmSize | Dimensioni della macchina virtuale usata per compilare, personalizzare e acquisire immagini. Omettere o specificare una stringa vuota per usare il valore predefinito (Standard_D1_v2 per le immagini Gen1 e Standard_D2ds_v4 per le immagini Gen2). | string |
| vnetConfig | Configurazione facoltativa della rete virtuale da usare per distribuire la macchina virtuale di compilazione e la macchina virtuale di convalida in. Omettere se non deve essere usata alcuna rete virtuale specifica. | VirtualNetworkConfig |
VirtualNetworkConfig
| Nome | Descrizione | Valore |
|---|---|---|
| proxyVmSize | Dimensioni della macchina virtuale proxy usata per passare il traffico alla macchina virtuale di compilazione e alla macchina virtuale di convalida. Omettere o specificare una stringa vuota per usare il valore predefinito (Standard_A1_v2). | string |
| subnetId | ID risorsa di una subnet preesistente. | string |
Modelli di avvio rapido
I modelli di avvio rapido seguenti distribuiscono questo tipo di risorsa.
| Modello | Descrizione |
|---|---|
Generatore immagini di Azure con baseline di Windows di Azure |
Crea un ambiente Azure Image Builder e compila un'immagine di Windows Server con l'ultima Aggiornamenti windows e la baseline di Windows di Azure applicata. |
| Configurare il servizio Dev Box |
Questo modello crea tutte le risorse di amministratore di Dev Box come guida introduttiva di Dev Box. È possibile visualizzare tutte le risorse create o passare direttamente a DevPortal.microsoft.com per creare il primo Dev Box. |
Definizione della risorsa modello di Resource Manager
Il tipo di risorsa imageTemplates può essere distribuito in:
- Gruppi di risorse - Vedere i comandi di distribuzione del gruppo di risorse
Per un elenco delle proprietà modificate in ogni versione dell'API, vedere log delle modifiche.
Formato di risorsa
Per creare una risorsa Microsoft.VirtualMachineImages/imageTemplates, aggiungere il codice JSON seguente al modello.
{
"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"
}
}
}
}
Oggetti ImageTemplateCustomizer
Impostare la proprietà type per specificare il tipo di oggetto.
Per File, usare:
"type": "File",
"destination": "string",
"sha256Checksum": "string",
"sourceUri": "string"
Per PowerShell, usare:
"type": "PowerShell",
"inline": [ "string" ],
"runAsSystem": "bool",
"runElevated": "bool",
"scriptUri": "string",
"sha256Checksum": "string",
"validExitCodes": [ "int" ]
Per Shell, usare:
"type": "Shell",
"inline": [ "string" ],
"scriptUri": "string",
"sha256Checksum": "string"
Per WindowsRestart, usare:
"type": "WindowsRestart",
"restartCheckCommand": "string",
"restartCommand": "string",
"restartTimeout": "string"
Per WindowsUpdate, usare:
"type": "WindowsUpdate",
"filters": [ "string" ],
"searchCriteria": "string",
"updateLimit": "int"
Oggetti ImageTemplateDistributor
Impostare la proprietà type per specificare il tipo di oggetto.
Per ManagedImage, usare:
"type": "ManagedImage",
"imageId": "string",
"location": "string"
Per SharedImage, usare:
"type": "SharedImage",
"excludeFromLatest": "bool",
"galleryImageId": "string",
"replicationRegions": [ "string" ],
"storageAccountType": "string"
Per il disco rigido virtuale, usare:
"type": "VHD"
Oggetti ImageTemplateSource
Impostare la proprietà type per specificare il tipo di oggetto.
Per ManagedImage, usare:
"type": "ManagedImage",
"imageId": "string"
Per PlatformImage usare:
"type": "PlatformImage",
"offer": "string",
"planInfo": {
"planName": "string",
"planProduct": "string",
"planPublisher": "string"
},
"publisher": "string",
"sku": "string",
"version": "string"
Per SharedImageVersion, usare:
"type": "SharedImageVersion",
"imageVersionId": "string"
Oggetti ImageTemplateInVMValidator
Impostare la proprietà type per specificare il tipo di oggetto.
Per PowerShell, usare:
"type": "PowerShell",
"inline": [ "string" ],
"runAsSystem": "bool",
"runElevated": "bool",
"scriptUri": "string",
"sha256Checksum": "string",
"validExitCodes": [ "int" ]
Per Shell, usare:
"type": "Shell",
"inline": [ "string" ],
"scriptUri": "string",
"sha256Checksum": "string"
Valori delle proprietà
imageTemplates
| Nome | Descrizione | Valore |
|---|---|---|
| tipo | Tipo di risorsa | 'Microsoft.VirtualMachineImages/imageTemplates' |
| apiVersion | Versione dell'API risorsa | '2022-02-14' |
| name | Nome della risorsa | stringa (obbligatorio) |
| posizione | Posizione geografica in cui risiede la risorsa | stringa (obbligatorio) |
| tags | Tag delle risorse. | Dizionario di nomi e valori di tag. Vedere Tag nei modelli |
| identity | Identità del modello di immagine, se configurata. | ImageTemplateIdentity (obbligatorio) |
| properties | Proprietà del modello di immagine | ImageTemplateProperties |
ImageTemplateIdentity
| Nome | Descrizione | Valore |
|---|---|---|
| tipo | Tipo di identità usato per il modello di immagine. Il tipo "Nessuno" rimuoverà le identità dal modello di immagine. | 'Nessuno' 'UserAssigned' |
| userAssignedIdentities | Elenco di identità utente associate al modello di immagine. I riferimenti alla chiave del dizionario identità utente saranno ID risorsa ARM nel formato :'/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ManagedIdentity/userAssignedIdentities/{identityName}'. | object |
ImageTemplateProperties
| Nome | Descrizione | Valore |
|---|---|---|
| buildTimeoutInMinutes | Durata massima di attesa durante la compilazione del modello di immagine (include tutte le personalizzazioni, le convalide e le distribuzioni). Omettere o specificare 0 per usare il valore predefinito (4 ore). | INT |
| personalizzazione | Specifica le proprietà usate per descrivere i passaggi di personalizzazione dell'immagine, ad esempio Origine immagine e così via | ImageTemplateCustomizer[] |
| distribuire | Le destinazioni di distribuzione in cui l'output dell'immagine deve passare. | ImageTemplateDistributor[] (obbligatorio) |
| source | Specifica le proprietà utilizzate per descrivere l'immagine di origine. | ImageTemplateSource (obbligatorio) |
| stagingResourceGroup | ID del gruppo di risorse di staging nella stessa sottoscrizione del modello di immagine che verrà usato per compilare l'immagine. Se questo campo è vuoto, verrà creato un gruppo di risorse con un nome casuale. Se il gruppo di risorse specificato in questo campo non esiste, verrà creato con lo stesso nome. Se il gruppo di risorse specificato esiste, deve essere vuoto e nella stessa area del modello di immagine. Il gruppo di risorse creato verrà eliminato durante l'eliminazione del modello se questo campo è vuoto o il gruppo di risorse specificato non esiste, ma se il gruppo di risorse specificato esiste, le risorse create nel gruppo di risorse verranno eliminate durante l'eliminazione del modello e il gruppo di risorse stesso rimarrà. | string |
| validate | Opzioni di configurazione e elenco di convalide da eseguire sull'immagine risultante. | ImageTemplatePropertiesValidate |
| vmProfile | Descrive come viene configurata la macchina virtuale per la compilazione di immagini | ImageTemplateVmProfile |
ImageTemplateCustomizer
| Nome | Descrizione | valore |
|---|---|---|
| name | Nome descrittivo per fornire contesto sulle operazioni eseguite da questo passaggio di personalizzazione | string |
| type | Impostare il tipo di oggetto | File PowerShell Shell WindowsRestart WindowsUpdate (obbligatorio) |
ImageTemplateFileCustomizer
| Nome | Descrizione | Valore |
|---|---|---|
| tipo | Tipo di strumento di personalizzazione da usare nell'immagine. Ad esempio, "Shell" può essere personalizzatore della shell | 'File' (obbligatorio) |
| destination | Percorso assoluto di un file (con strutture di directory annidate già create) in cui il file (da sourceUri) verrà caricato nella macchina virtuale | string |
| sha256Checksum | CHECKSUM SHA256 del file fornito nel campo sourceUri precedente | string |
| Sourceuri | URI del file da caricare per la personalizzazione della macchina virtuale. Può trattarsi di un collegamento github, di un URI di firma di accesso condiviso per Archiviazione di Azure e così via | string |
ImageTemplatePowerShellCustomizer
| Nome | Descrizione | Valore |
|---|---|---|
| tipo | Tipo di strumento di personalizzazione da usare nell'immagine. Ad esempio, "Shell" può essere personalizzatore della shell | 'PowerShell' (obbligatorio) |
| inline | Matrice di comandi di PowerShell da eseguire | string[] |
| runAsSystem | Se specificato, lo script di PowerShell verrà eseguito con privilegi elevati usando l'utente del sistema locale. Può essere true solo quando il campo runElevated sopra è impostato su true. | bool |
| runElevated | Se specificato, lo script di PowerShell verrà eseguito con privilegi elevati | bool |
| scriptUri | URI dello script di PowerShell da eseguire per la personalizzazione. Può essere un collegamento github, un URI di firma di accesso condiviso per Archiviazione di Azure e così via | string |
| sha256Checksum | CHECKSUM SHA256 dello script di Power Shell fornito nel campo scriptUri precedente | string |
| validExitCodes | Codici di uscita validi per lo script di PowerShell. [Impostazione predefinita: 0] | int[] |
ImageTemplateShellCustomizer
| Nome | Descrizione | Valore |
|---|---|---|
| tipo | Tipo di strumento di personalizzazione che si vuole usare nell'immagine. Ad esempio, "Shell" può essere la personalizzazione della shell | 'Shell' (obbligatorio) |
| inline | Matrice di comandi della shell da eseguire | string[] |
| scriptUri | URI dello script della shell da eseguire per la personalizzazione. Può essere un collegamento github, un URI di firma di accesso condiviso per Archiviazione di Azure e così via | string |
| sha256Checksum | CHECKSUM SHA256 dello script della shell fornito nel campo scriptUri | string |
ImageTemplateRestartCustomizer
| Nome | Descrizione | Valore |
|---|---|---|
| tipo | Tipo di strumento di personalizzazione che si vuole usare nell'immagine. Ad esempio, "Shell" può essere la personalizzazione della shell | 'WindowsRestart' (obbligatorio) |
| restartCheckCommand | Comando per verificare se il riavvio ha avuto esito positivo [Impostazione predefinita: ''] | string |
| restartCommand | Comando per eseguire il riavvio [Impostazione predefinita: 'shutdown /r /f /t 0 /c "packer restart"] | string |
| restartTimeout | Timeout di riavvio specificato come stringa di grandezza e unità, ad esempio '5m' (5 minuti) o '2h' (2 ore) [Default: '5m'] | string |
ImageTemplateWindowsUpdateCustomizer
| Nome | Descrizione | Valore |
|---|---|---|
| tipo | Tipo di strumento di personalizzazione che si vuole usare nell'immagine. Ad esempio, "Shell" può essere la personalizzazione della shell | 'WindowsUpdate' (obbligatorio) |
| filters | Matrice di filtri per selezionare gli aggiornamenti da applicare. Omettere o specificare una matrice vuota per usare il valore predefinito (nessun filtro). Fare riferimento al collegamento precedente per esempi e descrizione dettagliata di questo campo. | string[] |
| searchCriteria | Criteri per la ricerca degli aggiornamenti. Omettere o specificare una stringa vuota per usare il valore predefinito (cercare tutto). Fare riferimento al collegamento precedente per esempi e descrizione dettagliata di questo campo. | string |
| updateLimit | Numero massimo di aggiornamenti da applicare alla volta. Omettere o specificare 0 per usare il valore predefinito (1000) | INT |
ImageTemplateDistributor
| Nome | Descrizione | Valore |
|---|---|---|
| artifactTags | Tag che verranno applicati all'artefatto una volta creato/aggiornato dal server di distribuzione. | object |
| runOutputName | Nome da utilizzare per RunOutput associato. | stringa (obbligatoria) |
| tipo | Impostare il tipo di oggetto | ManagedImage SharedImage Disco rigido virtuale (obbligatorio) |
ImageTemplateManagedImageDistributor
| Nome | Descrizione | Valore |
|---|---|---|
| tipo | Tipo di distribuzione. | 'ManagedImage' (obbligatorio) |
| imageId | ID risorsa dell'immagine del disco gestito | stringa (obbligatoria) |
| posizione | Percorso di Azure per l'immagine, deve corrispondere se l'immagine esiste già | stringa (obbligatoria) |
ImageTemplateSharedImageDistributor
| Nome | Descrizione | Valore |
|---|---|---|
| tipo | Tipo di distribuzione. | 'SharedImage' (obbligatorio) |
| excludeFromLatest | Flag che indica se la versione dell'immagine creata deve essere esclusa dalla versione più recente. Omettere di usare il valore predefinito (false). | bool |
| galleryImageId | ID risorsa dell'immagine Raccolta immagini condivise | stringa (obbligatoria) |
| replicationRegions | Elenco di aree in cui verrà replicata l'immagine | string[] (obbligatorio) |
| storageAccountType | Tipo di account di archiviazione da usare per archiviare l'immagine condivisa. Omettere di usare il valore predefinito (Standard_LRS). | 'Standard_LRS' 'Standard_ZRS' |
ImageTemplateVhdDistributor
| Nome | Descrizione | Valore |
|---|---|---|
| tipo | Tipo di distribuzione. | 'VHD' (obbligatorio) |
ImageTemplateSource
| Nome | Descrizione | Valore |
|---|---|---|
| tipo | Impostare il tipo di oggetto | ManagedImage PlatformImage SharedImageVersion (obbligatorio) |
ImageTemplateManagedImageSource
| Nome | Descrizione | Valore |
|---|---|---|
| tipo | Specifica il tipo di immagine di origine da iniziare. | 'ManagedImage' (obbligatorio) |
| imageId | ID risorsa ARM dell'immagine gestita nella sottoscrizione del cliente | stringa (obbligatoria) |
ImageTemplatePlatformImageSource
| Nome | Descrizione | Valore |
|---|---|---|
| tipo | Specifica il tipo di immagine di origine da iniziare. | 'PlatformImage' (obbligatorio) |
| offer | Offerta di immagine dalle immagini di Raccolta di Azure. | string |
| planInfo | Configurazione facoltativa del piano di acquisto per l'immagine della piattaforma. | PlatformImagePurchasePlan |
| publisher | Image Publisher in Immagini di Raccolta di Azure. | string |
| sku | Sku di immagine dalle immagini di Raccolta di Azure. | string |
| version | Versione dell'immagine dalle immagini di Raccolta di Azure. Se viene specificato 'latest' qui, la versione viene valutata quando viene eseguita la compilazione dell'immagine, non quando viene inviato il modello. | string |
PlatformImagePurchasePlan
| Nome | Descrizione | Valore |
|---|---|---|
| planName | Nome del piano di acquisto. | stringa (obbligatoria) |
| planProduct | Prodotto del piano di acquisto. | stringa (obbligatoria) |
| planPublisher | Autore del piano di acquisto. | stringa (obbligatoria) |
ImageTemplateSharedImageVersionSource
| Nome | Descrizione | Valore |
|---|---|---|
| tipo | Specifica il tipo di immagine di origine da iniziare. | 'SharedImageVersion' (obbligatorio) |
| imageVersionId | ID risorsa ARM della versione dell'immagine nella raccolta di immagini condivise | stringa (obbligatoria) |
ImageTemplatePropertiesValidate
| Nome | Descrizione | Valore |
|---|---|---|
| continueDistributeOnFailure | Se la convalida ha esito negativo e questo campo è impostato su false, le immagini di output non verranno distribuite. Questo è il comportamento predefinito. Se la convalida ha esito negativo e questo campo è impostato su true, le immagini di output verranno comunque distribuite. Usare questa opzione con cautela perché può causare la distribuzione di immagini non valida per l'uso. In entrambi i casi (true o false), l'esecuzione dell'immagine end-to-end verrà segnalata come non riuscita in caso di errore di convalida. [Nota: questo campo non ha effetto se la convalida riesce.] | bool |
| inVMValidations | Elenco delle convalida da eseguire. | ImageTemplateInVMValidator[] |
| sourceValidationOnly | Se questo campo è impostato su true, l'immagine specificata nella sezione 'source' verrà convalidata direttamente. Nessuna compilazione separata verrà eseguita per generare e quindi convalidare un'immagine personalizzata. | bool |
ImageTemplateInVMValidator
| Nome | Descrizione | valore |
|---|---|---|
| name | Nome descrittivo per fornire il contesto su ciò che fa questo passaggio di convalida | string |
| type | Impostare il tipo di oggetto | PowerShell Shell (obbligatorio) |
ImageTemplatePowerShellValidator
| Nome | Descrizione | Valore |
|---|---|---|
| tipo | Tipo di convalida da usare nell'immagine. Ad esempio, "Shell" può essere convalida della shell | 'PowerShell' (obbligatorio) |
| inline | Matrice di comandi di PowerShell da eseguire | string[] |
| runAsSystem | Se specificato, lo script di PowerShell verrà eseguito con privilegi elevati usando l'utente del sistema locale. Può essere true solo quando il campo runElevated sopra è impostato su true. | bool |
| runElevated | Se specificato, lo script di PowerShell verrà eseguito con privilegi elevati | bool |
| scriptUri | URI dello script di PowerShell da eseguire per la convalida. Può essere un collegamento github, l'URI di Archiviazione di Azure e così via | string |
| sha256Checksum | CHECKSUM SHA256 dello script di Power Shell fornito nel campo scriptUri precedente | string |
| validExitCodes | Codici di uscita validi per lo script di PowerShell. [Impostazione predefinita: 0] | int[] |
ImageTemplateShellValidator
| Nome | Descrizione | Valore |
|---|---|---|
| tipo | Tipo di convalida da usare nell'immagine. Ad esempio, "Shell" può essere convalida della shell | 'Shell' (obbligatorio) |
| inline | Matrice di comandi della shell da eseguire | string[] |
| scriptUri | URI dello script della shell da eseguire per la convalida. Può essere un collegamento github, l'URI di Archiviazione di Azure e così via | string |
| sha256Checksum | CHECKSUM SHA256 dello script della shell fornito nel campo scriptUri | string |
ImageTemplateVmProfile
| Nome | Descrizione | Valore |
|---|---|---|
| osDiskSizeGB | Dimensioni del disco del sistema operativo in GB. Omettere o specificare 0 per usare le dimensioni predefinite del disco del sistema operativo di Azure. | INT |
| userAssignedIdentities | Matrice facoltativa di ID risorsa di identità gestite assegnate dall'utente da configurare nella macchina virtuale di compilazione e nella macchina virtuale di convalida. Ciò può includere l'identità del modello di immagine. | string[] |
| vmSize | Dimensioni della macchina virtuale usata per compilare, personalizzare e acquisire immagini. Omettere o specificare una stringa vuota per usare il valore predefinito (Standard_D1_v2 per le immagini Gen1 e Standard_D2ds_v4 per le immagini Gen2). | string |
| vnetConfig | Configurazione facoltativa della rete virtuale da usare per distribuire la macchina virtuale di compilazione e la macchina virtuale di convalida in. Omettere se non deve essere usata alcuna rete virtuale specifica. | VirtualNetworkConfig |
VirtualNetworkConfig
| Nome | Descrizione | Valore |
|---|---|---|
| proxyVmSize | Dimensioni della macchina virtuale proxy usata per passare il traffico alla macchina virtuale di compilazione e convalida. Omettere o specificare una stringa vuota per usare il valore predefinito (Standard_A1_v2). | string |
| subnetId | ID risorsa di una subnet preesistente. | string |
Modelli di avvio rapido
I modelli di avvio rapido seguenti distribuiscono questo tipo di risorsa.
| Modello | Descrizione |
|---|---|
| Generatore di immagini di Azure con baseline di Windows di Azure |
Crea un ambiente Image Builder di Azure e compila un'immagine di Windows Server con la versione più recente di Windows Aggiornamenti e baseline di Windows di Azure applicata. |
| Configurare il servizio Dev Box |
Questo modello creerà tutte le risorse di amministrazione di Dev Box in base alla guida introduttiva di Dev Box. È possibile visualizzare tutte le risorse create o passare direttamente a DevPortal.microsoft.com per creare il primo Dev Box. |
Definizione della risorsa Terraform (provider AzAPI)
Il tipo di risorsa imageTemplates può essere distribuito in:
- Gruppi di risorse
Per un elenco delle proprietà modificate in ogni versione dell'API, vedere Log delle modifiche.
Formato di risorsa
Per creare una risorsa Microsoft.VirtualMachineImages/imageTemplates, aggiungere il codice Terraform seguente al modello.
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"
}
}
}
})
}
Oggetti ImageTemplateCustomizer
Impostare la proprietà type per specificare il tipo di oggetto.
Per File usare:
type = "File"
destination = "string"
sha256Checksum = "string"
sourceUri = "string"
Per PowerShell usare:
type = "PowerShell"
inline = [
"string"
]
runAsSystem = bool
runElevated = bool
scriptUri = "string"
sha256Checksum = "string"
validExitCodes = [
int
]
Per Shell usare:
type = "Shell"
inline = [
"string"
]
scriptUri = "string"
sha256Checksum = "string"
Per WindowsRestart, usare:
type = "WindowsRestart"
restartCheckCommand = "string"
restartCommand = "string"
restartTimeout = "string"
Per WindowsUpdate, usare:
type = "WindowsUpdate"
filters = [
"string"
]
searchCriteria = "string"
updateLimit = int
Oggetti ImageTemplateDistributor
Impostare la proprietà type per specificare il tipo di oggetto.
Per ManagedImage usare:
type = "ManagedImage"
imageId = "string"
location = "string"
Per SharedImage usare:
type = "SharedImage"
excludeFromLatest = bool
galleryImageId = "string"
replicationRegions = [
"string"
]
storageAccountType = "string"
Per il disco rigido virtuale, usare:
type = "VHD"
Oggetti ImageTemplateSource
Impostare la proprietà type per specificare il tipo di oggetto.
Per ManagedImage usare:
type = "ManagedImage"
imageId = "string"
Per PlatformImage usare:
type = "PlatformImage"
offer = "string"
planInfo = {
planName = "string"
planProduct = "string"
planPublisher = "string"
}
publisher = "string"
sku = "string"
version = "string"
Per SharedImageVersion, usare:
type = "SharedImageVersion"
imageVersionId = "string"
Oggetti ImageTemplateInVMValidator
Impostare la proprietà type per specificare il tipo di oggetto.
Per PowerShell usare:
type = "PowerShell"
inline = [
"string"
]
runAsSystem = bool
runElevated = bool
scriptUri = "string"
sha256Checksum = "string"
validExitCodes = [
int
]
Per Shell usare:
type = "Shell"
inline = [
"string"
]
scriptUri = "string"
sha256Checksum = "string"
Valori delle proprietà
imageTemplates
| Nome | Descrizione | Valore |
|---|---|---|
| tipo | Tipo di risorsa | "Microsoft.VirtualMachineImages/imageTemplates@2022-02-14" |
| name | Nome della risorsa | stringa (obbligatorio) |
| posizione | Posizione geografica in cui risiede la risorsa | stringa (obbligatorio) |
| parent_id | Per eseguire la distribuzione in un gruppo di risorse, usare l'ID del gruppo di risorse. | stringa (obbligatorio) |
| tags | Tag delle risorse. | Dizionario di nomi e valori di tag. |
| identity | Identità del modello di immagine, se configurata. | ImageTemplateIdentity (obbligatorio) |
| properties | Proprietà del modello di immagine | ImageTemplateProperties |
ImageTemplateIdentity
| Nome | Descrizione | Valore |
|---|---|---|
| tipo | Tipo di identità usato per il modello di immagine. Il tipo "Nessuno" rimuoverà le identità dal modello di immagine. | "UserAssigned" |
| identity_ids | Elenco di identità utente associate al modello di immagine. I riferimenti alla chiave del dizionario identità utente saranno ID risorsa ARM nel formato :'/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ManagedIdentity/userAssignedIdentities/{identityName}'. | Matrice di ID identità utente. |
ImageTemplateProperties
| Nome | Descrizione | Valore |
|---|---|---|
| buildTimeoutInMinutes | Durata massima di attesa durante la compilazione del modello di immagine (include tutte le personalizzazioni, le convalide e le distribuzioni). Omettere o specificare 0 per usare il valore predefinito (4 ore). | INT |
| personalizzazione | Specifica le proprietà usate per descrivere i passaggi di personalizzazione dell'immagine, ad esempio Origine immagine e così via | ImageTemplateCustomizer[] |
| distribuire | Le destinazioni di distribuzione in cui l'output dell'immagine deve passare. | ImageTemplateDistributor[] (obbligatorio) |
| source | Specifica le proprietà utilizzate per descrivere l'immagine di origine. | ImageTemplateSource (obbligatorio) |
| stagingResourceGroup | ID gruppo di risorse di staging nella stessa sottoscrizione del modello di immagine che verrà usato per compilare l'immagine. Se questo campo è vuoto, verrà creato un gruppo di risorse con un nome casuale. Se il gruppo di risorse specificato in questo campo non esiste, verrà creato con lo stesso nome. Se il gruppo di risorse specificato esiste, deve essere vuoto e nella stessa area del modello di immagine. Il gruppo di risorse creato verrà eliminato durante l'eliminazione del modello se questo campo è vuoto o il gruppo di risorse specificato non esiste, ma se il gruppo di risorse specificato esiste le risorse create nel gruppo di risorse verrà eliminato durante l'eliminazione del modello e il gruppo di risorse stesso rimarrà. | string |
| validate | Opzioni di configurazione e elenco di convalida da eseguire nell'immagine risultante. | ImageTemplatePropertiesValidate |
| vmProfile | Viene descritto come viene configurata la macchina virtuale per compilare immagini | ImageTemplateVmProfile |
ImageTemplateCustomizer
| Nome | Descrizione | valore |
|---|---|---|
| name | Nome descrittivo per fornire il contesto in base al passaggio di personalizzazione | string |
| type | Impostare il tipo di oggetto | File PowerShell Shell WindowsRestart WindowsUpdate (obbligatorio) |
ImageTemplateFileCustomizer
| Nome | Descrizione | Valore |
|---|---|---|
| tipo | Tipo di strumento di personalizzazione che si vuole usare nell'immagine. Ad esempio, "Shell" può essere la personalizzazione della shell | "File" (obbligatorio) |
| destination | Percorso assoluto di un file (con strutture di directory nidificate già create) in cui il file (da sourceUri) verrà caricato nella macchina virtuale | string |
| sha256Checksum | CHECKsum SHA256 del file fornito nel campo sourceUri precedente | string |
| Sourceuri | URI del file da caricare per personalizzare la macchina virtuale. Può essere un collegamento github, un URI di firma di accesso condiviso per Archiviazione di Azure e così via | string |
ImageTemplatePowerShellCustomizer
| Nome | Descrizione | Valore |
|---|---|---|
| tipo | Tipo di strumento di personalizzazione che si vuole usare nell'immagine. Ad esempio, "Shell" può essere la personalizzazione della shell | "PowerShell" (obbligatorio) |
| inline | Matrice di comandi di PowerShell da eseguire | string[] |
| runAsSystem | Se specificato, lo script di PowerShell verrà eseguito con privilegi elevati usando l'utente del sistema locale. Può essere true solo quando il campo runElevated sopra è impostato su true. | bool |
| runElevated | Se specificato, lo script di PowerShell verrà eseguito con privilegi elevati | bool |
| scriptUri | URI dello script di PowerShell da eseguire per la personalizzazione. Può essere un collegamento github, un URI di firma di accesso condiviso per Archiviazione di Azure e così via | string |
| sha256Checksum | CHECKSUM SHA256 dello script di Power Shell fornito nel campo scriptUri precedente | string |
| validExitCodes | Codici di uscita validi per lo script di PowerShell. [Impostazione predefinita: 0] | int[] |
ImageTemplateShellCustomizer
| Nome | Descrizione | Valore |
|---|---|---|
| tipo | Tipo di strumento di personalizzazione che si vuole usare nell'immagine. Ad esempio, "Shell" può essere la personalizzazione della shell | "Shell" (obbligatorio) |
| inline | Matrice di comandi della shell da eseguire | string[] |
| scriptUri | URI dello script della shell da eseguire per la personalizzazione. Può essere un collegamento github, un URI di firma di accesso condiviso per Archiviazione di Azure e così via | string |
| sha256Checksum | CHECKSUM SHA256 dello script della shell fornito nel campo scriptUri | string |
ImageTemplateRestartCustomizer
| Nome | Descrizione | Valore |
|---|---|---|
| tipo | Tipo di strumento di personalizzazione che si vuole usare nell'immagine. Ad esempio, "Shell" può essere la personalizzazione della shell | "WindowsRestart" (obbligatorio) |
| restartCheckCommand | Comando per verificare se il riavvio è riuscito [Impostazione predefinita: ''] | string |
| restartCommand | Comando per eseguire il riavvio [Predefinito: 'shutdown /r /f /t 0 /c "packer restart"'] | string |
| restartTimeout | Timeout del riavvio specificato come stringa di grandezza e unità, ad esempio '5m' (5 minuti) o '2h' (2 ore) [Impostazione predefinita: '5m'] | string |
ImageTemplateWindowsUpdateCustomizer
| Nome | Descrizione | Valore |
|---|---|---|
| tipo | Tipo di strumento di personalizzazione da usare nell'immagine. Ad esempio, "Shell" può essere personalizzatore della shell | "WindowsUpdate" (obbligatorio) |
| filters | Matrice di filtri per selezionare gli aggiornamenti da applicare. Omettere o specificare una matrice vuota per usare il valore predefinito (nessun filtro). Fare riferimento al collegamento precedente per esempi e descrizione dettagliata di questo campo. | string[] |
| searchCriteria | Criteri per la ricerca degli aggiornamenti. Omettere o specificare una stringa vuota per usare il valore predefinito (eseguire ricerche in tutti). Fare riferimento al collegamento precedente per esempi e descrizione dettagliata di questo campo. | string |
| updateLimit | Numero massimo di aggiornamenti da applicare alla volta. Omettere o specificare 0 per usare il valore predefinito (1000) | INT |
ImageTemplateDistributor
| Nome | Descrizione | Valore |
|---|---|---|
| artifactTags | Tag che verranno applicati all'artefatto dopo che è stato creato/aggiornato dal server di distribuzione. | object |
| runOutputName | Nome da utilizzare per l'oggetto RunOutput associato. | stringa (obbligatorio) |
| tipo | Impostare il tipo di oggetto | ManagedImage SharedImage Disco rigido virtuale (obbligatorio) |
ImageTemplateManagedImageDistributor
| Nome | Descrizione | Valore |
|---|---|---|
| tipo | Tipo di distribuzione. | "ManagedImage" (obbligatorio) |
| imageId | ID risorsa dell'immagine del disco gestito | stringa (obbligatorio) |
| posizione | La posizione di Azure per l'immagine deve corrispondere se l'immagine esiste già | stringa (obbligatorio) |
ImageTemplateSharedImageDistributor
| Nome | Descrizione | Valore |
|---|---|---|
| tipo | Tipo di distribuzione. | "SharedImage" (obbligatorio) |
| excludeFromLatest | Flag che indica se la versione dell'immagine creata deve essere esclusa dalla versione più recente. Omettere di usare il valore predefinito (false). | bool |
| galleryImageId | ID risorsa dell'immagine Raccolta immagini condivise | stringa (obbligatorio) |
| replicationRegions | Elenco di aree in cui verrà replicata l'immagine | string[] (obbligatorio) |
| storageAccountType | Tipo di account di archiviazione da usare per archiviare l'immagine condivisa. Omettere di usare il valore predefinito (Standard_LRS). | "Standard_LRS" "Standard_ZRS" |
ImageTemplateVhdDistributor
| Nome | Descrizione | Valore |
|---|---|---|
| tipo | Tipo di distribuzione. | "VHD" (obbligatorio) |
ImageTemplateSource
| Nome | Descrizione | Valore |
|---|---|---|
| tipo | Impostare il tipo di oggetto | ManagedImage PlatformImage SharedImageVersion (obbligatorio) |
ImageTemplateManagedImageSource
| Nome | Descrizione | Valore |
|---|---|---|
| tipo | Specifica il tipo di immagine di origine da cui iniziare. | "ManagedImage" (obbligatorio) |
| imageId | ID risorsa ARM dell'immagine gestita nella sottoscrizione del cliente | stringa (obbligatorio) |
ImageTemplatePlatformImageSource
| Nome | Descrizione | Valore |
|---|---|---|
| tipo | Specifica il tipo di immagine di origine da cui iniziare. | "PlatformImage" (obbligatorio) |
| offer | Offerta di immagine dalle immagini della raccolta di Azure. | string |
| planInfo | Configurazione facoltativa del piano di acquisto per l'immagine della piattaforma. | PlatformImagePurchasePlan |
| publisher | Image Publisher nelle immagini della raccolta di Azure. | string |
| sku | Sku dell'immagine dalle immagini della raccolta di Azure. | string |
| version | Versione dell'immagine dalle immagini della raccolta di Azure. Se in questo caso viene specificato "latest", la versione viene valutata quando viene eseguita la compilazione dell'immagine, non quando viene inviato il modello. | string |
PlatformImagePurchasePlan
| Nome | Descrizione | Valore |
|---|---|---|
| planName | Nome del piano di acquisto. | stringa (obbligatorio) |
| planProduct | Prodotto del piano di acquisto. | stringa (obbligatorio) |
| planPublisher | Autore del piano di acquisto. | stringa (obbligatorio) |
ImageTemplateSharedImageVersionSource
| Nome | Descrizione | Valore |
|---|---|---|
| tipo | Specifica il tipo di immagine di origine da cui iniziare. | "SharedImageVersion" (obbligatorio) |
| imageVersionId | ID risorsa ARM della versione dell'immagine nella raccolta di immagini condivise | stringa (obbligatorio) |
ImageTemplatePropertiesValidate
| Nome | Descrizione | Valore |
|---|---|---|
| continueDistributeOnFailure | Se la convalida non riesce e questo campo è impostato su false, le immagini di output non verranno distribuite. Questo è il comportamento predefinito. Se la convalida ha esito negativo e questo campo è impostato su true, le immagini di output verranno comunque distribuite. Usare questa opzione con cautela perché potrebbe causare la distribuzione di immagini non dannose per l'uso. In entrambi i casi (true o false), l'esecuzione dell'immagine end-to-end verrà segnalata come non riuscita in caso di errore di convalida. [Nota: questo campo non ha effetto se la convalida riesce.] | bool |
| inVMValidations | Elenco delle convalide da eseguire. | ImageTemplateInVMValidator[] |
| sourceValidationOnly | Se questo campo è impostato su true, l'immagine specificata nella sezione 'source' verrà convalidata direttamente. Non verrà eseguita alcuna compilazione separata per generare e quindi convalidare un'immagine personalizzata. | bool |
ImageTemplateInVMValidator
| Nome | Descrizione | valore |
|---|---|---|
| name | Nome descrittivo per fornire contesto sulle operazioni eseguite da questo passaggio di convalida | string |
| type | Impostare il tipo di oggetto | PowerShell Shell (obbligatorio) |
ImageTemplatePowerShellValidator
| Nome | Descrizione | Valore |
|---|---|---|
| tipo | Tipo di convalida da usare nell'immagine. Ad esempio, "Shell" può essere convalida della shell | "PowerShell" (obbligatorio) |
| inline | Matrice di comandi di PowerShell da eseguire | string[] |
| runAsSystem | Se specificato, lo script di PowerShell verrà eseguito con privilegi elevati usando l'utente del sistema locale. Può essere true solo quando il campo runElevated precedente è impostato su true. | bool |
| runElevated | Se specificato, lo script di PowerShell verrà eseguito con privilegi elevati | bool |
| scriptUri | URI dello script di PowerShell da eseguire per la convalida. Può trattarsi di un collegamento github, un URI di Archiviazione di Azure e così via | string |
| sha256Checksum | CHECKSUM SHA256 dello script power shell fornito nel campo scriptUri precedente | string |
| validExitCodes | Codici di uscita validi per lo script di PowerShell. [Impostazione predefinita: 0] | int[] |
ImageTemplateShellValidator
| Nome | Descrizione | Valore |
|---|---|---|
| tipo | Tipo di convalida da usare nell'immagine. Ad esempio, "Shell" può essere convalida della shell | "Shell" (obbligatorio) |
| inline | Matrice di comandi della shell da eseguire | string[] |
| scriptUri | URI dello script della shell da eseguire per la convalida. Può trattarsi di un collegamento github, un URI di Archiviazione di Azure e così via | string |
| sha256Checksum | CHECKSUM SHA256 dello script della shell fornito nel campo scriptUri | string |
ImageTemplateVmProfile
| Nome | Descrizione | Valore |
|---|---|---|
| osDiskSizeGB | Dimensioni del disco del sistema operativo in GB. Omettere o specificare 0 per usare le dimensioni predefinite del disco del sistema operativo di Azure. | INT |
| userAssignedIdentities | Matrice facoltativa di ID risorsa di identità gestite assegnate dall'utente da configurare nella macchina virtuale di compilazione e nella macchina virtuale di convalida. Ciò può includere l'identità del modello di immagine. | string[] |
| vmSize | Dimensioni della macchina virtuale usata per compilare, personalizzare e acquisire immagini. Omettere o specificare una stringa vuota per usare il valore predefinito (Standard_D1_v2 per le immagini Gen1 e Standard_D2ds_v4 per le immagini Gen2). | string |
| vnetConfig | Configurazione facoltativa della rete virtuale da usare per distribuire la macchina virtuale di compilazione e la vm di convalida in . Omettere se non è necessario usare alcuna rete virtuale specifica. | VirtualNetworkConfig |
VirtualNetworkConfig
| Nome | Descrizione | Valore |
|---|---|---|
| proxyVmSize | Dimensioni della macchina virtuale proxy usata per passare il traffico alla macchina virtuale di compilazione e convalida. Omettere o specificare una stringa vuota per usare il valore predefinito (Standard_A1_v2). | string |
| subnetId | ID risorsa di una subnet preesistente. | string |
Commenti e suggerimenti
Presto disponibile: Nel corso del 2024 verranno gradualmente disattivati i problemi di GitHub come meccanismo di feedback per il contenuto e ciò verrà sostituito con un nuovo sistema di feedback. Per altre informazioni, vedere https://aka.ms/ContentUserFeedback.
Invia e visualizza il feedback per