Condividi tramite


Microsoft.VirtualMachineImages imageTemplates 2018-02-01-preview

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

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

Oggetti ImageTemplateCustomizer

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

Per shell, usare:

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

Oggetti ImageTemplateSource

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

Per ISO, usare:

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

Per PlatformImage, usare:

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

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 "shell" per il tipo ImageTemplateShellCustomizer. 'shell' (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. 'managedImage'
'sharedImage' (obbligatorio)

ImageTemplateDistributorArtifactTags

Nome Descrizione Valore

ImageTemplateIsoSource

Nome Descrizione Valore
sha256Checksum Checksum SHA256 dell'immagine ISO. stringa (obbligatorio)
sourceURI URL per ottenere l'immagine ISO. Questo URL deve essere accessibile al provider di risorse al momento della creazione di imageTemplate. 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)

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

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)

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
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 shellCustomizer 'shell' (obbligatorio)

ImageTemplateSource

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

Microsoft.VirtualMachineImages/imageTemplates

Nome Descrizione Valore
ubicazione Percorso risorsa stringa (obbligatorio)
nome Nome della risorsa corda

Vincoli:
Pattern = ^[A-Za-z0-9-_]{1,64}$ (obbligatorio)
proprietà ImageTemplateProperties
Tag Tag delle risorse Dizionario di nomi e valori di tag. Vedere tag nei modelli

ResourceTags

Nome Descrizione Valore

Esempi di avvio rapido

Gli esempi di avvio rapido seguenti distribuiscono questo tipo di risorsa.

Bicep File Descrizione
Generatore immagini di Azure con baseline di Windows di Azure Crea un ambiente di Image Builder di Azure e compila un'immagine di Windows Server con gli aggiornamenti di Windows più recenti e la baseline di Windows di Azure applicata.
Configurare il servizio Dev Box Questo modello crea tutte le risorse di amministrazione di Dev Box in base alla guida introduttiva di Dev Box (/azure/dev-box/quickstart-create-dev-box). È possibile visualizzare tutte le risorse create oppure passare direttamente a DevPortal.microsoft.com per creare il primo Dev Box.

Definizione di risorsa del modello di Resource Manager

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 codice JSON seguente al modello.

{
  "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"
  }
}

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

Oggetti ImageTemplateCustomizer

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

Per shell, usare:

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

Oggetti ImageTemplateSource

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

Per ISO, usare:

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

Per PlatformImage, usare:

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

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 "shell" per il tipo ImageTemplateShellCustomizer. 'shell' (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. 'managedImage'
'sharedImage' (obbligatorio)

ImageTemplateDistributorArtifactTags

Nome Descrizione Valore

ImageTemplateIsoSource

Nome Descrizione Valore
sha256Checksum Checksum SHA256 dell'immagine ISO. stringa (obbligatorio)
sourceURI URL per ottenere l'immagine ISO. Questo URL deve essere accessibile al provider di risorse al momento della creazione di imageTemplate. 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)

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

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)

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
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 shellCustomizer 'shell' (obbligatorio)

ImageTemplateSource

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

Microsoft.VirtualMachineImages/imageTemplates

Nome Descrizione Valore
apiVersion Versione dell'API '2018-02-01-preview'
ubicazione Percorso risorsa stringa (obbligatorio)
nome Nome della risorsa corda

Vincoli:
Pattern = ^[A-Za-z0-9-_]{1,64}$ (obbligatorio)
proprietà ImageTemplateProperties
Tag Tag delle risorse Dizionario di nomi e valori di tag. Vedere tag nei modelli
digitare Tipo di risorsa 'Microsoft.VirtualMachineImages/imageTemplates'

ResourceTags

Nome Descrizione Valore

Modelli di avvio rapido

I modelli di avvio rapido seguenti distribuiscono questo tipo di risorsa.

Sagoma Descrizione
Generatore immagini di Azure con baseline di Windows di Azure

Distribuire in Azure
Crea un ambiente di Image Builder di Azure e compila un'immagine di Windows Server con gli aggiornamenti di Windows più recenti e la baseline di Windows di Azure applicata.
Configurare il servizio Dev Box

Distribuire in Azure
Questo modello crea tutte le risorse di amministrazione di Dev Box in base alla guida introduttiva di Dev Box (/azure/dev-box/quickstart-create-dev-box). È possibile visualizzare tutte le risorse create oppure passare direttamente a DevPortal.microsoft.com per creare il primo Dev Box.

Definizione di risorsa Terraform (provider AzAPI)

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

  • gruppi 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 codice Terraform seguente al modello.

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

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

Oggetti ImageTemplateCustomizer

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

Per shell, usare:

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

Oggetti ImageTemplateSource

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

Per ISO, usare:

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

Per PlatformImage, usare:

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

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 "shell" per il tipo ImageTemplateShellCustomizer. 'shell' (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. 'managedImage'
'sharedImage' (obbligatorio)

ImageTemplateDistributorArtifactTags

Nome Descrizione Valore

ImageTemplateIsoSource

Nome Descrizione Valore
sha256Checksum Checksum SHA256 dell'immagine ISO. stringa (obbligatorio)
sourceURI URL per ottenere l'immagine ISO. Questo URL deve essere accessibile al provider di risorse al momento della creazione di imageTemplate. 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)

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

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)

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
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 shellCustomizer 'shell' (obbligatorio)

ImageTemplateSource

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

Microsoft.VirtualMachineImages/imageTemplates

Nome Descrizione Valore
ubicazione Percorso risorsa stringa (obbligatorio)
nome Nome della risorsa corda

Vincoli:
Pattern = ^[A-Za-z0-9-_]{1,64}$ (obbligatorio)
proprietà ImageTemplateProperties
Tag Tag delle risorse Dizionario di nomi e valori di tag.
digitare Tipo di risorsa "Microsoft.VirtualMachineImages/imageTemplates@2018-02-01-preview"

ResourceTags

Nome Descrizione Valore