Microsoft.VirtualMachineImages imageTemplates 2019-02-01-preview

Artigo
12/17/2024

Definição de recursos do bíceps

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

Grupos de recursos - Consulte comandos de implantação de grupo 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 Bíceps ao seu modelo.

resource symbolicname 'Microsoft.VirtualMachineImages/imageTemplates@2019-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 ImageTemplateCustomizer

Defina a propriedade type para especificar o tipo de objeto.

Para PowerShell, use:

{
  inline: [
    'string'
  ]
  script: 'string'
  type: 'PowerShell'
  validExitCodes: [
    int
  ]
}

Para Shell, use:

{
  inline: [
    'string'
  ]
  script: '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'
}

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'
}

Valores de propriedade

ImageTemplateCustomizer

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

ImageTemplateDistribuidor

Designação	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.	string 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

Designação	Descrição	Valor

ImageTemplateIsoSource

Designação	Descrição	Valor
sha256Soma de verificação	SHA256 Soma de verificação da imagem ISO.	string (obrigatório)
sourceURI	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

Designação	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

Designação	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

Designação	Descrição	Valor
oferta	Oferta de imagem do Azure Gallery Images.	string
editora	Image Publisher no Azure Gallery Images.	string
SKU	Documento de imagem do Azure Gallery Images.	string
tipo	Especifica o tipo de imagem de origem com a qual você deseja começar.	'PlatformImage' (obrigatório)
Versão	Versão da imagem do Azure Gallery Images.	string

ImageTemplatePowerShellCustomizer

Designação	Descrição	Valor
em linha	Matriz de comandos do PowerShell para executar	string[]
guião	O script do PowerShell a ser executado para personalização. Pode ser um link github, URI SAS para Armazenamento do Azure, etc	string
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

Designação	Descrição	Valor
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)

ImageTemplateRestartCustomizer

Designação	Descrição	Valor
restartCheckCommand	Comando para verificar se a reinicialização foi bem-sucedida [Padrão: '']	string
restartCommand	Comando para executar a reinicialização [Padrão: 'shutdown /r /f /t 0 /c "packer restart"']	string
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']	string
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

Designação	Descrição	Valor
galeriaImageId	ID do recurso da imagem da Galeria de Imagens Partilhadas	string (obrigatório)
replicaçãoRegiões		string[] (obrigatório)
tipo	Tipo de distribuição.	'SharedImage' (obrigatório)

ImageTemplateShellCustomizer

Designação	Descrição	Valor
em linha	Matriz de comandos do shell para executar	string[]
guião	O shell script a ser executado para personalização. Pode ser um link github, URI SAS para Armazenamento do Azure, etc	string
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

Designação	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.	«ISO» 'ManagedImage' 'PlatformImage' (obrigatório)

ImageTemplateVhdDistribuidor

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