Delen via


Microsoft.VirtualMachineImages imageTemplates 2018-02-01-preview

Bicep-resourcedefinitie

Het resourcetype imageTemplates kan worden geïmplementeerd met bewerkingen die zijn gericht op:

Zie logboek wijzigenvoor een lijst met gewijzigde eigenschappen in elke API-versie.

Resource-indeling

Als u een Resource Microsoft.VirtualMachineImages/imageTemplates wilt maken, voegt u de volgende Bicep toe aan uw sjabloon.

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

ImageTemplateDistributor-objecten

Stel de eigenschap type in om het type object op te geven.

Gebruik voor managedImage:

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

Gebruik voor sharedImage:

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

ImageTemplateCustomizer-objecten

Stel de eigenschap type in om het type object op te geven.

Gebruik voor shell:

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

ImageTemplateSource-objecten

Stel de eigenschap type in om het type object op te geven.

Gebruik voor ISO-:

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

Gebruik voor PlatformImage:

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

Eigenschapswaarden

ImageTemplateCustomizer

Naam Beschrijving Waarde
naam Beschrijvende naam om context te geven over wat deze aanpassingsstap doet snaar
type Ingesteld op 'shell' voor het type ImageTemplateShellCustomizer. 'shell' (vereist)

ImageTemplateDistributor

Naam Beschrijving Waarde
artifactTags Tags die worden toegepast op het artefact nadat het is gemaakt/bijgewerkt door de distributeur. ImageTemplateDistributorArtifactTags
runOutputName De naam die moet worden gebruikt voor de bijbehorende RunOutput. string

Beperkingen:
Patroon = ^[A-Za-z0-9-_]{1,64}$ (vereist)
type Ingesteld op managedImage voor het type ImageTemplateManagedImageDistributor. Ingesteld op sharedImage voor het type ImageTemplateSharedImageDistributor. ManagedImage
SharedImage (vereist)

ImageTemplateDistributorArtifactTags

Naam Beschrijving Waarde

ImageTemplateIsoSource

Naam Beschrijving Waarde
sha256Checksum SHA256 Controlesom van de ISO-installatiekopieën. tekenreeks (vereist)
sourceURI URL voor het ophalen van de ISO-installatiekopieën. Deze URL moet toegankelijk zijn voor de resourceprovider op het moment dat de imageTemplate is gemaakt. tekenreeks (vereist)
type Hiermee geeft u het type broninstallatiekopie waarmee u wilt beginnen. 'ISO' (vereist)

ImageTemplateManagedImageDistributor

Naam Beschrijving Waarde
imageId Resource-id van de installatiekopieën van de beheerde schijf tekenreeks (vereist)
plaats Azure-locatie voor de installatiekopieën moet overeenkomen als de installatiekopieën al bestaan tekenreeks (vereist)
type Type distributie. ManagedImage (vereist)

ImageTemplatePlatformImageSource

Naam Beschrijving Waarde
aanbieden Afbeeldingsaanbieding uit de Azure Gallery Images. snaar
uitgever Image Publisher in Azure Gallery Images. snaar
Sku Afbeeldingsku uit de Azure Gallery-installatiekopieën. snaar
type Hiermee geeft u het type broninstallatiekopie waarmee u wilt beginnen. PlatformImage (vereist)
Versie Installatiekopieën van de Azure Gallery-installatiekopieën. snaar

ImageTemplateProperties

Naam Beschrijving Waarde
Aanpassen Hiermee geeft u de eigenschappen die worden gebruikt voor het beschrijven van de aanpassingsstappen van de afbeelding, zoals afbeeldingsbron, enzovoort ImageTemplateCustomizer[]
uitdelen De distributiedoelen waar de uitvoer van de installatiekopieën naartoe moet gaan. ImageTemplateDistributor[] (vereist)
bron Hiermee geeft u de eigenschappen op die worden gebruikt om de broninstallatiekopieën te beschrijven. ImageTemplateSource (vereist)

ImageTemplateSharedImageDistributor

Naam Beschrijving Waarde
galleryImageId Resource-id van de installatiekopieëngalerie met gedeelde installatiekopieën tekenreeks (vereist)
replicationRegions tekenreeks[] (vereist)
type Type distributie. SharedImage (vereist)

ImageTemplateShellCustomizer

Naam Beschrijving Waarde
script Het shell-script dat moet worden uitgevoerd voor het aanpassen. Het kan een github-koppeling, SAS-URI voor Azure Storage, enzovoort zijn snaar
type Het type aanpassingsprogramma dat u wilt gebruiken op de afbeelding. 'shell' kan bijvoorbeeld shellCustomizer zijn 'shell' (vereist)

ImageTemplateSource

Naam Beschrijving Waarde
type Ingesteld op ISO voor type ImageTemplateIsoSource. Ingesteld op PlatformImage voor het type ImageTemplatePlatformImageSource. 'ISO'
PlatformImage (vereist)

Microsoft.VirtualMachineImages/imageTemplates

Naam Beschrijving Waarde
plaats Resourcelocatie tekenreeks (vereist)
naam De resourcenaam string

Beperkingen:
Patroon = ^[A-Za-z0-9-_]{1,64}$ (vereist)
Eigenschappen ImageTemplateProperties-
Tags Resourcetags Woordenlijst met tagnamen en -waarden. Zie Tags in sjablonen

ResourceTags

Naam Beschrijving Waarde

Quickstart-voorbeelden

In de volgende quickstartvoorbeelden wordt dit resourcetype geïmplementeerd.

Bicep-bestand Beschrijving
Azure Image Builder met Azure Windows Baseline Hiermee maakt u een Azure Image Builder-omgeving en bouwt u een Windows Server-installatiekopieën waarop de nieuwste Windows-updates en Azure Windows Baseline zijn toegepast.
Dev Box-service configureren Met deze sjabloon worden alle Dev Box-beheerbronnen gemaakt volgens de Quick Start-handleiding voor Dev Box (/azure/dev-box/quickstart-create-dev-box). U kunt alle gemaakte resources bekijken of rechtstreeks naar DevPortal.microsoft.com gaan om uw eerste Dev Box te maken.

Resourcedefinitie van ARM-sjabloon

Het resourcetype imageTemplates kan worden geïmplementeerd met bewerkingen die zijn gericht op:

Zie logboek wijzigenvoor een lijst met gewijzigde eigenschappen in elke API-versie.

Resource-indeling

Als u een Microsoft.VirtualMachineImages/imageTemplates-resource wilt maken, voegt u de volgende JSON toe aan uw sjabloon.

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

ImageTemplateDistributor-objecten

Stel de eigenschap type in om het type object op te geven.

Gebruik voor managedImage:

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

Gebruik voor sharedImage:

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

ImageTemplateCustomizer-objecten

Stel de eigenschap type in om het type object op te geven.

Gebruik voor shell:

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

ImageTemplateSource-objecten

Stel de eigenschap type in om het type object op te geven.

Gebruik voor ISO-:

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

Gebruik voor PlatformImage:

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

Eigenschapswaarden

ImageTemplateCustomizer

Naam Beschrijving Waarde
naam Beschrijvende naam om context te geven over wat deze aanpassingsstap doet snaar
type Ingesteld op 'shell' voor het type ImageTemplateShellCustomizer. 'shell' (vereist)

ImageTemplateDistributor

Naam Beschrijving Waarde
artifactTags Tags die worden toegepast op het artefact nadat het is gemaakt/bijgewerkt door de distributeur. ImageTemplateDistributorArtifactTags
runOutputName De naam die moet worden gebruikt voor de bijbehorende RunOutput. string

Beperkingen:
Patroon = ^[A-Za-z0-9-_]{1,64}$ (vereist)
type Ingesteld op managedImage voor het type ImageTemplateManagedImageDistributor. Ingesteld op sharedImage voor het type ImageTemplateSharedImageDistributor. ManagedImage
SharedImage (vereist)

ImageTemplateDistributorArtifactTags

Naam Beschrijving Waarde

ImageTemplateIsoSource

Naam Beschrijving Waarde
sha256Checksum SHA256 Controlesom van de ISO-installatiekopieën. tekenreeks (vereist)
sourceURI URL voor het ophalen van de ISO-installatiekopieën. Deze URL moet toegankelijk zijn voor de resourceprovider op het moment dat de imageTemplate is gemaakt. tekenreeks (vereist)
type Hiermee geeft u het type broninstallatiekopie waarmee u wilt beginnen. 'ISO' (vereist)

ImageTemplateManagedImageDistributor

Naam Beschrijving Waarde
imageId Resource-id van de installatiekopieën van de beheerde schijf tekenreeks (vereist)
plaats Azure-locatie voor de installatiekopieën moet overeenkomen als de installatiekopieën al bestaan tekenreeks (vereist)
type Type distributie. ManagedImage (vereist)

ImageTemplatePlatformImageSource

Naam Beschrijving Waarde
aanbieden Afbeeldingsaanbieding uit de Azure Gallery Images. snaar
uitgever Image Publisher in Azure Gallery Images. snaar
Sku Afbeeldingsku uit de Azure Gallery-installatiekopieën. snaar
type Hiermee geeft u het type broninstallatiekopie waarmee u wilt beginnen. PlatformImage (vereist)
Versie Installatiekopieën van de Azure Gallery-installatiekopieën. snaar

ImageTemplateProperties

Naam Beschrijving Waarde
Aanpassen Hiermee geeft u de eigenschappen die worden gebruikt voor het beschrijven van de aanpassingsstappen van de afbeelding, zoals afbeeldingsbron, enzovoort ImageTemplateCustomizer[]
uitdelen De distributiedoelen waar de uitvoer van de installatiekopieën naartoe moet gaan. ImageTemplateDistributor[] (vereist)
bron Hiermee geeft u de eigenschappen op die worden gebruikt om de broninstallatiekopieën te beschrijven. ImageTemplateSource (vereist)

ImageTemplateSharedImageDistributor

Naam Beschrijving Waarde
galleryImageId Resource-id van de installatiekopieëngalerie met gedeelde installatiekopieën tekenreeks (vereist)
replicationRegions tekenreeks[] (vereist)
type Type distributie. SharedImage (vereist)

ImageTemplateShellCustomizer

Naam Beschrijving Waarde
script Het shell-script dat moet worden uitgevoerd voor het aanpassen. Het kan een github-koppeling, SAS-URI voor Azure Storage, enzovoort zijn snaar
type Het type aanpassingsprogramma dat u wilt gebruiken op de afbeelding. 'shell' kan bijvoorbeeld shellCustomizer zijn 'shell' (vereist)

ImageTemplateSource

Naam Beschrijving Waarde
type Ingesteld op ISO voor type ImageTemplateIsoSource. Ingesteld op PlatformImage voor het type ImageTemplatePlatformImageSource. 'ISO'
PlatformImage (vereist)

Microsoft.VirtualMachineImages/imageTemplates

Naam Beschrijving Waarde
apiVersion De API-versie '2018-02-01-preview'
plaats Resourcelocatie tekenreeks (vereist)
naam De resourcenaam string

Beperkingen:
Patroon = ^[A-Za-z0-9-_]{1,64}$ (vereist)
Eigenschappen ImageTemplateProperties-
Tags Resourcetags Woordenlijst met tagnamen en -waarden. Zie Tags in sjablonen
type Het resourcetype 'Microsoft.VirtualMachineImages/imageTemplates'

ResourceTags

Naam Beschrijving Waarde

Quickstart-sjablonen

Met de volgende quickstart-sjablonen wordt dit resourcetype geïmplementeerd.

Sjabloon Beschrijving
Azure Image Builder met Azure Windows Baseline

implementeren in Azure
Hiermee maakt u een Azure Image Builder-omgeving en bouwt u een Windows Server-installatiekopieën waarop de nieuwste Windows-updates en Azure Windows Baseline zijn toegepast.
Dev Box-service configureren

implementeren in Azure
Met deze sjabloon worden alle Dev Box-beheerbronnen gemaakt volgens de Quick Start-handleiding voor Dev Box (/azure/dev-box/quickstart-create-dev-box). U kunt alle gemaakte resources bekijken of rechtstreeks naar DevPortal.microsoft.com gaan om uw eerste Dev Box te maken.

Resourcedefinitie van Terraform (AzAPI-provider)

Het resourcetype imageTemplates kan worden geïmplementeerd met bewerkingen die zijn gericht op:

  • resourcegroepen

Zie logboek wijzigenvoor een lijst met gewijzigde eigenschappen in elke API-versie.

Resource-indeling

Als u een Microsoft.VirtualMachineImages/imageTemplates-resource wilt maken, voegt u de volgende Terraform toe aan uw sjabloon.

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

ImageTemplateDistributor-objecten

Stel de eigenschap type in om het type object op te geven.

Gebruik voor managedImage:

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

Gebruik voor sharedImage:

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

ImageTemplateCustomizer-objecten

Stel de eigenschap type in om het type object op te geven.

Gebruik voor shell:

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

ImageTemplateSource-objecten

Stel de eigenschap type in om het type object op te geven.

Gebruik voor ISO-:

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

Gebruik voor PlatformImage:

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

Eigenschapswaarden

ImageTemplateCustomizer

Naam Beschrijving Waarde
naam Beschrijvende naam om context te geven over wat deze aanpassingsstap doet snaar
type Ingesteld op 'shell' voor het type ImageTemplateShellCustomizer. 'shell' (vereist)

ImageTemplateDistributor

Naam Beschrijving Waarde
artifactTags Tags die worden toegepast op het artefact nadat het is gemaakt/bijgewerkt door de distributeur. ImageTemplateDistributorArtifactTags
runOutputName De naam die moet worden gebruikt voor de bijbehorende RunOutput. string

Beperkingen:
Patroon = ^[A-Za-z0-9-_]{1,64}$ (vereist)
type Ingesteld op managedImage voor het type ImageTemplateManagedImageDistributor. Ingesteld op sharedImage voor het type ImageTemplateSharedImageDistributor. ManagedImage
SharedImage (vereist)

ImageTemplateDistributorArtifactTags

Naam Beschrijving Waarde

ImageTemplateIsoSource

Naam Beschrijving Waarde
sha256Checksum SHA256 Controlesom van de ISO-installatiekopieën. tekenreeks (vereist)
sourceURI URL voor het ophalen van de ISO-installatiekopieën. Deze URL moet toegankelijk zijn voor de resourceprovider op het moment dat de imageTemplate is gemaakt. tekenreeks (vereist)
type Hiermee geeft u het type broninstallatiekopie waarmee u wilt beginnen. 'ISO' (vereist)

ImageTemplateManagedImageDistributor

Naam Beschrijving Waarde
imageId Resource-id van de installatiekopieën van de beheerde schijf tekenreeks (vereist)
plaats Azure-locatie voor de installatiekopieën moet overeenkomen als de installatiekopieën al bestaan tekenreeks (vereist)
type Type distributie. ManagedImage (vereist)

ImageTemplatePlatformImageSource

Naam Beschrijving Waarde
aanbieden Afbeeldingsaanbieding uit de Azure Gallery Images. snaar
uitgever Image Publisher in Azure Gallery Images. snaar
Sku Afbeeldingsku uit de Azure Gallery-installatiekopieën. snaar
type Hiermee geeft u het type broninstallatiekopie waarmee u wilt beginnen. PlatformImage (vereist)
Versie Installatiekopieën van de Azure Gallery-installatiekopieën. snaar

ImageTemplateProperties

Naam Beschrijving Waarde
Aanpassen Hiermee geeft u de eigenschappen die worden gebruikt voor het beschrijven van de aanpassingsstappen van de afbeelding, zoals afbeeldingsbron, enzovoort ImageTemplateCustomizer[]
uitdelen De distributiedoelen waar de uitvoer van de installatiekopieën naartoe moet gaan. ImageTemplateDistributor[] (vereist)
bron Hiermee geeft u de eigenschappen op die worden gebruikt om de broninstallatiekopieën te beschrijven. ImageTemplateSource (vereist)

ImageTemplateSharedImageDistributor

Naam Beschrijving Waarde
galleryImageId Resource-id van de installatiekopieëngalerie met gedeelde installatiekopieën tekenreeks (vereist)
replicationRegions tekenreeks[] (vereist)
type Type distributie. SharedImage (vereist)

ImageTemplateShellCustomizer

Naam Beschrijving Waarde
script Het shell-script dat moet worden uitgevoerd voor het aanpassen. Het kan een github-koppeling, SAS-URI voor Azure Storage, enzovoort zijn snaar
type Het type aanpassingsprogramma dat u wilt gebruiken op de afbeelding. 'shell' kan bijvoorbeeld shellCustomizer zijn 'shell' (vereist)

ImageTemplateSource

Naam Beschrijving Waarde
type Ingesteld op ISO voor type ImageTemplateIsoSource. Ingesteld op PlatformImage voor het type ImageTemplatePlatformImageSource. 'ISO'
PlatformImage (vereist)

Microsoft.VirtualMachineImages/imageTemplates

Naam Beschrijving Waarde
plaats Resourcelocatie tekenreeks (vereist)
naam De resourcenaam string

Beperkingen:
Patroon = ^[A-Za-z0-9-_]{1,64}$ (vereist)
Eigenschappen ImageTemplateProperties-
Tags Resourcetags Woordenlijst met tagnamen en -waarden.
type Het resourcetype "Microsoft.VirtualMachineImages/imageTemplates@2018-02-01-preview"

ResourceTags

Naam Beschrijving Waarde