Partilhar via

Microsoft.VirtualMachineImages imageTemplates 2019-05-01-preview

Definição de recursos do bíceps

O tipo de recurso imageTemplates pode ser implantado com operações que visam:

Para obter uma lista de propriedades alteradas em cada versão da API, consulte log de alterações.

Formato do recurso

Para criar um recurso Microsoft.VirtualMachineImages/imageTemplates, adicione o seguinte Bíceps ao seu modelo.

resource symbolicname 'Microsoft.VirtualMachineImages/imageTemplates@2019-05-01-preview' = {
  identity: {
    type: 'string'
    userAssignedIdentities: {
      {customized property}: {}
    }
  }
  location: 'string'
  name: 'string'
  properties: {
    buildTimeoutInMinutes: int
    customize: [
      {
        name: 'string'
        type: 'string'
        // For remaining properties, see ImageTemplateCustomizer objects
      }
    ]
    distribute: [
      {
        artifactTags: {
          {customized property}: 'string'
        }
        runOutputName: 'string'
        type: 'string'
        // For remaining properties, see ImageTemplateDistributor objects
      }
    ]
    source: {
      type: 'string'
      // For remaining properties, see ImageTemplateSource objects
    }
    vmProfile: {
      vmSize: 'string'
    }
  }
  tags: {
    {customized property}: 'string'
  }
}

Objetos ImageTemplateDistributor

Defina a propriedade type para especificar o tipo de objeto.

Para ManagedImage , use:

{
  imageId: 'string'
  location: 'string'
  type: 'ManagedImage'
}

Para SharedImage , use:

{
  galleryImageId: 'string'
  replicationRegions: [
    'string'
  ]
  type: 'SharedImage'
}

Para VHD, use:

{
  type: 'VHD'
}

Objetos ImageTemplateCustomizer

Defina a propriedade type para especificar o tipo de objeto.

Para Arquivo, use:

{
  destination: 'string'
  sha256Checksum: 'string'
  sourceUri: 'string'
  type: 'File'
}

Para PowerShell, use:

{
  inline: [
    'string'
  ]
  runElevated: bool
  scriptUri: 'string'
  sha256Checksum: 'string'
  type: 'PowerShell'
  validExitCodes: [
    int
  ]
}

Para Shell, use:

{
  inline: [
    'string'
  ]
  scriptUri: 'string'
  sha256Checksum: 'string'
  type: 'Shell'
}

Para WindowsRestart, use:

{
  restartCheckCommand: 'string'
  restartCommand: 'string'
  restartTimeout: 'string'
  type: 'WindowsRestart'
}

Objetos ImageTemplateSource

Defina a propriedade type para especificar o tipo de objeto.

Para ISO, use:

{
  sha256Checksum: 'string'
  sourceUri: 'string'
  type: 'ISO'
}

Para ManagedImage , use:

{
  imageId: 'string'
  type: 'ManagedImage'
}

Para PlatformImage , use:

{
  offer: 'string'
  publisher: 'string'
  sku: 'string'
  type: 'PlatformImage'
  version: 'string'
}

Para SharedImageVersion, use:

{
  imageVersionId: 'string'
  type: 'SharedImageVersion'
}

Valores de propriedade

Microsoft.VirtualMachineImages/imageTemplates

Nome Descrição Valor
identidade A identidade do modelo de imagem, se configurado. ImageTemplateIdentity
localização Localização do recurso string (obrigatório)
nome O nome do recurso cadeia de caracteres

Restrições:
Padrão = ^[A-Za-z0-9-_.]{1,64}$ (obrigatório)
propriedades As propriedades do modelo de imagem ImageTemplateProperties
etiquetas Etiquetas de recursos Dicionário de nomes e valores de tags. Ver Tags em modelos

ComponentsVrq145SchemasImagetemplateidentityPropertiesUserassignedidentitiesAdditionalproperties

Nome Descrição Valor

ImageTemplateCustomizer

Nome Descrição Valor
nome Nome amigável para fornecer contexto sobre o que esta etapa de personalização faz corda
tipo Defina como 'File' para o tipo ImageTemplateFileCustomizer. Defina como 'PowerShell' para o tipo ImageTemplatePowerShellCustomizer. Defina como 'Shell' para o tipo ImageTemplateShellCustomizer. Defina como 'WindowsRestart' para o tipo ImageTemplateRestartCustomizer. 'Ficheiro'
'PowerShell'
'Concha'
'WindowsRestart' (obrigatório)

ImageTemplateDistribuidor

Nome Descrição Valor
artifactTags Tags que serão aplicadas ao artefato depois que ele for criado/atualizado pelo distribuidor. ImageTemplateDistributorArtifactTags
runOutputName O nome a ser usado para o RunOutput associado. cadeia de caracteres

Restrições:
Padrão = ^[A-Za-z0-9-_.]{1,64}$ (obrigatório)
tipo Defina como 'ManagedImage' para o tipo ImageTemplateManagedImageDistributor. Defina como 'SharedImage' para o tipo ImageTemplateSharedImageDistributor. Defina como 'VHD' para o tipo ImageTemplateVhdDistributor. 'ManagedImage'
'Imagem compartilhada'
«VHD» (obrigatório)

ImageTemplateDistributorArtifactTags

Nome Descrição Valor

ImageTemplateFileCustomizer

Nome Descrição Valor
destino O caminho absoluto para um arquivo (com estruturas de diretório aninhadas já criadas) onde o arquivo (de sourceUri) será carregado na VM corda
sha256Soma de verificação Soma de verificação SHA256 do arquivo fornecido no campo sourceUri acima corda
fonteUri O URI do arquivo a ser carregado para personalizar a VM. Pode ser um link github, URI SAS para Armazenamento do Azure, etc corda
tipo O tipo de ferramenta de personalização que você deseja usar na Imagem. Por exemplo, "Shell" pode ser personalizador de shell 'Ficheiro' (obrigatório)

ImageTemplateIdentity

Nome Descrição Valor
tipo O tipo de identidade usado para o modelo de imagem. O tipo 'Nenhum' removerá todas as identidades do modelo de imagem. 'Nenhuma'
'UserAssigned'
identidades atribuídas pelo utilizador A lista de identidades de usuário associadas ao modelo de imagem. As referências de chave do dicionário de identidade do usuário serão ids de recurso ARM no formato: '/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ManagedIdentity/userAssignedIdentities/{identityName}'. ImageTemplateIdentityUserAssignedIdentities

ImageTemplateIdentityUserAssignedIdentities

Nome Descrição Valor

ImageTemplateIsoSource

Nome Descrição Valor
sha256Soma de verificação SHA256 Soma de verificação da imagem ISO. string (obrigatório)
fonteUri URI para obter a imagem ISO. Esse URI deve estar acessível ao provedor de recursos no momento da criação do modelo de imagem. string (obrigatório)
tipo Especifica o tipo de imagem de origem com a qual você deseja começar. «ISO» (obrigatório)

ImageTemplateManagedImageDistributor

Nome Descrição Valor
imageId ID do recurso da imagem de disco gerenciado string (obrigatório)
localização O local do Azure para a imagem, deve corresponder se a imagem já existir string (obrigatório)
tipo Tipo de distribuição. 'ManagedImage' (obrigatório)

ImageTemplateManagedImageSource

Nome Descrição Valor
imageId ID de recurso ARM da imagem gerenciada na assinatura do cliente string (obrigatório)
tipo Especifica o tipo de imagem de origem com a qual você deseja começar. 'ManagedImage' (obrigatório)

ImageTemplatePlatformImageSource

Nome Descrição Valor
oferta Oferta de imagem das Imagens da Galeria do Azure. corda
publicador Image Publisher em imagens da Galeria do Azure. corda
SKU Imagem sku das Imagens da Galeria do Azure. corda
tipo Especifica o tipo de imagem de origem com a qual você deseja começar. 'PlatformImage' (obrigatório)
versão Versão da imagem das Imagens da Galeria do Azure. corda

ImageTemplatePowerShellCustomizer

Nome Descrição Valor
em linha Matriz de comandos do PowerShell para executar string[]
runElevado 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 um link github, URI SAS para Armazenamento do Azure, etc corda
sha256Soma de verificação Soma de verificação SHA256 do script power shell fornecido no campo scriptUri acima corda
tipo O tipo de ferramenta de personalização que você deseja usar na Imagem. Por exemplo, "Shell" pode ser personalizador de shell 'PowerShell' (obrigatório)
validExitCodes Códigos de saída válidos para o script do PowerShell. [Padrão: 0] int[]

ImageTemplateProperties

Nome Descrição Valor
buildTimeoutInMinutes Duração máxima de espera durante a criação do modelo de imagem. Omitir ou especificar 0 para usar o padrão (4 horas). Int

Restrições:
Valor mínimo = 0
Valor máximo = 960
Personalizar Especifica as propriedades usadas para descrever as etapas de personalização da imagem, como Fonte da imagem, etc ImageTemplateCustomizer[]
distribuir A distribuição destina-se para onde a saída de imagem precisa ir. ImageTemplateDistributor[] (obrigatório)
fonte Especifica as propriedades usadas para descrever a imagem de origem. ImageTemplateSource (obrigatório)
vmProfile Descreve como a máquina virtual é configurada para criar imagens ImageTemplateVmProfile

ImageTemplateRestartCustomizer

Nome Descrição Valor
restartCheckCommand Comando para verificar se a reinicialização foi bem-sucedida [Padrão: ''] corda
restartCommand Comando para executar a reinicialização [Padrão: 'shutdown /r /f /t 0 /c "packer restart"'] corda
restartTimeout Tempo limite de reinicialização especificado como uma cadeia de magnitude e unidade, por exemplo, '5m' (5 minutos) ou '2h' (2 horas) [Padrão: '5m'] corda
tipo O tipo de ferramenta de personalização que você deseja usar na Imagem. Por exemplo, "Shell" pode ser personalizador de shell 'WindowsRestart' (obrigatório)

ImageTemplateSharedImageDistributor

Nome Descrição Valor
galeriaImageId ID do recurso da imagem da Galeria de Imagens Partilhadas string (obrigatório)
replicaçãoRegiões Uma lista de regiões para as quais a imagem será replicada string[] (obrigatório)
tipo Tipo de distribuição. 'SharedImage' (obrigatório)

ImageTemplateSharedImageVersionSource

Nome Descrição Valor
imageVersionId ID do recurso ARM da versão da imagem na galeria de imagens compartilhadas string (obrigatório)
tipo Especifica o tipo de imagem de origem com a qual você deseja começar. 'SharedImageVersion' (obrigatório)

ImageTemplateShellCustomizer

Nome Descrição Valor
em linha Matriz de comandos do shell para executar string[]
scriptUri URI do shell script a ser executado para personalização. Pode ser um link github, URI SAS para Armazenamento do Azure, etc corda
sha256Soma de verificação Soma de verificação SHA256 do shell script fornecido no campo scriptUri corda
tipo O tipo de ferramenta de personalização que você deseja usar na Imagem. Por exemplo, "Shell" pode ser personalizador de shell 'Shell' (obrigatório)

ImageTemplateSource

Nome Descrição Valor
tipo Defina como 'ISO' para o tipo ImageTemplateIsoSource. Defina como 'ManagedImage' para o tipo ImageTemplateManagedImageSource. Defina como 'PlatformImage' para o tipo ImageTemplatePlatformImageSource. Defina como 'SharedImageVersion' para o tipo ImageTemplateSharedImageVersionSource. «ISO»
'ManagedImage'
'Imagem de plataforma'
'SharedImageVersion' (obrigatório)

ImageTemplateVhdDistribuidor

Nome Descrição Valor
tipo Tipo de distribuição. «VHD» (obrigatório)

ImageTemplateVmProfile

Nome Descrição Valor
vmTamanho Tamanho da máquina virtual usada para criar, personalizar e capturar imagens. Omita ou especifique a cadeia de caracteres vazia para usar o padrão (Standard_D1_v2). corda

Tags de Recursos

Nome Descrição Valor

Exemplos de uso

Módulos verificados do Azure

Os seguintes de Módulos Verificados do Azure podem ser usados para implantar esse tipo de recurso.

Módulo Descrição
Modelo de Imagem de Máquina Virtual Módulo de recursos AVM para modelo de imagem de máquina virtual

Exemplos de início rápido do Azure

Os seguintes modelos de início rápido do Azure contêm exemplos de Bicep para implantar esse tipo de recurso.

Arquivo Bicep Descrição
Azure Image Builder com Azure Windows Baseline Cria um ambiente do Azure Image Builder e cria uma imagem do Windows Server com as atualizações mais recentes do Windows e a linha de base do Windows do Azure aplicadas.
Configurar o serviço Caixa de Desenvolvimento Este modelo criaria todos os recursos de administração da Caixa de Desenvolvimento de acordo com o guia de início rápido da Caixa de Desenvolvimento (/azure/dev-box/quickstart-create-dev-box). Você pode visualizar todos os recursos criados ou ir diretamente para DevPortal.microsoft.com para criar sua primeira Caixa de Desenvolvimento.

Definição de recurso de modelo ARM

O tipo de recurso imageTemplates pode ser implantado com operações que visam:

Para obter uma lista de propriedades alteradas em cada versão da API, consulte log 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",
  "identity": {
    "type": "string",
    "userAssignedIdentities": {
      "{customized property}": {
      }
    }
  },
  "location": "string",
  "properties": {
    "buildTimeoutInMinutes": "int",
    "customize": [ {
      "name": "string",
      "type": "string"
      // For remaining properties, see ImageTemplateCustomizer objects
    } ],
    "distribute": [ {
      "artifactTags": {
        "{customized property}": "string"
      },
      "runOutputName": "string",
      "type": "string"
      // For remaining properties, see ImageTemplateDistributor objects
    } ],
    "source": {
      "type": "string"
      // For remaining properties, see ImageTemplateSource objects
    },
    "vmProfile": {
      "vmSize": "string"
    }
  },
  "tags": {
    "{customized property}": "string"
  }
}

Objetos ImageTemplateDistributor

Defina a propriedade type para especificar o tipo de objeto.

Para ManagedImage , use:

{
  "imageId": "string",
  "location": "string",
  "type": "ManagedImage"
}

Para SharedImage , use:

{
  "galleryImageId": "string",
  "replicationRegions": [ "string" ],
  "type": "SharedImage"
}

Para VHD, use:

{
  "type": "VHD"
}

Objetos ImageTemplateCustomizer

Defina a propriedade type para especificar o tipo de objeto.

Para Arquivo, use:

{
  "destination": "string",
  "sha256Checksum": "string",
  "sourceUri": "string",
  "type": "File"
}

Para PowerShell, use:

{
  "inline": [ "string" ],
  "runElevated": "bool",
  "scriptUri": "string",
  "sha256Checksum": "string",
  "type": "PowerShell",
  "validExitCodes": [ "int" ]
}

Para Shell, use:

{
  "inline": [ "string" ],
  "scriptUri": "string",
  "sha256Checksum": "string",
  "type": "Shell"
}

Para WindowsRestart, use:

{
  "restartCheckCommand": "string",
  "restartCommand": "string",
  "restartTimeout": "string",
  "type": "WindowsRestart"
}

Objetos ImageTemplateSource

Defina a propriedade type para especificar o tipo de objeto.

Para ISO, use:

{
  "sha256Checksum": "string",
  "sourceUri": "string",
  "type": "ISO"
}

Para ManagedImage , use:

{
  "imageId": "string",
  "type": "ManagedImage"
}

Para PlatformImage , use:

{
  "offer": "string",
  "publisher": "string",
  "sku": "string",
  "type": "PlatformImage",
  "version": "string"
}

Para SharedImageVersion, use:

{
  "imageVersionId": "string",
  "type": "SharedImageVersion"
}

Valores de propriedade

Microsoft.VirtualMachineImages/imageTemplates

Nome Descrição Valor
Versão da API A versão api '2019-05-01-pré-visualização'
identidade A identidade do modelo de imagem, se configurado. ImageTemplateIdentity
localização Localização do recurso string (obrigatório)
nome O nome do recurso cadeia de caracteres

Restrições:
Padrão = ^[A-Za-z0-9-_.]{1,64}$ (obrigatório)
propriedades As propriedades do modelo de imagem ImageTemplateProperties
etiquetas Etiquetas de recursos Dicionário de nomes e valores de tags. Ver Tags em modelos
tipo O tipo de recurso 'Microsoft.VirtualMachineImages/imageTemplates'

ComponentsVrq145SchemasImagetemplateidentityPropertiesUserassignedidentitiesAdditionalproperties

Nome Descrição Valor

ImageTemplateCustomizer

Nome Descrição Valor
nome Nome amigável para fornecer contexto sobre o que esta etapa de personalização faz corda
tipo Defina como 'File' para o tipo ImageTemplateFileCustomizer. Defina como 'PowerShell' para o tipo ImageTemplatePowerShellCustomizer. Defina como 'Shell' para o tipo ImageTemplateShellCustomizer. Defina como 'WindowsRestart' para o tipo ImageTemplateRestartCustomizer. 'Ficheiro'
'PowerShell'
'Concha'
'WindowsRestart' (obrigatório)

ImageTemplateDistribuidor

Nome Descrição Valor
artifactTags Tags que serão aplicadas ao artefato depois que ele for criado/atualizado pelo distribuidor. ImageTemplateDistributorArtifactTags
runOutputName O nome a ser usado para o RunOutput associado. cadeia de caracteres

Restrições:
Padrão = ^[A-Za-z0-9-_.]{1,64}$ (obrigatório)
tipo Defina como 'ManagedImage' para o tipo ImageTemplateManagedImageDistributor. Defina como 'SharedImage' para o tipo ImageTemplateSharedImageDistributor. Defina como 'VHD' para o tipo ImageTemplateVhdDistributor. 'ManagedImage'
'Imagem compartilhada'
«VHD» (obrigatório)

ImageTemplateDistributorArtifactTags

Nome Descrição Valor

ImageTemplateFileCustomizer

Nome Descrição Valor
destino O caminho absoluto para um arquivo (com estruturas de diretório aninhadas já criadas) onde o arquivo (de sourceUri) será carregado na VM corda
sha256Soma de verificação Soma de verificação SHA256 do arquivo fornecido no campo sourceUri acima corda
fonteUri O URI do arquivo a ser carregado para personalizar a VM. Pode ser um link github, URI SAS para Armazenamento do Azure, etc corda
tipo O tipo de ferramenta de personalização que você deseja usar na Imagem. Por exemplo, "Shell" pode ser personalizador de shell 'Ficheiro' (obrigatório)

ImageTemplateIdentity

Nome Descrição Valor
tipo O tipo de identidade usado para o modelo de imagem. O tipo 'Nenhum' removerá todas as identidades do modelo de imagem. 'Nenhuma'
'UserAssigned'
identidades atribuídas pelo utilizador A lista de identidades de usuário associadas ao modelo de imagem. As referências de chave do dicionário de identidade do usuário serão ids de recurso ARM no formato: '/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ManagedIdentity/userAssignedIdentities/{identityName}'. ImageTemplateIdentityUserAssignedIdentities

ImageTemplateIdentityUserAssignedIdentities

Nome Descrição Valor

ImageTemplateIsoSource

Nome Descrição Valor
sha256Soma de verificação SHA256 Soma de verificação da imagem ISO. string (obrigatório)
fonteUri URI para obter a imagem ISO. Esse URI deve estar acessível ao provedor de recursos no momento da criação do modelo de imagem. string (obrigatório)
tipo Especifica o tipo de imagem de origem com a qual você deseja começar. «ISO» (obrigatório)

ImageTemplateManagedImageDistributor

Nome Descrição Valor
imageId ID do recurso da imagem de disco gerenciado string (obrigatório)
localização O local do Azure para a imagem, deve corresponder se a imagem já existir string (obrigatório)
tipo Tipo de distribuição. 'ManagedImage' (obrigatório)

ImageTemplateManagedImageSource

Nome Descrição Valor
imageId ID de recurso ARM da imagem gerenciada na assinatura do cliente string (obrigatório)
tipo Especifica o tipo de imagem de origem com a qual você deseja começar. 'ManagedImage' (obrigatório)

ImageTemplatePlatformImageSource

Nome Descrição Valor
oferta Oferta de imagem das Imagens da Galeria do Azure. corda
publicador Image Publisher em imagens da Galeria do Azure. corda
SKU Imagem sku das Imagens da Galeria do Azure. corda
tipo Especifica o tipo de imagem de origem com a qual você deseja começar. 'PlatformImage' (obrigatório)
versão Versão da imagem das Imagens da Galeria do Azure. corda

ImageTemplatePowerShellCustomizer

Nome Descrição Valor
em linha Matriz de comandos do PowerShell para executar string[]
runElevado 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 um link github, URI SAS para Armazenamento do Azure, etc corda
sha256Soma de verificação Soma de verificação SHA256 do script power shell fornecido no campo scriptUri acima corda
tipo O tipo de ferramenta de personalização que você deseja usar na Imagem. Por exemplo, "Shell" pode ser personalizador de shell 'PowerShell' (obrigatório)
validExitCodes Códigos de saída válidos para o script do PowerShell. [Padrão: 0] int[]

ImageTemplateProperties

Nome Descrição Valor
buildTimeoutInMinutes Duração máxima de espera durante a criação do modelo de imagem. Omitir ou especificar 0 para usar o padrão (4 horas). Int

Restrições:
Valor mínimo = 0
Valor máximo = 960
Personalizar Especifica as propriedades usadas para descrever as etapas de personalização da imagem, como Fonte da imagem, etc ImageTemplateCustomizer[]
distribuir A distribuição destina-se para onde a saída de imagem precisa ir. ImageTemplateDistributor[] (obrigatório)
fonte Especifica as propriedades usadas para descrever a imagem de origem. ImageTemplateSource (obrigatório)
vmProfile Descreve como a máquina virtual é configurada para criar imagens ImageTemplateVmProfile

ImageTemplateRestartCustomizer

Nome Descrição Valor
restartCheckCommand Comando para verificar se a reinicialização foi bem-sucedida [Padrão: ''] corda
restartCommand Comando para executar a reinicialização [Padrão: 'shutdown /r /f /t 0 /c "packer restart"'] corda
restartTimeout Tempo limite de reinicialização especificado como uma cadeia de magnitude e unidade, por exemplo, '5m' (5 minutos) ou '2h' (2 horas) [Padrão: '5m'] corda
tipo O tipo de ferramenta de personalização que você deseja usar na Imagem. Por exemplo, "Shell" pode ser personalizador de shell 'WindowsRestart' (obrigatório)

ImageTemplateSharedImageDistributor

Nome Descrição Valor
galeriaImageId ID do recurso da imagem da Galeria de Imagens Partilhadas string (obrigatório)
replicaçãoRegiões Uma lista de regiões para as quais a imagem será replicada string[] (obrigatório)
tipo Tipo de distribuição. 'SharedImage' (obrigatório)

ImageTemplateSharedImageVersionSource

Nome Descrição Valor
imageVersionId ID do recurso ARM da versão da imagem na galeria de imagens compartilhadas string (obrigatório)
tipo Especifica o tipo de imagem de origem com a qual você deseja começar. 'SharedImageVersion' (obrigatório)

ImageTemplateShellCustomizer

Nome Descrição Valor
em linha Matriz de comandos do shell para executar string[]
scriptUri URI do shell script a ser executado para personalização. Pode ser um link github, URI SAS para Armazenamento do Azure, etc corda
sha256Soma de verificação Soma de verificação SHA256 do shell script fornecido no campo scriptUri corda
tipo O tipo de ferramenta de personalização que você deseja usar na Imagem. Por exemplo, "Shell" pode ser personalizador de shell 'Shell' (obrigatório)

ImageTemplateSource

Nome Descrição Valor
tipo Defina como 'ISO' para o tipo ImageTemplateIsoSource. Defina como 'ManagedImage' para o tipo ImageTemplateManagedImageSource. Defina como 'PlatformImage' para o tipo ImageTemplatePlatformImageSource. Defina como 'SharedImageVersion' para o tipo ImageTemplateSharedImageVersionSource. «ISO»
'ManagedImage'
'Imagem de plataforma'
'SharedImageVersion' (obrigatório)

ImageTemplateVhdDistribuidor

Nome Descrição Valor
tipo Tipo de distribuição. «VHD» (obrigatório)

ImageTemplateVmProfile

Nome Descrição Valor
vmTamanho Tamanho da máquina virtual usada para criar, personalizar e capturar imagens. Omita ou especifique a cadeia de caracteres vazia para usar o padrão (Standard_D1_v2). corda

Tags de Recursos

Nome Descrição Valor

Exemplos de uso

Modelos de início rápido do Azure

Os seguintes modelos de início rápido do Azure implantam esse tipo de recurso.

Modelo Descrição
Azure Image Builder com Azure Windows Baseline

Implantar no Azure 		Cria um ambiente do Azure Image Builder e cria uma imagem do Windows Server com as atualizações mais recentes do Windows e a linha de base do Windows do Azure aplicadas.
Configurar o serviço Caixa de Desenvolvimento

Implantar no Azure 		Este modelo criaria todos os recursos de administração da Caixa de Desenvolvimento de acordo com o guia de início rápido da Caixa de Desenvolvimento (/azure/dev-box/quickstart-create-dev-box). Você pode visualizar todos os recursos criados ou ir diretamente para DevPortal.microsoft.com para criar sua primeira Caixa de Desenvolvimento.

Definição de recursos Terraform (provedor AzAPI)

O tipo de recurso imageTemplates pode ser implantado com operações que visam:

  • Grupos de recursos

Para obter uma lista de propriedades alteradas em cada versão da API, consulte log 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"
  parent_id = "string"
  identity {
    type = "string"
    identity_ids = [
      "string"
    ]
  }
  location = "string"
  tags = {
    {customized property} = "string"
  }
  body = {
    properties = {
      buildTimeoutInMinutes = int
      customize = [
        {
          name = "string"
          type = "string"
          // For remaining properties, see ImageTemplateCustomizer objects
        }
      ]
      distribute = [
        {
          artifactTags = {
            {customized property} = "string"
          }
          runOutputName = "string"
          type = "string"
          // For remaining properties, see ImageTemplateDistributor objects
        }
      ]
      source = {
        type = "string"
        // For remaining properties, see ImageTemplateSource objects
      }
      vmProfile = {
        vmSize = "string"
      }
    }
  }
}

Objetos ImageTemplateDistributor

Defina a propriedade type para especificar o tipo de objeto.

Para ManagedImage , use:

{
  imageId = "string"
  location = "string"
  type = "ManagedImage"
}

Para SharedImage , use:

{
  galleryImageId = "string"
  replicationRegions = [
    "string"
  ]
  type = "SharedImage"
}

Para VHD, use:

{
  type = "VHD"
}

Objetos ImageTemplateCustomizer

Defina a propriedade type para especificar o tipo de objeto.

Para Arquivo, use:

{
  destination = "string"
  sha256Checksum = "string"
  sourceUri = "string"
  type = "File"
}

Para PowerShell, use:

{
  inline = [
    "string"
  ]
  runElevated = bool
  scriptUri = "string"
  sha256Checksum = "string"
  type = "PowerShell"
  validExitCodes = [
    int
  ]
}

Para Shell, use:

{
  inline = [
    "string"
  ]
  scriptUri = "string"
  sha256Checksum = "string"
  type = "Shell"
}

Para WindowsRestart, use:

{
  restartCheckCommand = "string"
  restartCommand = "string"
  restartTimeout = "string"
  type = "WindowsRestart"
}

Objetos ImageTemplateSource

Defina a propriedade type para especificar o tipo de objeto.

Para ISO, use:

{
  sha256Checksum = "string"
  sourceUri = "string"
  type = "ISO"
}

Para ManagedImage , use:

{
  imageId = "string"
  type = "ManagedImage"
}

Para PlatformImage , use:

{
  offer = "string"
  publisher = "string"
  sku = "string"
  type = "PlatformImage"
  version = "string"
}

Para SharedImageVersion, use:

{
  imageVersionId = "string"
  type = "SharedImageVersion"
}

Valores de propriedade

Microsoft.VirtualMachineImages/imageTemplates

Nome Descrição Valor
identidade A identidade do modelo de imagem, se configurado. ImageTemplateIdentity
localização Localização do recurso string (obrigatório)
nome O nome do recurso cadeia de caracteres

Restrições:
Padrão = ^[A-Za-z0-9-_.]{1,64}$ (obrigatório)
propriedades As propriedades do modelo de imagem ImageTemplateProperties
etiquetas Etiquetas de recursos Dicionário de nomes e valores de tags.
tipo O tipo de recurso "Microsoft.VirtualMachineImages/imageTemplates@2019-05-01-preview"

ComponentsVrq145SchemasImagetemplateidentityPropertiesUserassignedidentitiesAdditionalproperties

Nome Descrição Valor

ImageTemplateCustomizer

Nome Descrição Valor
nome Nome amigável para fornecer contexto sobre o que esta etapa de personalização faz corda
tipo Defina como 'File' para o tipo ImageTemplateFileCustomizer. Defina como 'PowerShell' para o tipo ImageTemplatePowerShellCustomizer. Defina como 'Shell' para o tipo ImageTemplateShellCustomizer. Defina como 'WindowsRestart' para o tipo ImageTemplateRestartCustomizer. 'Ficheiro'
'PowerShell'
'Concha'
'WindowsRestart' (obrigatório)

ImageTemplateDistribuidor

Nome Descrição Valor
artifactTags Tags que serão aplicadas ao artefato depois que ele for criado/atualizado pelo distribuidor. ImageTemplateDistributorArtifactTags
runOutputName O nome a ser usado para o RunOutput associado. cadeia de caracteres

Restrições:
Padrão = ^[A-Za-z0-9-_.]{1,64}$ (obrigatório)
tipo Defina como 'ManagedImage' para o tipo ImageTemplateManagedImageDistributor. Defina como 'SharedImage' para o tipo ImageTemplateSharedImageDistributor. Defina como 'VHD' para o tipo ImageTemplateVhdDistributor. 'ManagedImage'
'Imagem compartilhada'
«VHD» (obrigatório)

ImageTemplateDistributorArtifactTags

Nome Descrição Valor

ImageTemplateFileCustomizer

Nome Descrição Valor
destino O caminho absoluto para um arquivo (com estruturas de diretório aninhadas já criadas) onde o arquivo (de sourceUri) será carregado na VM corda
sha256Soma de verificação Soma de verificação SHA256 do arquivo fornecido no campo sourceUri acima corda
fonteUri O URI do arquivo a ser carregado para personalizar a VM. Pode ser um link github, URI SAS para Armazenamento do Azure, etc corda
tipo O tipo de ferramenta de personalização que você deseja usar na Imagem. Por exemplo, "Shell" pode ser personalizador de shell 'Ficheiro' (obrigatório)

ImageTemplateIdentity

Nome Descrição Valor
tipo O tipo de identidade usado para o modelo de imagem. O tipo 'Nenhum' removerá todas as identidades do modelo de imagem. 'Nenhuma'
'UserAssigned'
identidades atribuídas pelo utilizador A lista de identidades de usuário associadas ao modelo de imagem. As referências de chave do dicionário de identidade do usuário serão ids de recurso ARM no formato: '/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ManagedIdentity/userAssignedIdentities/{identityName}'. ImageTemplateIdentityUserAssignedIdentities

ImageTemplateIdentityUserAssignedIdentities

Nome Descrição Valor

ImageTemplateIsoSource

Nome Descrição Valor
sha256Soma de verificação SHA256 Soma de verificação da imagem ISO. string (obrigatório)
fonteUri URI para obter a imagem ISO. Esse URI deve estar acessível ao provedor de recursos no momento da criação do modelo de imagem. string (obrigatório)
tipo Especifica o tipo de imagem de origem com a qual você deseja começar. «ISO» (obrigatório)

ImageTemplateManagedImageDistributor

Nome Descrição Valor
imageId ID do recurso da imagem de disco gerenciado string (obrigatório)
localização O local do Azure para a imagem, deve corresponder se a imagem já existir string (obrigatório)
tipo Tipo de distribuição. 'ManagedImage' (obrigatório)

ImageTemplateManagedImageSource

Nome Descrição Valor
imageId ID de recurso ARM da imagem gerenciada na assinatura do cliente string (obrigatório)
tipo Especifica o tipo de imagem de origem com a qual você deseja começar. 'ManagedImage' (obrigatório)

ImageTemplatePlatformImageSource

Nome Descrição Valor
oferta Oferta de imagem das Imagens da Galeria do Azure. corda
publicador Image Publisher em imagens da Galeria do Azure. corda
SKU Imagem sku das Imagens da Galeria do Azure. corda
tipo Especifica o tipo de imagem de origem com a qual você deseja começar. 'PlatformImage' (obrigatório)
versão Versão da imagem das Imagens da Galeria do Azure. corda

ImageTemplatePowerShellCustomizer

Nome Descrição Valor
em linha Matriz de comandos do PowerShell para executar string[]
runElevado 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 um link github, URI SAS para Armazenamento do Azure, etc corda
sha256Soma de verificação Soma de verificação SHA256 do script power shell fornecido no campo scriptUri acima corda
tipo O tipo de ferramenta de personalização que você deseja usar na Imagem. Por exemplo, "Shell" pode ser personalizador de shell 'PowerShell' (obrigatório)
validExitCodes Códigos de saída válidos para o script do PowerShell. [Padrão: 0] int[]

ImageTemplateProperties

Nome Descrição Valor
buildTimeoutInMinutes Duração máxima de espera durante a criação do modelo de imagem. Omitir ou especificar 0 para usar o padrão (4 horas). Int

Restrições:
Valor mínimo = 0
Valor máximo = 960
Personalizar Especifica as propriedades usadas para descrever as etapas de personalização da imagem, como Fonte da imagem, etc ImageTemplateCustomizer[]
distribuir A distribuição destina-se para onde a saída de imagem precisa ir. ImageTemplateDistributor[] (obrigatório)
fonte Especifica as propriedades usadas para descrever a imagem de origem. ImageTemplateSource (obrigatório)
vmProfile Descreve como a máquina virtual é configurada para criar imagens ImageTemplateVmProfile

ImageTemplateRestartCustomizer

Nome Descrição Valor
restartCheckCommand Comando para verificar se a reinicialização foi bem-sucedida [Padrão: ''] corda
restartCommand Comando para executar a reinicialização [Padrão: 'shutdown /r /f /t 0 /c "packer restart"'] corda
restartTimeout Tempo limite de reinicialização especificado como uma cadeia de magnitude e unidade, por exemplo, '5m' (5 minutos) ou '2h' (2 horas) [Padrão: '5m'] corda
tipo O tipo de ferramenta de personalização que você deseja usar na Imagem. Por exemplo, "Shell" pode ser personalizador de shell 'WindowsRestart' (obrigatório)

ImageTemplateSharedImageDistributor

Nome Descrição Valor
galeriaImageId ID do recurso da imagem da Galeria de Imagens Partilhadas string (obrigatório)
replicaçãoRegiões Uma lista de regiões para as quais a imagem será replicada string[] (obrigatório)
tipo Tipo de distribuição. 'SharedImage' (obrigatório)

ImageTemplateSharedImageVersionSource

Nome Descrição Valor
imageVersionId ID do recurso ARM da versão da imagem na galeria de imagens compartilhadas string (obrigatório)
tipo Especifica o tipo de imagem de origem com a qual você deseja começar. 'SharedImageVersion' (obrigatório)

ImageTemplateShellCustomizer

Nome Descrição Valor
em linha Matriz de comandos do shell para executar string[]
scriptUri URI do shell script a ser executado para personalização. Pode ser um link github, URI SAS para Armazenamento do Azure, etc corda
sha256Soma de verificação Soma de verificação SHA256 do shell script fornecido no campo scriptUri corda
tipo O tipo de ferramenta de personalização que você deseja usar na Imagem. Por exemplo, "Shell" pode ser personalizador de shell 'Shell' (obrigatório)

ImageTemplateSource

Nome Descrição Valor
tipo Defina como 'ISO' para o tipo ImageTemplateIsoSource. Defina como 'ManagedImage' para o tipo ImageTemplateManagedImageSource. Defina como 'PlatformImage' para o tipo ImageTemplatePlatformImageSource. Defina como 'SharedImageVersion' para o tipo ImageTemplateSharedImageVersionSource. «ISO»
'ManagedImage'
'Imagem de plataforma'
'SharedImageVersion' (obrigatório)

ImageTemplateVhdDistribuidor

Nome Descrição Valor
tipo Tipo de distribuição. «VHD» (obrigatório)

ImageTemplateVmProfile

Nome Descrição Valor
vmTamanho Tamanho da máquina virtual usada para criar, personalizar e capturar imagens. Omita ou especifique a cadeia de caracteres vazia para usar o padrão (Standard_D1_v2). corda

Tags de Recursos

Nome Descrição Valor