Microsoft.VirtualMachineImages imageTemplates 2019-05-01-preview
Definição de recurso do Bicep
O tipo de recurso imageTemplates pode ser implementado em:
- Grupos de recursos – veja os comandos de implementação do grupo de recursos
Para obter uma lista das propriedades alteradas em cada versão da API, veja Registo de alterações.
Formato do recurso
Para criar um recurso Microsoft.VirtualMachineImages/imageTemplates, adicione o seguinte Bicep ao seu modelo.
resource symbolicname 'Microsoft.VirtualMachineImages/imageTemplates@2019-05-01-preview' = {
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
}
vmProfile: {
vmSize: 'string'
}
}
}
Objetos ImageTemplateCustomizer
Defina a propriedade type para especificar o tipo de objeto.
Para Ficheiro, utilize:
type: 'File'
destination: 'string'
sha256Checksum: 'string'
sourceUri: 'string'
Para o PowerShell, utilize:
type: 'PowerShell'
inline: [
'string'
]
runElevated: bool
scriptUri: 'string'
sha256Checksum: 'string'
validExitCodes: [
int
]
Para Shell, utilize:
type: 'Shell'
inline: [
'string'
]
scriptUri: 'string'
sha256Checksum: 'string'
Para WindowsRestart, utilize:
type: 'WindowsRestart'
restartCheckCommand: 'string'
restartCommand: 'string'
restartTimeout: 'string'
Objetos ImageTemplateDistributor
Defina a propriedade type para especificar o tipo de objeto.
Para ManagedImage, utilize:
type: 'ManagedImage'
imageId: 'string'
location: 'string'
Para SharedImage, utilize:
type: 'SharedImage'
galleryImageId: 'string'
replicationRegions: [
'string'
]
Para VHD, utilize:
type: 'VHD'
Objetos ImageTemplateSource
Defina a propriedade type para especificar o tipo de objeto.
Para ISO, utilize:
type: 'ISO'
sha256Checksum: 'string'
sourceUri: 'string'
Para ManagedImage, utilize:
type: 'ManagedImage'
imageId: 'string'
Para PlatformImage, utilize:
type: 'PlatformImage'
offer: 'string'
publisher: 'string'
sku: 'string'
version: 'string'
Para SharedImageVersion, utilize:
type: 'SharedImageVersion'
imageVersionId: 'string'
Valores de propriedade
imageTemplates
| Nome | Descrição | Valor |
|---|---|---|
| name | O nome do recurso | cadeia (obrigatório) |
| localização | Localização do recurso | cadeia (obrigatório) |
| etiquetas | Etiquetas de recursos | Dicionário de nomes e valores de etiquetas. Ver Etiquetas em modelos |
| identidade | A identidade do modelo de imagem, se configurado. | ImageTemplateIdentity |
| propriedades | As propriedades do modelo de imagem | ImageTemplateProperties |
ImageTemplateIdentity
| Nome | Descrição | Valor |
|---|---|---|
| tipo | O tipo de identidade utilizado para o modelo de imagem. O tipo "Nenhum" removerá todas as identidades do modelo de imagem. | "Nenhum" "UserAssigned" |
| userAssignedIdentities | A lista de identidades de utilizador associadas ao modelo de imagem. As referências da chave do dicionário de identidade do utilizador serão IDs de recursos do ARM no formulário: "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ManagedIdentity/userAssignedIdentities/{identityName}". | objeto |
ImageTemplateProperties
| Nome | Descrição | Valor |
|---|---|---|
| buildTimeoutInMinutes | Duração máxima a aguardar durante a criação do modelo de imagem. Omita ou especifique 0 para utilizar a predefinição (4 horas). | int |
| personalizar | Especifica as propriedades utilizadas para descrever os passos de personalização da imagem, como a Origem da imagem, etc. | ImageTemplateCustomizer[] |
| distribuir | A distribuição destina-se ao local para onde a saída da imagem tem de ir. | ImageTemplateDistributor[] (obrigatório) |
| source | Especifica as propriedades utilizadas para descrever a imagem de origem. | ImageTemplateSource (obrigatório) |
| vmProfile | Descreve como a máquina virtual está configurada para criar imagens | ImageTemplateVmProfile |
ImageTemplateCustomizer
| Nome | Descrição | Valor |
|---|---|---|
| name | Nome Amigável para fornecer contexto sobre o que faz este passo de personalização | string |
| tipo | Definir o tipo de objeto | Ficheiro PowerShell Shell WindowsRestart (obrigatório) |
ImageTemplateFileCustomizer
| Nome | Descrição | Valor |
|---|---|---|
| tipo | O tipo de ferramenta de personalização que pretende utilizar na Imagem. Por exemplo, "Shell" pode ser personalizador de shell | "Ficheiro" (obrigatório) |
| destino | O caminho absoluto para um ficheiro (com estruturas de diretório aninhadas já criadas) para o qual o ficheiro (de sourceUri) será carregado na VM | string |
| sha256Checksum | Soma de verificação SHA256 do ficheiro fornecido no campo sourceUri acima | string |
| sourceUri | O URI do ficheiro a carregar para personalizar a VM. Pode ser uma ligação do github, URI de SAS para o Armazenamento do Azure, etc. | string |
ImageTemplatePowerShellCustomizer
| Nome | Descrição | Valor |
|---|---|---|
| tipo | O tipo de ferramenta de personalização que pretende utilizar na Imagem. Por exemplo, "Shell" pode ser personalizador de shell | "PowerShell" (obrigatório) |
| inline | Matriz de comandos do PowerShell a executar | cadeia[] |
| runElevated | Se especificado, o script do PowerShell será executado com privilégios elevados | bool |
| scriptUri | URI do script do PowerShell a ser executado para personalização. Pode ser uma ligação do github, URI de SAS para o Armazenamento do Azure, etc. | string |
| sha256Checksum | Soma de verificação SHA256 do script do power shell fornecido no campo scriptUri acima | string |
| validExitCodes | Códigos de saída válidos para o script do PowerShell. [Predefinição: 0] | int[] |
ImageTemplateShellCustomizer
| Nome | Descrição | Valor |
|---|---|---|
| tipo | O tipo de ferramenta de personalização que pretende utilizar na Imagem. Por exemplo, "Shell" pode ser personalizador de shell | "Shell" (obrigatório) |
| inline | Matriz de comandos da shell a executar | cadeia[] |
| scriptUri | URI do script da shell a ser executado para personalização. Pode ser uma ligação do github, URI de SAS para o Armazenamento do Azure, etc. | string |
| sha256Checksum | Soma de verificação SHA256 do script de shell fornecido no campo scriptUri | string |
ImageTemplateRestartCustomizer
| Nome | Descrição | Valor |
|---|---|---|
| tipo | O tipo de ferramenta de personalização que pretende utilizar na Imagem. Por exemplo, "Shell" pode ser personalizador de shell | "WindowsRestart" (obrigatório) |
| restartCheckCommand | Comando para verificar se o reinício foi bem-sucedido [Predefinição: ''] | string |
| reiniciarComando | Comando para executar o reinício [Predefinição: 'shutdown /r /f /t 0 /c "packer restart"'] | string |
| restartTimeout | Tempo limite de reinício especificado como uma cadeia de magnitude e unidade, por exemplo, "5 m" (5 minutos) ou "2h" (2 horas) [Predefinição: '5m'] | string |
ImageTemplateDistributor
| Nome | Descrição | Valor |
|---|---|---|
| artifactTags | Etiquetas que serão aplicadas ao artefacto depois de serem criadas/atualizadas pelo distribuidor. | objeto |
| runOutputName | O nome a utilizar para o RunOutput associado. | cadeia (obrigatório) |
| tipo | Definir o tipo de objeto | ManagedImage SharedImage VHD (obrigatório) |
ImageTemplateManagedImageDistributor
| Nome | Descrição | Valor |
|---|---|---|
| tipo | Tipo de distribuição. | "ManagedImage" (obrigatório) |
| imageId | ID do Recurso da Imagem de Disco Gerido | cadeia (obrigatório) |
| localização | A localização do Azure para a imagem deve corresponder se a imagem já existir | cadeia (obrigatório) |
ImageTemplateSharedImageDistributor
| Nome | Descrição | Valor |
|---|---|---|
| tipo | Tipo de distribuição. | "SharedImage" (obrigatório) |
| galleryImageId | ID de recurso da imagem de Shared Image Gallery | cadeia (obrigatório) |
| replicationRegions | Uma lista de regiões para as quais a imagem será replicada | string[] (obrigatório) |
ImageTemplateVhdDistributor
| Nome | Descrição | Valor |
|---|---|---|
| tipo | Tipo de distribuição. | "VHD" (obrigatório) |
ImageTemplateSource
| Nome | Descrição | Valor |
|---|---|---|
| tipo | Definir o tipo de objeto | ISO ManagedImage PlatformImage SharedImageVersion (obrigatório) |
ImageTemplateIsoSource
| Nome | Descrição | Valor |
|---|---|---|
| tipo | Especifica o tipo de imagem de origem com que pretende começar. | "ISO" (obrigatório) |
| sha256Checksum | SHA256 Soma de Verificação da imagem ISO. | cadeia (obrigatório) |
| sourceUri | URI para obter a imagem ISO. Este URI tem de estar acessível ao fornecedor de recursos no momento da criação do modelo de imagem. | cadeia (obrigatório) |
ImageTemplateManagedImageSource
| Nome | Descrição | Valor |
|---|---|---|
| tipo | Especifica o tipo de imagem de origem com que pretende começar. | "ManagedImage" (obrigatório) |
| imageId | ID de recurso do ARM da imagem gerida na subscrição do cliente | cadeia (obrigatório) |
ImageTemplatePlatformImageSource
| Nome | Descrição | Valor |
|---|---|---|
| tipo | Especifica o tipo de imagem de origem com que pretende começar. | "PlatformImage" (obrigatório) |
| oferta | Oferta de imagem a partir das Imagens da Galeria do Azure. | string |
| publicador | Image Publisher in Azure Gallery Images (Imagens da Galeria do Azure). | string |
| sku | SKU da imagem a partir das Imagens da Galeria do Azure. | string |
| versão | Versão da imagem das Imagens da Galeria do Azure. | string |
ImageTemplateSharedImageVersionSource
| Nome | Descrição | Valor |
|---|---|---|
| tipo | Especifica o tipo de imagem de origem com que pretende começar. | "SharedImageVersion" (obrigatório) |
| imageVersionId | ID de recurso do ARM da versão da imagem na galeria de imagens partilhadas | cadeia (obrigatório) |
ImageTemplateVmProfile
| Nome | Descrição | Valor |
|---|---|---|
| vmSize | Tamanho da máquina virtual utilizada para criar, personalizar e capturar imagens. Omita ou especifique a cadeia vazia para utilizar a predefinição (Standard_D1_v2). | string |
Modelos de início rápido
Os seguintes modelos de início rápido implementam este tipo de recurso.
| Modelo | Description |
|---|---|
Azure Image Builder with Azure Windows Baseline |
Cria um ambiente do Azure Image Builder e cria uma imagem do Windows Server com o Atualizações mais recente do Windows e a Linha de Base do Windows do Azure aplicadas. |
| Configurar o serviço Dev Box |
Este modelo criaria todos os recursos de administrador do Dev Box de acordo com o Guia de introdução do Dev Box. Pode ver todos os recursos criados ou aceder diretamente a DevPortal.microsoft.com para criar o seu primeiro Dev Box. |
Definição de recurso do modelo arm
O tipo de recurso imageTemplates pode ser implementado em:
- Grupos de recursos – veja os comandos de implementação do grupo de recursos
Para obter uma lista das propriedades alteradas em cada versão da API, veja Registo de alterações.
Formato do recurso
Para criar um recurso Microsoft.VirtualMachineImages/imageTemplates, adicione o seguinte JSON ao seu modelo.
{
"type": "Microsoft.VirtualMachineImages/imageTemplates",
"apiVersion": "2019-05-01-preview",
"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
},
"vmProfile": {
"vmSize": "string"
}
}
}
Objetos ImageTemplateCustomizer
Defina a propriedade type para especificar o tipo de objeto.
Para Ficheiro, utilize:
"type": "File",
"destination": "string",
"sha256Checksum": "string",
"sourceUri": "string"
Para o PowerShell, utilize:
"type": "PowerShell",
"inline": [ "string" ],
"runElevated": "bool",
"scriptUri": "string",
"sha256Checksum": "string",
"validExitCodes": [ "int" ]
Para Shell, utilize:
"type": "Shell",
"inline": [ "string" ],
"scriptUri": "string",
"sha256Checksum": "string"
Para WindowsRestart, utilize:
"type": "WindowsRestart",
"restartCheckCommand": "string",
"restartCommand": "string",
"restartTimeout": "string"
Objetos ImageTemplateDistributor
Defina a propriedade type para especificar o tipo de objeto.
Para ManagedImage, utilize:
"type": "ManagedImage",
"imageId": "string",
"location": "string"
Para SharedImage, utilize:
"type": "SharedImage",
"galleryImageId": "string",
"replicationRegions": [ "string" ]
Para VHD, utilize:
"type": "VHD"
Objetos ImageTemplateSource
Defina a propriedade type para especificar o tipo de objeto.
Para ISO, utilize:
"type": "ISO",
"sha256Checksum": "string",
"sourceUri": "string"
Para ManagedImage, utilize:
"type": "ManagedImage",
"imageId": "string"
Para PlatformImage, utilize:
"type": "PlatformImage",
"offer": "string",
"publisher": "string",
"sku": "string",
"version": "string"
Para SharedImageVersion, utilize:
"type": "SharedImageVersion",
"imageVersionId": "string"
Valores de propriedade
imageTemplates
| Nome | Descrição | Valor |
|---|---|---|
| tipo | O tipo de recurso | "Microsoft.VirtualMachineImages/imageTemplates" |
| apiVersion | A versão da API de recursos | '2019-05-01-preview' |
| name | O nome do recurso | cadeia (obrigatório) |
| localização | Localização do recurso | cadeia (obrigatório) |
| etiquetas | Etiquetas de recursos | Dicionário de nomes e valores de etiquetas. Ver Etiquetas em modelos |
| identidade | A identidade do modelo de imagem, se configurado. | ImageTemplateIdentity |
| propriedades | As propriedades do modelo de imagem | ImageTemplateProperties |
ImageTemplateIdentity
| Nome | Descrição | Valor |
|---|---|---|
| tipo | O tipo de identidade utilizado para o modelo de imagem. O tipo "Nenhum" removerá todas as identidades do modelo de imagem. | "Nenhum" "UserAssigned" |
| userAssignedIdentities | A lista de identidades de utilizador associadas ao modelo de imagem. As referências da chave do dicionário de identidade do utilizador serão IDs de recursos do ARM no formulário: "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ManagedIdentity/userAssignedIdentities/{identityName}". | objeto |
ImageTemplateProperties
| Nome | Descrição | Valor |
|---|---|---|
| buildTimeoutInMinutes | Duração máxima a aguardar durante a criação do modelo de imagem. Omita ou especifique 0 para utilizar a predefinição (4 horas). | int |
| personalizar | Especifica as propriedades utilizadas para descrever os passos de personalização da imagem, como a Origem da imagem, etc. | ImageTemplateCustomizer[] |
| distribuir | A distribuição destina-se ao local para onde a saída da imagem tem de ir. | ImageTemplateDistributor[] (obrigatório) |
| source | Especifica as propriedades utilizadas para descrever a imagem de origem. | ImageTemplateSource (obrigatório) |
| vmProfile | Descreve como a máquina virtual está configurada para criar imagens | ImageTemplateVmProfile |
ImageTemplateCustomizer
| Nome | Descrição | Valor |
|---|---|---|
| name | Nome Amigável para fornecer contexto sobre o que faz este passo de personalização | string |
| tipo | Definir o tipo de objeto | Ficheiro PowerShell Shell WindowsRestart (obrigatório) |
ImageTemplateFileCustomizer
| Nome | Descrição | Valor |
|---|---|---|
| tipo | O tipo de ferramenta de personalização que pretende utilizar na Imagem. Por exemplo, "Shell" pode ser personalizador de shell | "Ficheiro" (obrigatório) |
| destino | O caminho absoluto para um ficheiro (com estruturas de diretório aninhadas já criadas) para o qual o ficheiro (de sourceUri) será carregado na VM | string |
| sha256Checksum | Soma de verificação SHA256 do ficheiro fornecido no campo sourceUri acima | string |
| sourceUri | O URI do ficheiro a carregar para personalizar a VM. Pode ser uma ligação do github, URI de SAS para o Armazenamento do Azure, etc. | string |
ImageTemplatePowerShellCustomizer
| Nome | Descrição | Valor |
|---|---|---|
| tipo | O tipo de ferramenta de personalização que pretende utilizar na Imagem. Por exemplo, "Shell" pode ser personalizador de shell | "PowerShell" (obrigatório) |
| inline | Matriz de comandos do PowerShell a executar | cadeia[] |
| runElevated | Se especificado, o script do PowerShell será executado com privilégios elevados | bool |
| scriptUri | URI do script do PowerShell a ser executado para personalização. Pode ser uma ligação do github, URI de SAS para o Armazenamento do Azure, etc. | string |
| sha256Checksum | Soma de verificação SHA256 do script do power shell fornecido no campo scriptUri acima | string |
| validExitCodes | Códigos de saída válidos para o script do PowerShell. [Predefinição: 0] | int[] |
ImageTemplateShellCustomizer
| Nome | Descrição | Valor |
|---|---|---|
| tipo | O tipo de ferramenta de personalização que pretende utilizar na Imagem. Por exemplo, "Shell" pode ser personalizador de shell | "Shell" (obrigatório) |
| inline | Matriz de comandos da shell a executar | cadeia[] |
| scriptUri | URI do script da shell a ser executado para personalização. Pode ser uma ligação do github, URI de SAS para o Armazenamento do Azure, etc. | string |
| sha256Checksum | Soma de verificação SHA256 do script de shell fornecido no campo scriptUri | string |
ImageTemplateRestartCustomizer
| Nome | Descrição | Valor |
|---|---|---|
| tipo | O tipo de ferramenta de personalização que pretende utilizar na Imagem. Por exemplo, "Shell" pode ser personalizador de shell | "WindowsRestart" (obrigatório) |
| restartCheckCommand | Comando para verificar se o reinício foi bem-sucedido [Predefinição: ''] | string |
| reiniciarComando | Comando para executar o reinício [Predefinição: 'shutdown /r /f /t 0 /c "packer restart"'] | string |
| restartTimeout | Tempo limite de reinício especificado como uma cadeia de magnitude e unidade, por exemplo, "5 m" (5 minutos) ou "2h" (2 horas) [Predefinição: '5m'] | string |
ImageTemplateDistributor
| Nome | Descrição | Valor |
|---|---|---|
| artifactTags | Etiquetas que serão aplicadas ao artefacto depois de serem criadas/atualizadas pelo distribuidor. | objeto |
| runOutputName | O nome a utilizar para o RunOutput associado. | cadeia (obrigatório) |
| tipo | Definir o tipo de objeto | ManagedImage SharedImage VHD (obrigatório) |
ImageTemplateManagedImageDistributor
| Nome | Descrição | Valor |
|---|---|---|
| tipo | Tipo de distribuição. | "ManagedImage" (obrigatório) |
| imageId | ID do Recurso da Imagem do Disco Gerido | cadeia (obrigatório) |
| localização | A localização do Azure para a imagem deve corresponder se a imagem já existir | cadeia (obrigatório) |
ImageTemplateSharedImageDistributor
| Nome | Descrição | Valor |
|---|---|---|
| tipo | Tipo de distribuição. | "SharedImage" (obrigatório) |
| galleryImageId | ID do recurso da imagem de Shared Image Gallery | cadeia (obrigatório) |
| replicationRegions | Uma lista de regiões para as quais a imagem será replicada | string[] (obrigatório) |
ImageTemplateVhdDistributor
| Nome | Descrição | Valor |
|---|---|---|
| tipo | Tipo de distribuição. | "VHD" (obrigatório) |
ImageTemplateSource
| Nome | Descrição | Valor |
|---|---|---|
| tipo | Definir o tipo de objeto | ISO ManagedImage PlatformImage SharedImageVersion (obrigatório) |
ImageTemplateIsoSource
| Nome | Descrição | Valor |
|---|---|---|
| tipo | Especifica o tipo de imagem de origem com que pretende começar. | "ISO" (obrigatório) |
| sha256Checksum | SHA256 Soma de verificação da imagem ISO. | cadeia (obrigatório) |
| sourceUri | URI para obter a imagem ISO. Este URI tem de estar acessível ao fornecedor de recursos no momento da criação do modelo de imagem. | cadeia (obrigatório) |
ImageTemplateManagedImageSource
| Nome | Descrição | Valor |
|---|---|---|
| tipo | Especifica o tipo de imagem de origem com que pretende começar. | "ManagedImage" (obrigatório) |
| imageId | ID do recurso arm da imagem gerida na subscrição do cliente | cadeia (obrigatório) |
ImageTemplatePlatformImageSource
| Nome | Descrição | Valor |
|---|---|---|
| tipo | Especifica o tipo de imagem de origem com que pretende começar. | "PlatformImage" (obrigatório) |
| oferta | Oferta de imagem a partir das Imagens da Galeria do Azure. | string |
| publicador | Image Publisher in Azure Gallery Images (Imagens da Galeria do Azure). | string |
| sku | SKU de imagem das Imagens da Galeria do Azure. | string |
| versão | Versão da imagem das Imagens da Galeria do Azure. | string |
ImageTemplateSharedImageVersionSource
| Nome | Descrição | Valor |
|---|---|---|
| tipo | Especifica o tipo de imagem de origem com que pretende começar. | "SharedImageVersion" (obrigatório) |
| imageVersionId | ID do recurso arm da versão da imagem na galeria de imagens partilhadas | cadeia (obrigatório) |
ImageTemplateVmProfile
| Nome | Descrição | Valor |
|---|---|---|
| vmSize | Tamanho da máquina virtual utilizada para criar, personalizar e capturar imagens. Omita ou especifique a cadeia vazia para utilizar a predefinição (Standard_D1_v2). | string |
Modelos de início rápido
Os seguintes modelos de início rápido implementam este tipo de recurso.
| Modelo | Description |
|---|---|
| Azure Image Builder with Azure Windows Baseline |
Cria um ambiente do Azure Image Builder e cria uma imagem do Windows Server com o Atualizações mais recente do Windows e a Linha de Base do Windows do Azure aplicadas. |
| Configurar o serviço Dev Box |
Este modelo criaria todos os recursos de administrador do Dev Box de acordo com o Guia de introdução do Dev Box. Pode ver todos os recursos criados ou aceder diretamente a DevPortal.microsoft.com para criar o seu primeiro Dev Box. |
Definição de recurso terraform (fornecedor AzAPI)
O tipo de recurso imageTemplates pode ser implementado em:
- Grupos de recursos
Para obter uma lista das propriedades alteradas em cada versão da API, veja Registo de alterações.
Formato do recurso
Para criar um recurso Microsoft.VirtualMachineImages/imageTemplates, adicione o seguinte Terraform ao seu modelo.
resource "azapi_resource" "symbolicname" {
type = "Microsoft.VirtualMachineImages/imageTemplates@2019-05-01-preview"
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
}
vmProfile = {
vmSize = "string"
}
}
})
}
Objetos ImageTemplateCustomizer
Defina a propriedade type para especificar o tipo de objeto.
Para Ficheiro, utilize:
type = "File"
destination = "string"
sha256Checksum = "string"
sourceUri = "string"
Para o PowerShell, utilize:
type = "PowerShell"
inline = [
"string"
]
runElevated = bool
scriptUri = "string"
sha256Checksum = "string"
validExitCodes = [
int
]
Para Shell, utilize:
type = "Shell"
inline = [
"string"
]
scriptUri = "string"
sha256Checksum = "string"
Para WindowsRestart, utilize:
type = "WindowsRestart"
restartCheckCommand = "string"
restartCommand = "string"
restartTimeout = "string"
Objetos ImageTemplateDistributor
Defina a propriedade type para especificar o tipo de objeto.
Para ManagedImage, utilize:
type = "ManagedImage"
imageId = "string"
location = "string"
Para SharedImage, utilize:
type = "SharedImage"
galleryImageId = "string"
replicationRegions = [
"string"
]
Para VHD, utilize:
type = "VHD"
Objetos ImageTemplateSource
Defina a propriedade type para especificar o tipo de objeto.
Para ISO, utilize:
type = "ISO"
sha256Checksum = "string"
sourceUri = "string"
Para ManagedImage, utilize:
type = "ManagedImage"
imageId = "string"
Para PlatformImage, utilize:
type = "PlatformImage"
offer = "string"
publisher = "string"
sku = "string"
version = "string"
Para SharedImageVersion, utilize:
type = "SharedImageVersion"
imageVersionId = "string"
Valores de propriedade
imageTemplates
| Nome | Descrição | Valor |
|---|---|---|
| tipo | O tipo de recurso | "Microsoft.VirtualMachineImages/imageTemplates@2019-05-01-preview" |
| name | O nome do recurso | cadeia (obrigatório) |
| localização | Localização do recurso | cadeia (obrigatório) |
| parent_id | Para implementar num grupo de recursos, utilize o ID desse grupo de recursos. | cadeia (obrigatório) |
| etiquetas | Etiquetas de recursos | Dicionário de nomes e valores de etiquetas. |
| identidade | A identidade do modelo de imagem, se configurado. | ImageTemplateIdentity |
| propriedades | As propriedades do modelo de imagem | ImageTemplateProperties |
ImageTemplateIdentity
| Nome | Descrição | Valor |
|---|---|---|
| tipo | O tipo de identidade utilizado para o modelo de imagem. O tipo "Nenhum" removerá todas as identidades do modelo de imagem. | "UserAssigned" |
| identity_ids | A lista de identidades de utilizador associadas ao modelo de imagem. As referências da chave do dicionário de identidade do utilizador serão IDs de recursos do ARM no formulário: "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ManagedIdentity/userAssignedIdentities/{identityName}". | Matriz de IDs de identidade do utilizador. |
ImageTemplateProperties
| Nome | Descrição | Valor |
|---|---|---|
| buildTimeoutInMinutes | Duração máxima a aguardar durante a criação do modelo de imagem. Omita ou especifique 0 para utilizar a predefinição (4 horas). | int |
| personalizar | Especifica as propriedades utilizadas para descrever os passos de personalização da imagem, como a Origem da imagem, etc. | ImageTemplateCustomizer[] |
| distribuir | A distribuição destina-se ao local para onde a saída da imagem tem de ir. | ImageTemplateDistributor[] (obrigatório) |
| source | Especifica as propriedades utilizadas para descrever a imagem de origem. | ImageTemplateSource (obrigatório) |
| vmProfile | Descreve como a máquina virtual está configurada para criar imagens | ImageTemplateVmProfile |
ImageTemplateCustomizer
| Nome | Descrição | Valor |
|---|---|---|
| name | Nome Amigável para fornecer contexto sobre o que faz este passo de personalização | string |
| tipo | Definir o tipo de objeto | Ficheiro PowerShell Shell WindowsRestart (obrigatório) |
ImageTemplateFileCustomizer
| Nome | Descrição | Valor |
|---|---|---|
| tipo | O tipo de ferramenta de personalização que pretende utilizar na Imagem. Por exemplo, "Shell" pode ser personalizador de shell | "Ficheiro" (obrigatório) |
| destino | O caminho absoluto para um ficheiro (com estruturas de diretório aninhadas já criadas) para o qual o ficheiro (de sourceUri) será carregado na VM | string |
| sha256Checksum | Soma de verificação SHA256 do ficheiro fornecido no campo sourceUri acima | string |
| sourceUri | O URI do ficheiro a carregar para personalizar a VM. Pode ser uma ligação do github, um URI de SAS para o Armazenamento do Azure, etc. | string |
ImageTemplatePowerShellCustomizer
| Nome | Descrição | Valor |
|---|---|---|
| tipo | O tipo de ferramenta de personalização que pretende utilizar na Imagem. Por exemplo, "Shell" pode ser personalizador de shell | "PowerShell" (obrigatório) |
| inline | Matriz de comandos do PowerShell a executar | string[] |
| runElevated | Se for especificado, o script do PowerShell será executado com privilégios elevados | bool |
| scriptUri | URI do script do PowerShell a ser executado para personalização. Pode ser uma ligação do github, um URI de SAS para o Armazenamento do Azure, etc. | string |
| sha256Checksum | Soma de verificação SHA256 do script do Power Shell fornecido no campo scriptUri acima | string |
| validExitCodes | Códigos de saída válidos para o script do PowerShell. [Predefinição: 0] | int[] |
ImageTemplateShellCustomizer
| Nome | Descrição | Valor |
|---|---|---|
| tipo | O tipo de ferramenta de personalização que pretende utilizar na Imagem. Por exemplo, "Shell" pode ser personalizador de shell | "Shell" (obrigatório) |
| inline | Matriz de comandos da shell a executar | string[] |
| scriptUri | URI do script da shell a ser executado para personalização. Pode ser uma ligação do github, um URI de SAS para o Armazenamento do Azure, etc. | string |
| sha256Checksum | Soma de verificação SHA256 do script de shell fornecido no campo scriptUri | string |
ImageTemplateRestartCustomizer
| Nome | Descrição | Valor |
|---|---|---|
| tipo | O tipo de ferramenta de personalização que pretende utilizar na Imagem. Por exemplo, "Shell" pode ser personalizador de shell | "WindowsRestart" (obrigatório) |
| restartCheckCommand | Comando para verificar se o reinício foi reiniciado com êxito [Predefinição: ''] | string |
| reiniciarComando | Comando para executar o reinício [Predefinição: 'shutdown /r /f /t 0 /c "packer restart"'] | string |
| restartTimeout | Tempo limite de reinício especificado como uma cadeia de magnitude e unidade, por exemplo, "5 m" (5 minutos) ou "2h" (2 horas) [Predefinição: '5m'] | string |
ImageTemplateDistributor
| Nome | Descrição | Valor |
|---|---|---|
| artifactTags | Etiquetas que serão aplicadas ao artefacto depois de serem criadas/atualizadas pelo distribuidor. | objeto |
| runOutputName | O nome a utilizar para o RunOutput associado. | cadeia (obrigatório) |
| tipo | Definir o tipo de objeto | ManagedImage SharedImage VHD (obrigatório) |
ImageTemplateManagedImageDistributor
| Nome | Descrição | Valor |
|---|---|---|
| tipo | Tipo de distribuição. | "ManagedImage" (obrigatório) |
| imageId | ID do Recurso da Imagem do Disco Gerido | cadeia (obrigatório) |
| localização | A localização do Azure para a imagem deve corresponder se a imagem já existir | cadeia (obrigatório) |
ImageTemplateSharedImageDistributor
| Nome | Descrição | Valor |
|---|---|---|
| tipo | Tipo de distribuição. | "SharedImage" (obrigatório) |
| galleryImageId | ID do recurso da imagem de Shared Image Gallery | cadeia (obrigatório) |
| replicationRegions | Uma lista de regiões para as quais a imagem será replicada | string[] (obrigatório) |
ImageTemplateVhdDistributor
| Nome | Descrição | Valor |
|---|---|---|
| tipo | Tipo de distribuição. | "VHD" (obrigatório) |
ImageTemplateSource
| Nome | Descrição | Valor |
|---|---|---|
| tipo | Definir o tipo de objeto | ISO ManagedImage PlatformImage SharedImageVersion (obrigatório) |
ImageTemplateIsoSource
| Nome | Descrição | Valor |
|---|---|---|
| tipo | Especifica o tipo de imagem de origem com que pretende começar. | "ISO" (obrigatório) |
| sha256Checksum | SHA256 Soma de verificação da imagem ISO. | cadeia (obrigatório) |
| sourceUri | URI para obter a imagem ISO. Este URI tem de estar acessível ao fornecedor de recursos no momento da criação do modelo de imagem. | cadeia (obrigatório) |
ImageTemplateManagedImageSource
| Nome | Descrição | Valor |
|---|---|---|
| tipo | Especifica o tipo de imagem de origem com que pretende começar. | "ManagedImage" (obrigatório) |
| imageId | ID do recurso arm da imagem gerida na subscrição do cliente | cadeia (obrigatório) |
ImageTemplatePlatformImageSource
| Nome | Descrição | Valor |
|---|---|---|
| tipo | Especifica o tipo de imagem de origem com que pretende começar. | "PlatformImage" (obrigatório) |
| oferta | Oferta de imagem a partir das Imagens da Galeria do Azure. | string |
| publicador | Image Publisher in Azure Gallery Images (Imagens da Galeria do Azure). | string |
| sku | SKU de imagem das Imagens da Galeria do Azure. | string |
| versão | Versão da imagem das Imagens da Galeria do Azure. | string |
ImageTemplateSharedImageVersionSource
| Nome | Descrição | Valor |
|---|---|---|
| tipo | Especifica o tipo de imagem de origem com que pretende começar. | "SharedImageVersion" (obrigatório) |
| imageVersionId | ID do recurso arm da versão da imagem na galeria de imagens partilhadas | cadeia (obrigatório) |
ImageTemplateVmProfile
| Nome | Descrição | Valor |
|---|---|---|
| vmSize | Tamanho da máquina virtual utilizada para criar, personalizar e capturar imagens. Omita ou especifique a cadeia vazia para utilizar a predefinição (Standard_D1_v2). | string |
Comentários
Brevemente: Ao longo de 2024, vamos descontinuar progressivamente o GitHub Issues como mecanismo de feedback para conteúdos e substituí-lo por um novo sistema de feedback. Para obter mais informações, veja: https://aka.ms/ContentUserFeedback.
Submeter e ver comentários