Microsoft.VirtualMachineImages imageTemplates 2019-02-01-preview

Articolo
12/16/2024

Definizione di risorsa Bicep

Il tipo di risorsa imageTemplates può essere distribuito con operazioni destinate a:

gruppi di risorse - Vedere i comandi di distribuzione del gruppo di risorse

Per un elenco delle proprietà modificate in ogni versione dell'API, vedere log delle modifiche.

Formato risorsa

Per creare una risorsa Microsoft.VirtualMachineImages/imageTemplates, aggiungere il bicep seguente al modello.

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

Oggetti ImageTemplateCustomizer

Impostare la proprietà tipo di per specificare il tipo di oggetto.

Per PowerShell, usare:

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

Per Shell, usare:

{
  inline: [
    'string'
  ]
  script: 'string'
  type: 'Shell'
}

Per WindowsRestart, usare:

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

Oggetti ImageTemplateSource

Impostare la proprietà tipo di per specificare il tipo di oggetto.

Per ISO, usare:

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

Per ManagedImage, usare:

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

Per PlatformImage, usare:

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

Oggetti ImageTemplateDistributor

Impostare la proprietà tipo di per specificare il tipo di oggetto.

Per ManagedImage, usare:

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

Per SharedImage, usare:

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

Per VHD, usare:

{
  type: 'VHD'
}

Valori delle proprietà

ImageTemplateCustomizer

Nome	Descrizione	Valore
nome	Nome descrittivo per fornire contesto sulle operazioni eseguite da questo passaggio di personalizzazione	corda
digitare	Impostare su "PowerShell" per il tipo ImageTemplatePowerShellCustomizer. Impostare su "Shell" per il tipo ImageTemplateShellCustomizer. Impostare su "WindowsRestart" per il tipo ImageTemplateRestartCustomizer.	'PowerShell' 'Shell' 'WindowsRestart' (obbligatorio)

ImageTemplateDistributor

Nome	Descrizione	Valore
artifactTags	Tag che verranno applicati all'artefatto dopo che è stato creato/aggiornato dal server di distribuzione.	ImageTemplateDistributorArtifactTags
runOutputName	Nome da utilizzare per l'oggetto RunOutput associato.	corda Vincoli: Pattern = `^[A-Za-z0-9-_]{1,64}$` (obbligatorio)
digitare	Impostare su 'ManagedImage' per il tipo ImageTemplateManagedImageDistributor. Impostare su 'SharedImage' per il tipo ImageTemplateSharedImageDistributor. Impostare su "VHD" per il tipo ImageTemplateVhdDistributor.	'ManagedImage' 'SharedImage' 'VHD' (obbligatorio)

ImageTemplateDistributorArtifactTags

Nome	Descrizione	Valore

ImageTemplateIsoSource

Nome	Descrizione	Valore
sha256Checksum	Checksum SHA256 dell'immagine ISO.	stringa (obbligatorio)
sourceURI	URI per ottenere l'immagine ISO. Questo URI deve essere accessibile al provider di risorse al momento della creazione del modello di immagine.	stringa (obbligatorio)
digitare	Specifica il tipo di immagine di origine da cui iniziare.	'ISO' (obbligatorio)

ImageTemplateManagedImageDistributor

Nome	Descrizione	Valore
imageId	ID risorsa dell'immagine del disco gestito	stringa (obbligatorio)
ubicazione	La posizione di Azure per l'immagine deve corrispondere se l'immagine esiste già	stringa (obbligatorio)
digitare	Tipo di distribuzione.	'ManagedImage' (obbligatorio)

ImageTemplateManagedImageSource

Nome	Descrizione	Valore
imageId	ID risorsa ARM dell'immagine gestita nella sottoscrizione del cliente	stringa (obbligatorio)
digitare	Specifica il tipo di immagine di origine da cui iniziare.	'ManagedImage' (obbligatorio)

ImageTemplatePlatformImageSource

Nome	Descrizione	Valore
offerta	Offerta di immagine dalla immagini della raccolta di Azure.	corda
editore	Image Publisher in Azure Gallery Images.	corda
Sku	Sku dell'immagine dall'immagini della raccolta di Azure.	corda
digitare	Specifica il tipo di immagine di origine da cui iniziare.	'PlatformImage' (obbligatorio)
Versione	Versione dell'immagine dalla immagini della raccolta di Azure.	corda

ImageTemplatePowerShellCustomizer

Nome	Descrizione	Valore
Inline	Matrice di comandi di PowerShell da eseguire	string[]
copione	Script di PowerShell da eseguire per la personalizzazione. Può essere un collegamento github, un URI di firma di accesso condiviso per Archiviazione di Azure e così via	corda
digitare	Tipo di strumento di personalizzazione da usare nell'immagine. Ad esempio, "Shell" può essere un addetto alla personalizzazione della shell	'PowerShell' (obbligatorio)
validExitCodes	Codici di uscita validi per lo script di PowerShell. [Impostazione predefinita: 0]	int[]

ImageTemplateProperties

Nome	Descrizione	Valore
Personalizza	Specifica le proprietà usate per descrivere i passaggi di personalizzazione dell'immagine, ad esempio Origine immagine e così via	ImageTemplateCustomizer[]
distribuire	Le destinazioni di distribuzione in cui l'output dell'immagine deve passare.	ImageTemplateDistributor[] (obbligatorio)
fonte	Specifica le proprietà utilizzate per descrivere l'immagine di origine.	ImageTemplateSource (obbligatorio)

ImageTemplateRestartCustomizer

Nome	Descrizione	Valore
restartCheckCommand	Comando per verificare se il riavvio è riuscito [Impostazione predefinita: '']	corda
restartCommand	Comando per eseguire il riavvio [Impostazione predefinita: 'shutdown /r /f /t 0 /c "packer restart"']	corda
restartTimeout	Timeout di riavvio specificato come stringa di grandezza e unità, ad esempio '5m' (5 minuti) o '2h' (2 ore) [Impostazione predefinita: '5m']	corda
digitare	Tipo di strumento di personalizzazione da usare nell'immagine. Ad esempio, "Shell" può essere un addetto alla personalizzazione della shell	'WindowsRestart' (obbligatorio)

ImageTemplateSharedImageDistributor

Nome	Descrizione	Valore
galleryImageId	ID risorsa dell'immagine raccolta immagini condivise	stringa (obbligatorio)
replicationRegions		string[] (obbligatorio)
digitare	Tipo di distribuzione.	'SharedImage' (obbligatorio)

ImageTemplateShellCustomizer

Nome	Descrizione	Valore
Inline	Matrice di comandi della shell da eseguire	string[]
copione	Script della shell da eseguire per la personalizzazione. Può essere un collegamento github, un URI di firma di accesso condiviso per Archiviazione di Azure e così via	corda
digitare	Tipo di strumento di personalizzazione da usare nell'immagine. Ad esempio, "Shell" può essere un addetto alla personalizzazione della shell	'Shell' (obbligatorio)

ImageTemplateSource

Nome	Descrizione	Valore
digitare	Impostare su "ISO" per il tipo ImageTemplateIsoSource. Impostare su 'ManagedImage' per il tipo ImageTemplateManagedImageSource. Impostare su 'PlatformImage' per il tipo ImageTemplatePlatformImageSource.	'ISO' 'ManagedImage' 'PlatformImage' (obbligatorio)

ImageTemplateVhdDistributor

Nome	Descrizione	Valore
digitare	Tipo di distribuzione.	'VHD' (obbligatorio)