Compartilhar via


Microsoft.VirtualMachineImages imageTemplates 2018-02-01-preview

Definição de recurso do Bicep

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

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

Formato de recurso

Para criar um recurso Microsoft.VirtualMachineImages/imageTemplates, adicione o Bicep a seguir ao modelo.

resource symbolicname 'Microsoft.VirtualMachineImages/imageTemplates@2018-02-01-preview' = {
  location: 'string'
  name: 'string'
  properties: {
    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
    }
  }
  tags: {
    {customized property}: 'string'
  }
}

Objetos ImageTemplateDistributor

Defina a propriedade tipo para especificar o tipo de objeto.

Para managedImage, use:

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

Para sharedImage, use:

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

Objetos ImageTemplateCustomizer

Defina a propriedade tipo para especificar o tipo de objeto.

Para shell, use:

{
  script: 'string'
  type: 'shell'
}

Objetos ImageTemplateSource

Defina a propriedade tipo para especificar o tipo de objeto.

Para ISO, use:

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

Para PlatformImage, use:

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

Valores de propriedade

ImageTemplateCustomizer

Nome Descrição Valor
nome Nome Amigável para fornecer contexto sobre o que essa etapa de personalização faz corda
tipo Defina como 'shell' para o tipo ImageTemplateShellCustomizer. 'shell' (obrigatório)

ImageTemplateDistributor

Nome Descrição Valor
artifactTags Marcas que serão aplicadas ao artefato depois que ele tiver sido criado/atualizado pelo distribuidor. ImageTemplateDistributorArtifactTags
runOutputName O nome a ser usado para o RunOutput associado. corda

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. 'managedImage'
'sharedImage' (obrigatório)

ImageTemplateDistributorArtifactTags

Nome Descrição Valor

ImageTemplateIsoSource

Nome Descrição Valor
sha256Checksum Soma de verificação SHA256 da imagem ISO. cadeia de caracteres (obrigatório)
sourceURI URL para obter a imagem ISO. Essa URL deve ser acessível ao provedor de recursos no momento da criação do imageTemplate. cadeia de caracteres (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 cadeia de caracteres (obrigatório)
localização O local do Azure para a imagem deve corresponder se a imagem já existir cadeia de caracteres (obrigatório)
tipo Tipo de distribuição. 'managedImage' (obrigatório)

ImageTemplatePlatformImageSource

Nome Descrição Valor
oferecer Oferta de imagem doImagens da Galeria do Azure. corda
editor Editor de Imagens no de Imagens da Galeria do Azure. corda
Sku SKU de imagem dode 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 dode Imagens da Galeria do Azure . corda

ImageTemplateProperties

Nome Descrição Valor
Personalizar Especifica as propriedades usadas para descrever as etapas de personalização da imagem, como fonte de imagem etc. ImageTemplateCustomizer []
distribuir A distribuição é direcionada para onde a saída da imagem precisa ir. ImageTemplateDistributor[] (obrigatório)
fonte Especifica as propriedades usadas para descrever a imagem de origem. ImageTemplateSource (obrigatório)

ImageTemplateSharedImageDistributor

Nome Descrição Valor
galleryImageId ID do recurso da imagem da Galeria de Imagens Compartilhadas cadeia de caracteres (obrigatório)
replicationRegions string[] (obrigatório)
tipo Tipo de distribuição. 'sharedImage' (obrigatório)

ImageTemplateShellCustomizer

Nome Descrição Valor
roteiro O script de shell a ser executado para personalização. Pode ser um link do 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 shellCustomizer 'shell' (obrigatório)

ImageTemplateSource

Nome Descrição Valor
tipo Defina como 'ISO' para o tipo ImageTemplateIsoSource. Defina como 'PlatformImage' para o tipo ImageTemplatePlatformImageSource. 'ISO'
'PlatformImage' (obrigatório)

Microsoft.VirtualMachineImages/imageTemplates

Nome Descrição Valor
localização Local do recurso cadeia de caracteres (obrigatório)
nome O nome do recurso corda

Restrições:
Padrão = ^[A-Za-z0-9-_]{1,64}$ (obrigatório)
Propriedades ImageTemplateProperties
Tags Marcas de recurso Dicionário de nomes e valores de marca. Consulte Marcas em modelos

ResourceTags

Nome Descrição Valor

Exemplos de início rápido

Os exemplos de início rápido a seguir implantam esse tipo de recurso.

Arquivo Bicep Descrição
Construtor de Imagens do Azure com o de Linha de Base do Windows do Azure Cria um ambiente do Construtor de Imagens do Azure 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 de serviço do Dev Box Esse modelo criaria todos os recursos de administrador do Dev Box de acordo com o guia de início rápido do Dev Box (/azure/dev-box/quickstart-create-dev-box). Você pode exibir todos os recursos criados ou ir diretamente para DevPortal.microsoft.com para criar sua primeira Caixa de Desenvolvimento.

Definição de recurso de modelo do ARM

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

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

Formato de recurso

Para criar um recurso Microsoft.VirtualMachineImages/imageTemplates, adicione o JSON a seguir ao modelo.

{
  "type": "Microsoft.VirtualMachineImages/imageTemplates",
  "apiVersion": "2018-02-01-preview",
  "name": "string",
  "location": "string",
  "properties": {
    "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
    }
  },
  "tags": {
    "{customized property}": "string"
  }
}

Objetos ImageTemplateDistributor

Defina a propriedade tipo para especificar o tipo de objeto.

Para managedImage, use:

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

Para sharedImage, use:

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

Objetos ImageTemplateCustomizer

Defina a propriedade tipo para especificar o tipo de objeto.

Para shell, use:

{
  "script": "string",
  "type": "shell"
}

Objetos ImageTemplateSource

Defina a propriedade tipo para especificar o tipo de objeto.

Para ISO, use:

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

Para PlatformImage, use:

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

Valores de propriedade

ImageTemplateCustomizer

Nome Descrição Valor
nome Nome Amigável para fornecer contexto sobre o que essa etapa de personalização faz corda
tipo Defina como 'shell' para o tipo ImageTemplateShellCustomizer. 'shell' (obrigatório)

ImageTemplateDistributor

Nome Descrição Valor
artifactTags Marcas que serão aplicadas ao artefato depois que ele tiver sido criado/atualizado pelo distribuidor. ImageTemplateDistributorArtifactTags
runOutputName O nome a ser usado para o RunOutput associado. corda

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. 'managedImage'
'sharedImage' (obrigatório)

ImageTemplateDistributorArtifactTags

Nome Descrição Valor

ImageTemplateIsoSource

Nome Descrição Valor
sha256Checksum Soma de verificação SHA256 da imagem ISO. cadeia de caracteres (obrigatório)
sourceURI URL para obter a imagem ISO. Essa URL deve ser acessível ao provedor de recursos no momento da criação do imageTemplate. cadeia de caracteres (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 cadeia de caracteres (obrigatório)
localização O local do Azure para a imagem deve corresponder se a imagem já existir cadeia de caracteres (obrigatório)
tipo Tipo de distribuição. 'managedImage' (obrigatório)

ImageTemplatePlatformImageSource

Nome Descrição Valor
oferecer Oferta de imagem doImagens da Galeria do Azure. corda
editor Editor de Imagens no de Imagens da Galeria do Azure. corda
Sku SKU de imagem dode 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 dode Imagens da Galeria do Azure . corda

ImageTemplateProperties

Nome Descrição Valor
Personalizar Especifica as propriedades usadas para descrever as etapas de personalização da imagem, como fonte de imagem etc. ImageTemplateCustomizer []
distribuir A distribuição é direcionada para onde a saída da imagem precisa ir. ImageTemplateDistributor[] (obrigatório)
fonte Especifica as propriedades usadas para descrever a imagem de origem. ImageTemplateSource (obrigatório)

ImageTemplateSharedImageDistributor

Nome Descrição Valor
galleryImageId ID do recurso da imagem da Galeria de Imagens Compartilhadas cadeia de caracteres (obrigatório)
replicationRegions string[] (obrigatório)
tipo Tipo de distribuição. 'sharedImage' (obrigatório)

ImageTemplateShellCustomizer

Nome Descrição Valor
roteiro O script de shell a ser executado para personalização. Pode ser um link do 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 shellCustomizer 'shell' (obrigatório)

ImageTemplateSource

Nome Descrição Valor
tipo Defina como 'ISO' para o tipo ImageTemplateIsoSource. Defina como 'PlatformImage' para o tipo ImageTemplatePlatformImageSource. 'ISO'
'PlatformImage' (obrigatório)

Microsoft.VirtualMachineImages/imageTemplates

Nome Descrição Valor
apiVersion A versão da API '2018-02-01-preview'
localização Local do recurso cadeia de caracteres (obrigatório)
nome O nome do recurso corda

Restrições:
Padrão = ^[A-Za-z0-9-_]{1,64}$ (obrigatório)
Propriedades ImageTemplateProperties
Tags Marcas de recurso Dicionário de nomes e valores de marca. Consulte Marcas em modelos
tipo O tipo de recurso 'Microsoft.VirtualMachineImages/imageTemplates'

ResourceTags

Nome Descrição Valor

Modelos de início rápido

Os modelos de início rápido a seguir implantam esse tipo de recurso.

Modelo Descrição
Construtor de Imagens do Azure com o de Linha de Base do Windows do Azure

Implantar no Azure
Cria um ambiente do Construtor de Imagens do Azure 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 de serviço do Dev Box

Implantar no Azure
Esse modelo criaria todos os recursos de administrador do Dev Box de acordo com o guia de início rápido do Dev Box (/azure/dev-box/quickstart-create-dev-box). Você pode exibir todos os recursos criados ou ir diretamente para DevPortal.microsoft.com para criar sua primeira Caixa de Desenvolvimento.

Definição de recurso do Terraform (provedor de AzAPI)

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

  • grupos de recursos

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

Formato de recurso

Para criar um recurso Microsoft.VirtualMachineImages/imageTemplates, adicione o Terraform a seguir ao modelo.

resource "azapi_resource" "symbolicname" {
  type = "Microsoft.VirtualMachineImages/imageTemplates@2018-02-01-preview"
  name = "string"
  location = "string"
  tags = {
    {customized property} = "string"
  }
  body = jsonencode({
    properties = {
      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
      }
    }
  })
}

Objetos ImageTemplateDistributor

Defina a propriedade tipo para especificar o tipo de objeto.

Para managedImage, use:

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

Para sharedImage, use:

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

Objetos ImageTemplateCustomizer

Defina a propriedade tipo para especificar o tipo de objeto.

Para shell, use:

{
  script = "string"
  type = "shell"
}

Objetos ImageTemplateSource

Defina a propriedade tipo para especificar o tipo de objeto.

Para ISO, use:

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

Para PlatformImage, use:

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

Valores de propriedade

ImageTemplateCustomizer

Nome Descrição Valor
nome Nome Amigável para fornecer contexto sobre o que essa etapa de personalização faz corda
tipo Defina como 'shell' para o tipo ImageTemplateShellCustomizer. 'shell' (obrigatório)

ImageTemplateDistributor

Nome Descrição Valor
artifactTags Marcas que serão aplicadas ao artefato depois que ele tiver sido criado/atualizado pelo distribuidor. ImageTemplateDistributorArtifactTags
runOutputName O nome a ser usado para o RunOutput associado. corda

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. 'managedImage'
'sharedImage' (obrigatório)

ImageTemplateDistributorArtifactTags

Nome Descrição Valor

ImageTemplateIsoSource

Nome Descrição Valor
sha256Checksum Soma de verificação SHA256 da imagem ISO. cadeia de caracteres (obrigatório)
sourceURI URL para obter a imagem ISO. Essa URL deve ser acessível ao provedor de recursos no momento da criação do imageTemplate. cadeia de caracteres (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 cadeia de caracteres (obrigatório)
localização O local do Azure para a imagem deve corresponder se a imagem já existir cadeia de caracteres (obrigatório)
tipo Tipo de distribuição. 'managedImage' (obrigatório)

ImageTemplatePlatformImageSource

Nome Descrição Valor
oferecer Oferta de imagem doImagens da Galeria do Azure. corda
editor Editor de Imagens no de Imagens da Galeria do Azure. corda
Sku SKU de imagem dode 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 dode Imagens da Galeria do Azure . corda

ImageTemplateProperties

Nome Descrição Valor
Personalizar Especifica as propriedades usadas para descrever as etapas de personalização da imagem, como fonte de imagem etc. ImageTemplateCustomizer []
distribuir A distribuição é direcionada para onde a saída da imagem precisa ir. ImageTemplateDistributor[] (obrigatório)
fonte Especifica as propriedades usadas para descrever a imagem de origem. ImageTemplateSource (obrigatório)

ImageTemplateSharedImageDistributor

Nome Descrição Valor
galleryImageId ID do recurso da imagem da Galeria de Imagens Compartilhadas cadeia de caracteres (obrigatório)
replicationRegions string[] (obrigatório)
tipo Tipo de distribuição. 'sharedImage' (obrigatório)

ImageTemplateShellCustomizer

Nome Descrição Valor
roteiro O script de shell a ser executado para personalização. Pode ser um link do 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 shellCustomizer 'shell' (obrigatório)

ImageTemplateSource

Nome Descrição Valor
tipo Defina como 'ISO' para o tipo ImageTemplateIsoSource. Defina como 'PlatformImage' para o tipo ImageTemplatePlatformImageSource. 'ISO'
'PlatformImage' (obrigatório)

Microsoft.VirtualMachineImages/imageTemplates

Nome Descrição Valor
localização Local do recurso cadeia de caracteres (obrigatório)
nome O nome do recurso corda

Restrições:
Padrão = ^[A-Za-z0-9-_]{1,64}$ (obrigatório)
Propriedades ImageTemplateProperties
Tags Marcas de recurso Dicionário de nomes e valores de marca.
tipo O tipo de recurso "Microsoft.VirtualMachineImages/imageTemplates@2018-02-01-preview"

ResourceTags

Nome Descrição Valor