Microsoft.VirtualMachineImages imageTemplates

• meest recente
• 2024-02-01
• 2023-07-01
• 2022-07-01
• 2022-02-14
• 2021-10-01
• 2020-02-14
• 2019-05-01-preview-
• 2019-02-01-preview-
• 2018-02-01-preview-

Bicep-resourcedefinitie

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

• Resourcegroepen - Zie opdrachten voor de implementatie van resourcegroepen

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@2024-02-01' = {
  name: 'string'
  location: 'string'
  tags: {
    tagName1: 'tagValue1'
    tagName2: 'tagValue2'
  }
  identity: {
    type: 'string'
    userAssignedIdentities: {
      {customized property}: {}
    }
  }
  properties: {
    autoRun: {
      state: 'string'
    }
    buildTimeoutInMinutes: int
    customize: [
      {
        name: 'string'
        type: 'string'
        // For remaining properties, see ImageTemplateCustomizer objects
      }
    ]
    distribute: [
      {
        artifactTags: {}
        runOutputName: 'string'
        type: 'string'
        // For remaining properties, see ImageTemplateDistributor objects
      }
    ]
    errorHandling: {
      onCustomizerError: 'string'
      onValidationError: 'string'
    }
    managedResourceTags: {}
    optimize: {
      vmBoot: {
        state: 'string'
      }
    }
    source: {
      type: 'string'
      // For remaining properties, see ImageTemplateSource objects
    }
    stagingResourceGroup: 'string'
    validate: {
      continueDistributeOnFailure: bool
      inVMValidations: [
        {
          name: 'string'
          type: 'string'
          // For remaining properties, see ImageTemplateInVMValidator objects
        }
      ]
      sourceValidationOnly: bool
    }
    vmProfile: {
      osDiskSizeGB: int
      userAssignedIdentities: [
        'string'
      ]
      vmSize: 'string'
      vnetConfig: {
        containerInstanceSubnetId: 'string'
        proxyVmSize: 'string'
        subnetId: 'string'
      }
    }
  }
}

ImageTemplateCustomizer-objecten

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

Gebruik voor Bestand:

  type: 'File'
  destination: 'string'
  sha256Checksum: 'string'
  sourceUri: 'string'

Gebruik voor PowerShell-:

  type: 'PowerShell'
  inline: [
    'string'
  ]
  runAsSystem: bool
  runElevated: bool
  scriptUri: 'string'
  sha256Checksum: 'string'
  validExitCodes: [
    int
  ]

Gebruik voor Shell-:

  type: 'Shell'
  inline: [
    'string'
  ]
  scriptUri: 'string'
  sha256Checksum: 'string'

Gebruik voor WindowsRestart:

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

Gebruik voor WindowsUpdate-:

  type: 'WindowsUpdate'
  filters: [
    'string'
  ]
  searchCriteria: 'string'
  updateLimit: int

ImageTemplateDistributor-objecten

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

Gebruik voor ManagedImage:

  type: 'ManagedImage'
  imageId: 'string'
  location: 'string'

Gebruik voor SharedImage:

  type: 'SharedImage'
  excludeFromLatest: bool
  galleryImageId: 'string'
  replicationRegions: [
    'string'
  ]
  storageAccountType: 'string'
  targetRegions: [
    {
      name: 'string'
      replicaCount: int
      storageAccountType: 'string'
    }
  ]
  versioning: {
    scheme: 'string'
    // For remaining properties, see DistributeVersioner objects
  }

Gebruik voor VHD-:

  type: 'VHD'
  uri: 'string'

DistributeVersioner-objecten

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

Gebruik voor Meest recente:

  scheme: 'Latest'
  major: int

Gebruik voor bron:

  scheme: 'Source'

ImageTemplateSource-objecten

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

Gebruik voor ManagedImage:

  type: 'ManagedImage'
  imageId: 'string'

Gebruik voor PlatformImage:

  type: 'PlatformImage'
  offer: 'string'
  planInfo: {
    planName: 'string'
    planProduct: 'string'
    planPublisher: 'string'
  }
  publisher: 'string'
  sku: 'string'
  version: 'string'

Gebruik voor SharedImageVersion:

  type: 'SharedImageVersion'
  imageVersionId: 'string'

ImageTemplateInVMValidator-objecten

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

Gebruik voor Bestand:

  type: 'File'
  destination: 'string'
  sha256Checksum: 'string'
  sourceUri: 'string'

Gebruik voor PowerShell-:

  type: 'PowerShell'
  inline: [
    'string'
  ]
  runAsSystem: bool
  runElevated: bool
  scriptUri: 'string'
  sha256Checksum: 'string'
  validExitCodes: [
    int
  ]

Gebruik voor Shell-:

  type: 'Shell'
  inline: [
    'string'
  ]
  scriptUri: 'string'
  sha256Checksum: 'string'

Eigenschapswaarden

imageTemplates

Naam	Beschrijving	Waarde
naam	De resourcenaam	tekenreeks (vereist)
plaats	De geografische locatie waar de resource zich bevindt	tekenreeks (vereist)
Tags	Resourcetags.	Woordenlijst met tagnamen en -waarden. Zie Tags in sjablonen
identiteit	De identiteit van de afbeeldingssjabloon, indien geconfigureerd.	ImageTemplateIdentity (vereist)
Eigenschappen	De eigenschappen van de afbeeldingssjabloon	ImageTemplateProperties-

ImageTemplateIdentity

Naam	Beschrijving	Waarde
type	Het type identiteit dat wordt gebruikt voor de afbeeldingssjabloon. Met het type None worden alle identiteiten uit de afbeeldingssjabloon verwijderd.	'Geen' UserAssigned
userAssignedIdentities	De set door de gebruiker toegewezen identiteiten die aan de resource zijn gekoppeld. De woordenlijstsleutels userAssignedIdentities zijn ARM-resource-id's in de vorm: /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ManagedIdentity/userAssignedIdentities/{identityName}. De waarden van de woordenlijst kunnen lege objecten ({}) zijn in aanvragen.	UserAssignedId-entiteiten

UserAssignedIdentities

Naam	Beschrijving	Waarde
{aangepaste eigenschap}		UserAssignedIdentity-

UserAssignedIdentity

Dit object bevat geen eigenschappen die tijdens de implementatie moeten worden ingesteld. Alle eigenschappen zijn ReadOnly.

ImageTemplateProperties

Naam	Beschrijving	Waarde
autoRun	Hiermee wordt aangegeven of de installatiekopiesjabloon automatisch moet worden uitgevoerd bij het maken of bijwerken van een sjabloon.	ImageTemplateAutoRun
buildTimeoutInMinutes	Maximale duur om te wachten tijdens het bouwen van de afbeeldingssjabloon (inclusief alle aanpassingen, optimalisatie, validaties en distributies). Laat 0 weg of geef 0 op om de standaardwaarde (4 uur) te gebruiken.	Int Beperkingen: Minimumwaarde = 0 Maximumwaarde = 960
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)
errorHandling	Opties voor foutafhandeling bij een buildfout	ImageTemplatePropertiesErrorHandling
managedResourceTags	Tags die worden toegepast op de resourcegroep en/of resources die door de service zijn gemaakt.	object
optimaliseren	Hiermee geeft u optimalisatie moet worden uitgevoerd op de afbeelding.	ImageTemplatePropertiesOptimize
bron	Hiermee geeft u de eigenschappen op die worden gebruikt om de broninstallatiekopieën te beschrijven.	ImageTemplateSource (vereist)
stagingResourceGroup	De id van de faseringsresourcegroep in hetzelfde abonnement als de installatiekopieënsjabloon die wordt gebruikt om de installatiekopieën te bouwen. Als dit veld leeg is, wordt er een resourcegroep met een willekeurige naam gemaakt. Als de resourcegroep die in dit veld is opgegeven niet bestaat, wordt deze gemaakt met dezelfde naam. Als de opgegeven resourcegroep bestaat, moet deze leeg zijn en zich in dezelfde regio bevinden als de afbeeldingssjabloon. De gemaakte resourcegroep wordt verwijderd tijdens het verwijderen van de sjabloon als dit veld leeg is of als de opgegeven resourcegroep niet bestaat, maar als de opgegeven resourcegroep bestaat, worden de resources verwijderd die in de resourcegroep zijn gemaakt tijdens het verwijderen van de sjabloon en blijft de resourcegroep zelf behouden.	snaar
valideren	Configuratieopties en lijst met validaties die moeten worden uitgevoerd op de resulterende afbeelding.	ImageTemplatePropertiesValidate-
vmProfile	Beschrijft hoe de virtuele machine is ingesteld voor het bouwen van installatiekopieën	ImageTemplateVmProfile

ImageTemplateAutoRun

Naam	Beschrijving	Waarde
staat	Als u dit veld inschakelt, wordt automatisch een build geactiveerd voor het maken of bijwerken van een installatiekopiesjabloon.	'Uitgeschakeld' 'Ingeschakeld'

ImageTemplateCustomizer

Naam	Beschrijving	Waarde
naam	Beschrijvende naam om context te geven over wat deze aanpassingsstap doet	snaar
type	Het objecttype instellen	bestand PowerShell- Shell- WindowsRestart- WindowsUpdate- (vereist)

ImageTemplateFileCustomizer

Naam	Beschrijving	Waarde
type	Het type aanpassingsprogramma dat u wilt gebruiken op de afbeelding. 'Shell' kan bijvoorbeeld shell-customizer zijn	'Bestand' (vereist)
bestemming	Het absolute pad naar een bestand (met geneste mapstructuren die al zijn gemaakt) waar het bestand (van sourceUri) naar wordt geüpload in de VIRTUELE machine	snaar
sha256Checksum	SHA256-controlesom van het bestand dat is opgegeven in het bovenstaande bronuri-veld	snaar
sourceUri	De URI van het bestand dat moet worden geüpload voor het aanpassen van de VIRTUELE machine. Het kan een github-koppeling, SAS-URI voor Azure Storage, enzovoort zijn	snaar

ImageTemplatePowerShellCustomizer

Naam	Beschrijving	Waarde
type	Het type aanpassingsprogramma dat u wilt gebruiken op de afbeelding. 'Shell' kan bijvoorbeeld shell-customizer zijn	PowerShell (vereist)
Inline	Matrix met PowerShell-opdrachten die moeten worden uitgevoerd	tekenreeks[]
runAsSystem	Als dit is opgegeven, wordt het PowerShell-script uitgevoerd met verhoogde bevoegdheden met behulp van de gebruiker van het lokale systeem. Kan alleen waar zijn wanneer het bovenstaande runElevated-veld is ingesteld op true.	Bool
runElevated	Als dit is opgegeven, wordt het PowerShell-script uitgevoerd met verhoogde bevoegdheden	Bool
scriptUri	URI van het PowerShell-script dat moet worden uitgevoerd voor het aanpassen. Het kan een github-koppeling, SAS-URI voor Azure Storage, enzovoort zijn	snaar
sha256Checksum	SHA256-controlesom van het Power Shell-script dat is opgegeven in het bovenstaande scriptUri-veld	snaar
validExitCodes	Geldige afsluitcodes voor het PowerShell-script. [Standaard: 0]	int[]

ImageTemplateShellCustomizer

Naam	Beschrijving	Waarde
type	Het type aanpassingsprogramma dat u wilt gebruiken op de afbeelding. 'Shell' kan bijvoorbeeld shell-customizer zijn	'Shell' (vereist)
Inline	Matrix van shell-opdrachten die moeten worden uitgevoerd	tekenreeks[]
scriptUri	URI van het shell-script dat moet worden uitgevoerd voor het aanpassen. Het kan een github-koppeling, SAS-URI voor Azure Storage, enzovoort zijn	snaar
sha256Checksum	SHA256-controlesom van het shellscript dat is opgegeven in het scriptUri-veld	snaar

ImageTemplateRestartCustomizer

Naam	Beschrijving	Waarde
type	Het type aanpassingsprogramma dat u wilt gebruiken op de afbeelding. 'Shell' kan bijvoorbeeld shell-customizer zijn	'WindowsRestart' (vereist)
restartCheckCommand	Opdracht om te controleren of opnieuw opstarten is geslaagd [Standaard: '']	snaar
restartCommand	Opdracht om opnieuw opstarten uit te voeren [Standaard: afsluiten /r /f /t /t 0 /c "packer restart""]	snaar
restartTimeout	Time-out voor opnieuw opstarten opgegeven als een tekenreeks van grootte en eenheid, bijvoorbeeld '5m' (5 minuten) of '2h' (2 uur) [Standaard: '5m']	snaar

ImageTemplateWindowsUpdateCustomizer

Naam	Beschrijving	Waarde
type	Het type aanpassingsprogramma dat u wilt gebruiken op de afbeelding. 'Shell' kan bijvoorbeeld shell-customizer zijn	'WindowsUpdate' (vereist)
Filters	Matrix met filters om updates te selecteren die moeten worden toegepast. Laat de lege matrix weg of geef deze op om de standaardwaarde te gebruiken (geen filter). Raadpleeg de bovenstaande koppeling voor voorbeelden en gedetailleerde beschrijving van dit veld.	tekenreeks[]
searchCriteria	Criteria voor het zoeken naar updates. Laat de lege tekenreeks weg of geef deze op om de standaardreeks te gebruiken (zoek alles). Raadpleeg de bovenstaande koppeling voor voorbeelden en gedetailleerde beschrijving van dit veld.	snaar
updateLimit	Maximum aantal updates dat tegelijk moet worden toegepast. Laat 0 weg of geef 0 op om de standaardwaarde te gebruiken (1000)	Int Beperkingen: Minimumwaarde = 0

ImageTemplateDistributor

Naam	Beschrijving	Waarde
artifactTags	Tags die worden toegepast op het artefact nadat het is gemaakt/bijgewerkt door de distributeur.	object
runOutputName	De naam die moet worden gebruikt voor de bijbehorende RunOutput.	tekenreeks (vereist) Beperkingen: Patroon = ^[A-Za-z0-9-_.]{1,64}$
type	Het objecttype instellen	ManagedImage- SharedImage- VHD- (vereist)

ImageTemplateManagedImageDistributor

Naam	Beschrijving	Waarde
type	Type distributie.	ManagedImage (vereist)
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)

ImageTemplateSharedImageDistributor

Naam	Beschrijving	Waarde
type	Type distributie.	SharedImage (vereist)
excludeFromLatest	Vlag die aangeeft of de gemaakte installatiekopieënversie moet worden uitgesloten van de meest recente versie. Weglaten om de standaardwaarde (onwaar) te gebruiken.	Bool
galleryImageId	Resource-id van de azure Compute Gallery-installatiekopieën	tekenreeks (vereist)
replicationRegions	[Afgeschaft] Een lijst met regio's waarnaar de installatiekopieën worden gerepliceerd. Deze lijst kan alleen worden opgegeven als targetRegions niet is opgegeven. Dit veld is afgeschaft. Gebruik in plaats daarvan targetRegions.	tekenreeks[]
storageAccountType	[Afgeschaft] Het type opslagaccount dat moet worden gebruikt voor het opslaan van de gedeelde installatiekopie. Laat het gebruik van de standaardwaarde weg (Standard_LRS). Dit veld kan alleen worden opgegeven als replicationRegions is opgegeven. Dit veld is afgeschaft. Gebruik in plaats daarvan targetRegions.	'Premium_LRS' 'Standard_LRS' 'Standard_ZRS'
targetRegions	De doelregio's waarnaar de gedistribueerde versie van de installatiekopieën wordt gerepliceerd. Dit object vervangt replicationRegions en kan alleen worden opgegeven als replicationRegions niet is opgegeven.	TargetRegion[]
versiebeheer	Hierin wordt beschreven hoe u een nieuw x.y.z-versienummer voor distributie genereert.	DistributeVersioner-

TargetRegion

Naam	Beschrijving	Waarde
naam	De naam van de regio.	tekenreeks (vereist)
replicaCount	Het aantal replica's van de versie van de installatiekopieën dat in deze regio moet worden gemaakt. Laat het gebruik van de standaardwaarde weg (1).	Int Beperkingen: Minimumwaarde = 1
storageAccountType	Hiermee geeft u het type opslagaccount op dat moet worden gebruikt voor het opslaan van de installatiekopie in deze regio. Laat het gebruik van de standaardwaarde weg (Standard_LRS).	'Premium_LRS' 'Standard_LRS' 'Standard_ZRS'

DistributeVersioner

Naam	Beschrijving	Waarde
plan	Het objecttype instellen	meest recente bron- (vereist)

DistributeVersionerLatest

Naam	Beschrijving	Waarde
plan	Versienummeringsschema dat moet worden gebruikt.	'Nieuwste' (vereist)
majoor	Primaire versie voor het gegenereerde versienummer. Bepaal wat 'nieuwste' is op basis van versies met deze waarde als primaire versie. -1 is gelijk aan het verlaten ervan.	Int

DistributeVersionerSource

Naam	Beschrijving	Waarde
plan	Versienummeringsschema dat moet worden gebruikt.	Bron (vereist)

ImageTemplateVhdDistributor

Naam	Beschrijving	Waarde
type	Type distributie.	VHD (vereist)
Uri	Optionele Azure Storage-URI voor de gedistribueerde VHD-blob. Laat het gebruik van de standaardwaarde (lege tekenreeks) weg. In dat geval wordt VHD gepubliceerd naar het opslagaccount in de faseringsresourcegroep.	snaar

ImageTemplatePropertiesErrorHandling

Naam	Beschrijving	Waarde
onCustomizerError	Als er een aanpasserfout optreedt en dit veld is ingesteld op op opschonen, worden de build-VM en de bijbehorende netwerkbronnen opgeschoond. Dit is het standaardgedrag. Als er een aanpasserfout optreedt en dit veld is ingesteld op afbreken, blijft de build-VM behouden.	'afgebroken' 'opschonen'
onValidationError	Als er een validatiefout optreedt en dit veld is ingesteld op op opschonen, worden de build-VM en de bijbehorende netwerkbronnen opgeschoond. Dit is het standaardgedrag. Als er een validatiefout is en dit veld is ingesteld op 'afbreken', blijft de build-VM behouden.	'afgebroken' 'opschonen'

ImageTemplatePropertiesOptimize

Naam	Beschrijving	Waarde
vmBoot	Optimalisatie wordt toegepast op de installatiekopie voor een snellere vm-opstartbewerking.	ImageTemplatePropertiesOptimizeVmBoot

ImageTemplatePropertiesOptimizeVmBoot

Naam	Beschrijving	Waarde
staat	Als u dit veld inschakelt, wordt de opstarttijd van de VIRTUELE machine verbeterd door de uiteindelijke aangepaste uitvoer van de installatiekopie te optimaliseren.	'Uitgeschakeld' 'Ingeschakeld'

ImageTemplateSource

Naam	Beschrijving	Waarde
type	Het objecttype instellen	ManagedImage- PlatformImage- SharedImageVersion (vereist)

ImageTemplateManagedImageSource

Naam	Beschrijving	Waarde
type	Hiermee geeft u het type broninstallatiekopie waarmee u wilt beginnen.	ManagedImage (vereist)
imageId	ARM-resource-id van de beheerde installatiekopieën in het klantabonnement	tekenreeks (vereist)

ImageTemplatePlatformImageSource

Naam	Beschrijving	Waarde
type	Hiermee geeft u het type broninstallatiekopie waarmee u wilt beginnen.	PlatformImage (vereist)
aanbieden	Afbeeldingsaanbieding uit de Azure Gallery Images.	snaar
planInfo	Optionele configuratie van aankoopplan voor platforminstallatiekopieën.	PlatformImagePurchasePlan
uitgever	Image Publisher in Azure Gallery Images.	snaar
Sku	Afbeeldingsku uit de Azure Gallery-installatiekopieën.	snaar
Versie	Installatiekopieën van de Azure Gallery-installatiekopieën. Als hier 'nieuwste' is opgegeven, wordt de versie geëvalueerd wanneer de installatiekopieën worden gebouwd, niet wanneer de sjabloon wordt verzonden.	snaar

PlatformImagePurchasePlan

Naam	Beschrijving	Waarde
planName	Naam van het aankoopplan.	tekenreeks (vereist)
planProduct	Product van het aankoopplan.	tekenreeks (vereist)
planPublisher	Uitgever van het aankoopplan.	tekenreeks (vereist)

ImageTemplateSharedImageVersionSource

Naam	Beschrijving	Waarde
type	Hiermee geeft u het type broninstallatiekopie waarmee u wilt beginnen.	SharedImageVersion (vereist)
imageVersionId	ARM-resource-id van de versie van de installatiekopieën. Wanneer de naam van de installatiekopieënversie 'nieuwste' is, wordt de versie geëvalueerd wanneer de installatiekopieën worden gebouwd.	tekenreeks (vereist)

ImageTemplatePropertiesValidate

Naam	Beschrijving	Waarde
continueDistributeOnFailure	Als de validatie mislukt en dit veld is ingesteld op false, worden de uitvoerafbeeldingen niet gedistribueerd. Dit is het standaardgedrag. Als de validatie mislukt en dit veld is ingesteld op true, worden uitvoerafbeeldingen nog steeds gedistribueerd. Gebruik deze optie met voorzichtigheid, omdat dit kan leiden tot slechte installatiekopieën die voor gebruik worden gedistribueerd. In beide gevallen (waar of onwaar) wordt de end-to-end-installatiekopieuitvoering gerapporteerd als mislukt in het geval van een validatiefout. [Opmerking: dit veld heeft geen effect als de validatie slaagt.]	Bool
inVMValidations	Lijst met validaties die moeten worden uitgevoerd.	ImageTemplateInVMValidator[]
sourceValidationOnly	Als dit veld is ingesteld op true, wordt de afbeelding die is opgegeven in de sectie Bron rechtstreeks gevalideerd. Er wordt geen afzonderlijke build uitgevoerd om een aangepaste installatiekopieën te genereren en vervolgens te valideren.	Bool

ImageTemplateInVMValidator

Naam	Beschrijving	Waarde
naam	Beschrijvende naam om context op te geven over wat deze validatiestap doet	snaar
type	Het objecttype instellen	bestand PowerShell- Shell- (vereist)

ImageTemplateFileValidator

Naam	Beschrijving	Waarde
type	Het type validatie dat u wilt gebruiken op de afbeelding. Shell kan bijvoorbeeld shellvalidatie zijn	'Bestand' (vereist)
bestemming	Het absolute pad naar een bestand (met geneste mapstructuren die al zijn gemaakt) waar het bestand (van sourceUri) naar wordt geüpload in de VIRTUELE machine	snaar
sha256Checksum	SHA256-controlesom van het bestand dat is opgegeven in het bovenstaande bronuri-veld	snaar
sourceUri	De URI van het bestand dat moet worden geüpload naar de VIRTUELE machine voor validatie. Het kan een github-koppeling, Azure Storage-URI (geautoriseerd of SAS) zijn, enzovoort	snaar

ImageTemplatePowerShellValidator

Naam	Beschrijving	Waarde
type	Het type validatie dat u wilt gebruiken op de afbeelding. Shell kan bijvoorbeeld shellvalidatie zijn	PowerShell (vereist)
Inline	Matrix met PowerShell-opdrachten die moeten worden uitgevoerd	tekenreeks[]
runAsSystem	Als dit is opgegeven, wordt het PowerShell-script uitgevoerd met verhoogde bevoegdheden met behulp van de gebruiker van het lokale systeem. Kan alleen waar zijn wanneer het bovenstaande runElevated-veld is ingesteld op true.	Bool
runElevated	Als dit is opgegeven, wordt het PowerShell-script uitgevoerd met verhoogde bevoegdheden	Bool
scriptUri	URI van het PowerShell-script dat moet worden uitgevoerd voor validatie. Dit kan een github-koppeling, Azure Storage-URI, enzovoort zijn	snaar
sha256Checksum	SHA256-controlesom van het Power Shell-script dat is opgegeven in het bovenstaande scriptUri-veld	snaar
validExitCodes	Geldige afsluitcodes voor het PowerShell-script. [Standaard: 0]	int[]

ImageTemplateShellValidator

Naam	Beschrijving	Waarde
type	Het type validatie dat u wilt gebruiken op de afbeelding. Shell kan bijvoorbeeld shellvalidatie zijn	'Shell' (vereist)
Inline	Matrix van shell-opdrachten die moeten worden uitgevoerd	tekenreeks[]
scriptUri	URI van het shellscript dat moet worden uitgevoerd voor validatie. Dit kan een github-koppeling, Azure Storage-URI, enzovoort zijn	snaar
sha256Checksum	SHA256-controlesom van het shellscript dat is opgegeven in het scriptUri-veld	snaar

ImageTemplateVmProfile

Naam	Beschrijving	Waarde
osDiskSizeGB	Grootte van de besturingssysteemschijf in GB. Laat 0 weg of geef 0 op om de standaardschijfgrootte van het besturingssysteem van Azure te gebruiken.	Int Beperkingen: Minimumwaarde = 0
userAssignedIdentities	Optionele matrix van resource-id's van door de gebruiker toegewezen beheerde identiteiten die moeten worden geconfigureerd op de build-VM en validatie-VM. Dit kan de identiteit van de afbeeldingssjabloon zijn.	tekenreeks[]
vmSize	Grootte van de virtuele machine die wordt gebruikt voor het bouwen, aanpassen en vastleggen van installatiekopieën. Laat de lege tekenreeks weg of geef deze op om de standaardreeks te gebruiken (Standard_D1_v2 voor Gen1-installatiekopieën en Standard_D2ds_v4 voor Gen2-afbeeldingen).	snaar
vnetConfig	Optionele configuratie van het virtuele netwerk dat moet worden gebruikt voor het implementeren van de build-VM en validatie-VM in. Weglaten als er geen specifiek virtueel netwerk moet worden gebruikt.	VirtualNetworkConfig-

VirtualNetworkConfig

Naam	Beschrijving	Waarde
containerInstanceSubnetId	Resource-id van een bestaand subnet waarop Azure Container Instance wordt geïmplementeerd voor geïsoleerde builds. Dit veld mag alleen worden opgegeven als subnetId ook is opgegeven en moet zich in hetzelfde virtuele netwerk bevinden als het subnet dat is opgegeven in subnetId.	snaar
proxyVmSize	De grootte van de virtuele proxymachine die wordt gebruikt om verkeer door te geven aan de build-VM en validatie-VM. Dit mag niet worden opgegeven als containerInstanceSubnetId is opgegeven omdat er in dat geval geen virtuele proxymachine wordt geïmplementeerd. Laat de lege tekenreeks weg of geef deze op om de standaardwaarde te gebruiken (Standard_A1_v2).	snaar
subnetId	Resource-id van een bestaand subnet waarop de build-VM en validatie-VM worden geïmplementeerd	snaar

Quickstart-sjablonen

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

Sjabloon	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 quickstartgids voor Dev Box (https://learn.microsoft.com/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:

• Resourcegroepen - Zie opdrachten voor de implementatie van 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 JSON toe aan uw sjabloon.

{
  "type": "Microsoft.VirtualMachineImages/imageTemplates",
  "apiVersion": "2024-02-01",
  "name": "string",
  "location": "string",
  "tags": {
    "tagName1": "tagValue1",
    "tagName2": "tagValue2"
  },
  "identity": {
    "type": "string",
    "userAssignedIdentities": {
      "{customized property}": {}
    }
  },
  "properties": {
    "autoRun": {
      "state": "string"
    },
    "buildTimeoutInMinutes": "int",
    "customize": [
      {
        "name": "string",
        "type": "string"
        // For remaining properties, see ImageTemplateCustomizer objects
      }
    ],
    "distribute": [
      {
        "artifactTags": {},
        "runOutputName": "string",
        "type": "string"
        // For remaining properties, see ImageTemplateDistributor objects
      }
    ],
    "errorHandling": {
      "onCustomizerError": "string",
      "onValidationError": "string"
    },
    "managedResourceTags": {},
    "optimize": {
      "vmBoot": {
        "state": "string"
      }
    },
    "source": {
      "type": "string"
      // For remaining properties, see ImageTemplateSource objects
    },
    "stagingResourceGroup": "string",
    "validate": {
      "continueDistributeOnFailure": "bool",
      "inVMValidations": [
        {
          "name": "string",
          "type": "string"
          // For remaining properties, see ImageTemplateInVMValidator objects
        }
      ],
      "sourceValidationOnly": "bool"
    },
    "vmProfile": {
      "osDiskSizeGB": "int",
      "userAssignedIdentities": [ "string" ],
      "vmSize": "string",
      "vnetConfig": {
        "containerInstanceSubnetId": "string",
        "proxyVmSize": "string",
        "subnetId": "string"
      }
    }
  }
}

ImageTemplateCustomizer-objecten

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

Gebruik voor Bestand:

  "type": "File",
  "destination": "string",
  "sha256Checksum": "string",
  "sourceUri": "string"

Gebruik voor PowerShell-:

  "type": "PowerShell",
  "inline": [ "string" ],
  "runAsSystem": "bool",
  "runElevated": "bool",
  "scriptUri": "string",
  "sha256Checksum": "string",
  "validExitCodes": [ "int" ]

Gebruik voor Shell-:

  "type": "Shell",
  "inline": [ "string" ],
  "scriptUri": "string",
  "sha256Checksum": "string"

Gebruik voor WindowsRestart:

  "type": "WindowsRestart",
  "restartCheckCommand": "string",
  "restartCommand": "string",
  "restartTimeout": "string"

Gebruik voor WindowsUpdate-:

  "type": "WindowsUpdate",
  "filters": [ "string" ],
  "searchCriteria": "string",
  "updateLimit": "int"

ImageTemplateDistributor-objecten

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

Gebruik voor ManagedImage:

  "type": "ManagedImage",
  "imageId": "string",
  "location": "string"

Gebruik voor SharedImage:

  "type": "SharedImage",
  "excludeFromLatest": "bool",
  "galleryImageId": "string",
  "replicationRegions": [ "string" ],
  "storageAccountType": "string",
  "targetRegions": [
    {
      "name": "string",
      "replicaCount": "int",
      "storageAccountType": "string"
    }
  ],
  "versioning": {
    "scheme": "string"
    // For remaining properties, see DistributeVersioner objects
  }

Gebruik voor VHD-:

  "type": "VHD",
  "uri": "string"

DistributeVersioner-objecten

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

Gebruik voor Meest recente:

  "scheme": "Latest",
  "major": "int"

Gebruik voor bron:

  "scheme": "Source"

ImageTemplateSource-objecten

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

Gebruik voor ManagedImage:

  "type": "ManagedImage",
  "imageId": "string"

Gebruik voor PlatformImage:

  "type": "PlatformImage",
  "offer": "string",
  "planInfo": {
    "planName": "string",
    "planProduct": "string",
    "planPublisher": "string"
  },
  "publisher": "string",
  "sku": "string",
  "version": "string"

Gebruik voor SharedImageVersion:

  "type": "SharedImageVersion",
  "imageVersionId": "string"

ImageTemplateInVMValidator-objecten

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

Gebruik voor Bestand:

  "type": "File",
  "destination": "string",
  "sha256Checksum": "string",
  "sourceUri": "string"

Gebruik voor PowerShell-:

  "type": "PowerShell",
  "inline": [ "string" ],
  "runAsSystem": "bool",
  "runElevated": "bool",
  "scriptUri": "string",
  "sha256Checksum": "string",
  "validExitCodes": [ "int" ]

Gebruik voor Shell-:

  "type": "Shell",
  "inline": [ "string" ],
  "scriptUri": "string",
  "sha256Checksum": "string"

Eigenschapswaarden

imageTemplates

Naam	Beschrijving	Waarde
type	Het resourcetype	'Microsoft.VirtualMachineImages/imageTemplates'
apiVersion	De versie van de resource-API	'2024-02-01'
naam	De resourcenaam	tekenreeks (vereist)
plaats	De geografische locatie waar de resource zich bevindt	tekenreeks (vereist)
Tags	Resourcetags.	Woordenlijst met tagnamen en -waarden. Zie Tags in sjablonen
identiteit	De identiteit van de afbeeldingssjabloon, indien geconfigureerd.	ImageTemplateIdentity (vereist)
Eigenschappen	De eigenschappen van de afbeeldingssjabloon	ImageTemplateProperties-

ImageTemplateIdentity

Naam	Beschrijving	Waarde
type	Het type identiteit dat wordt gebruikt voor de afbeeldingssjabloon. Met het type None worden alle identiteiten uit de afbeeldingssjabloon verwijderd.	'Geen' UserAssigned
userAssignedIdentities	De set door de gebruiker toegewezen identiteiten die aan de resource zijn gekoppeld. De woordenlijstsleutels userAssignedIdentities zijn ARM-resource-id's in de vorm: /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ManagedIdentity/userAssignedIdentities/{identityName}. De waarden van de woordenlijst kunnen lege objecten ({}) zijn in aanvragen.	UserAssignedId-entiteiten

UserAssignedIdentities

Naam	Beschrijving	Waarde
{aangepaste eigenschap}		UserAssignedIdentity-

UserAssignedIdentity

Dit object bevat geen eigenschappen die tijdens de implementatie moeten worden ingesteld. Alle eigenschappen zijn ReadOnly.

ImageTemplateProperties

Naam	Beschrijving	Waarde
autoRun	Hiermee wordt aangegeven of de installatiekopiesjabloon automatisch moet worden uitgevoerd bij het maken of bijwerken van een sjabloon.	ImageTemplateAutoRun
buildTimeoutInMinutes	Maximale duur om te wachten tijdens het bouwen van de afbeeldingssjabloon (inclusief alle aanpassingen, optimalisatie, validaties en distributies). Laat 0 weg of geef 0 op om de standaardwaarde (4 uur) te gebruiken.	Int Beperkingen: Minimumwaarde = 0 Maximumwaarde = 960
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)
errorHandling	Opties voor foutafhandeling bij een buildfout	ImageTemplatePropertiesErrorHandling
managedResourceTags	Tags die worden toegepast op de resourcegroep en/of resources die door de service zijn gemaakt.	object
optimaliseren	Hiermee geeft u optimalisatie moet worden uitgevoerd op de afbeelding.	ImageTemplatePropertiesOptimize
bron	Hiermee geeft u de eigenschappen op die worden gebruikt om de broninstallatiekopieën te beschrijven.	ImageTemplateSource (vereist)
stagingResourceGroup	De id van de faseringsresourcegroep in hetzelfde abonnement als de installatiekopieënsjabloon die wordt gebruikt om de installatiekopieën te bouwen. Als dit veld leeg is, wordt er een resourcegroep met een willekeurige naam gemaakt. Als de resourcegroep die in dit veld is opgegeven niet bestaat, wordt deze gemaakt met dezelfde naam. Als de opgegeven resourcegroep bestaat, moet deze leeg zijn en zich in dezelfde regio bevinden als de afbeeldingssjabloon. De gemaakte resourcegroep wordt verwijderd tijdens het verwijderen van de sjabloon als dit veld leeg is of als de opgegeven resourcegroep niet bestaat, maar als de opgegeven resourcegroep bestaat, worden de resources verwijderd die in de resourcegroep zijn gemaakt tijdens het verwijderen van de sjabloon en blijft de resourcegroep zelf behouden.	snaar
valideren	Configuratieopties en lijst met validaties die moeten worden uitgevoerd op de resulterende afbeelding.	ImageTemplatePropertiesValidate-
vmProfile	Beschrijft hoe de virtuele machine is ingesteld voor het bouwen van installatiekopieën	ImageTemplateVmProfile

ImageTemplateAutoRun

Naam	Beschrijving	Waarde
staat	Als u dit veld inschakelt, wordt automatisch een build geactiveerd voor het maken of bijwerken van een installatiekopiesjabloon.	'Uitgeschakeld' 'Ingeschakeld'

ImageTemplateCustomizer

Naam	Beschrijving	Waarde
naam	Beschrijvende naam om context te geven over wat deze aanpassingsstap doet	snaar
type	Het objecttype instellen	bestand PowerShell- Shell- WindowsRestart- WindowsUpdate- (vereist)

ImageTemplateFileCustomizer

Naam	Beschrijving	Waarde
type	Het type aanpassingsprogramma dat u wilt gebruiken op de afbeelding. 'Shell' kan bijvoorbeeld shell-customizer zijn	'Bestand' (vereist)
bestemming	Het absolute pad naar een bestand (met geneste mapstructuren die al zijn gemaakt) waar het bestand (van sourceUri) naar wordt geüpload in de VIRTUELE machine	snaar
sha256Checksum	SHA256-controlesom van het bestand dat is opgegeven in het bovenstaande bronuri-veld	snaar
sourceUri	De URI van het bestand dat moet worden geüpload voor het aanpassen van de VIRTUELE machine. Het kan een github-koppeling, SAS-URI voor Azure Storage, enzovoort zijn	snaar

ImageTemplatePowerShellCustomizer

Naam	Beschrijving	Waarde
type	Het type aanpassingsprogramma dat u wilt gebruiken op de afbeelding. 'Shell' kan bijvoorbeeld shell-customizer zijn	PowerShell (vereist)
Inline	Matrix met PowerShell-opdrachten die moeten worden uitgevoerd	tekenreeks[]
runAsSystem	Als dit is opgegeven, wordt het PowerShell-script uitgevoerd met verhoogde bevoegdheden met behulp van de gebruiker van het lokale systeem. Kan alleen waar zijn wanneer het bovenstaande runElevated-veld is ingesteld op true.	Bool
runElevated	Als dit is opgegeven, wordt het PowerShell-script uitgevoerd met verhoogde bevoegdheden	Bool
scriptUri	URI van het PowerShell-script dat moet worden uitgevoerd voor het aanpassen. Het kan een github-koppeling, SAS-URI voor Azure Storage, enzovoort zijn	snaar
sha256Checksum	SHA256-controlesom van het Power Shell-script dat is opgegeven in het bovenstaande scriptUri-veld	snaar
validExitCodes	Geldige afsluitcodes voor het PowerShell-script. [Standaard: 0]	int[]

ImageTemplateShellCustomizer

Naam	Beschrijving	Waarde
type	Het type aanpassingsprogramma dat u wilt gebruiken op de afbeelding. 'Shell' kan bijvoorbeeld shell-customizer zijn	'Shell' (vereist)
Inline	Matrix van shell-opdrachten die moeten worden uitgevoerd	tekenreeks[]
scriptUri	URI van het shell-script dat moet worden uitgevoerd voor het aanpassen. Het kan een github-koppeling, SAS-URI voor Azure Storage, enzovoort zijn	snaar
sha256Checksum	SHA256-controlesom van het shellscript dat is opgegeven in het scriptUri-veld	snaar

ImageTemplateRestartCustomizer

Naam	Beschrijving	Waarde
type	Het type aanpassingsprogramma dat u wilt gebruiken op de afbeelding. 'Shell' kan bijvoorbeeld shell-customizer zijn	'WindowsRestart' (vereist)
restartCheckCommand	Opdracht om te controleren of opnieuw opstarten is geslaagd [Standaard: '']	snaar
restartCommand	Opdracht om opnieuw opstarten uit te voeren [Standaard: afsluiten /r /f /t /t 0 /c "packer restart""]	snaar
restartTimeout	Time-out voor opnieuw opstarten opgegeven als een tekenreeks van grootte en eenheid, bijvoorbeeld '5m' (5 minuten) of '2h' (2 uur) [Standaard: '5m']	snaar

ImageTemplateWindowsUpdateCustomizer

Naam	Beschrijving	Waarde
type	Het type aanpassingsprogramma dat u wilt gebruiken op de afbeelding. 'Shell' kan bijvoorbeeld shell-customizer zijn	'WindowsUpdate' (vereist)
Filters	Matrix met filters om updates te selecteren die moeten worden toegepast. Laat de lege matrix weg of geef deze op om de standaardwaarde te gebruiken (geen filter). Raadpleeg de bovenstaande koppeling voor voorbeelden en gedetailleerde beschrijving van dit veld.	tekenreeks[]
searchCriteria	Criteria voor het zoeken naar updates. Laat de lege tekenreeks weg of geef deze op om de standaardreeks te gebruiken (zoek alles). Raadpleeg de bovenstaande koppeling voor voorbeelden en gedetailleerde beschrijving van dit veld.	snaar
updateLimit	Maximum aantal updates dat tegelijk moet worden toegepast. Laat 0 weg of geef 0 op om de standaardwaarde te gebruiken (1000)	Int Beperkingen: Minimumwaarde = 0

ImageTemplateDistributor

Naam	Beschrijving	Waarde
artifactTags	Tags die worden toegepast op het artefact nadat het is gemaakt/bijgewerkt door de distributeur.	object
runOutputName	De naam die moet worden gebruikt voor de bijbehorende RunOutput.	tekenreeks (vereist) Beperkingen: Patroon = ^[A-Za-z0-9-_.]{1,64}$
type	Het objecttype instellen	ManagedImage- SharedImage- VHD- (vereist)

ImageTemplateManagedImageDistributor

Naam	Beschrijving	Waarde
type	Type distributie.	ManagedImage (vereist)
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)

ImageTemplateSharedImageDistributor

Naam	Beschrijving	Waarde
type	Type distributie.	SharedImage (vereist)
excludeFromLatest	Vlag die aangeeft of de gemaakte installatiekopieënversie moet worden uitgesloten van de meest recente versie. Weglaten om de standaardwaarde (onwaar) te gebruiken.	Bool
galleryImageId	Resource-id van de azure Compute Gallery-installatiekopieën	tekenreeks (vereist)
replicationRegions	[Afgeschaft] Een lijst met regio's waarnaar de installatiekopieën worden gerepliceerd. Deze lijst kan alleen worden opgegeven als targetRegions niet is opgegeven. Dit veld is afgeschaft. Gebruik in plaats daarvan targetRegions.	tekenreeks[]
storageAccountType	[Afgeschaft] Het type opslagaccount dat moet worden gebruikt voor het opslaan van de gedeelde installatiekopie. Laat het gebruik van de standaardwaarde weg (Standard_LRS). Dit veld kan alleen worden opgegeven als replicationRegions is opgegeven. Dit veld is afgeschaft. Gebruik in plaats daarvan targetRegions.	'Premium_LRS' 'Standard_LRS' 'Standard_ZRS'
targetRegions	De doelregio's waarnaar de gedistribueerde versie van de installatiekopieën wordt gerepliceerd. Dit object vervangt replicationRegions en kan alleen worden opgegeven als replicationRegions niet is opgegeven.	TargetRegion[]
versiebeheer	Hierin wordt beschreven hoe u een nieuw x.y.z-versienummer voor distributie genereert.	DistributeVersioner-

TargetRegion

Naam	Beschrijving	Waarde
naam	De naam van de regio.	tekenreeks (vereist)
replicaCount	Het aantal replica's van de versie van de installatiekopieën dat in deze regio moet worden gemaakt. Laat het gebruik van de standaardwaarde weg (1).	Int Beperkingen: Minimumwaarde = 1
storageAccountType	Hiermee geeft u het type opslagaccount op dat moet worden gebruikt voor het opslaan van de installatiekopie in deze regio. Laat het gebruik van de standaardwaarde weg (Standard_LRS).	'Premium_LRS' 'Standard_LRS' 'Standard_ZRS'

DistributeVersioner

Naam	Beschrijving	Waarde
plan	Het objecttype instellen	meest recente bron- (vereist)

DistributeVersionerLatest

Naam	Beschrijving	Waarde
plan	Versienummeringsschema dat moet worden gebruikt.	'Nieuwste' (vereist)
majoor	Primaire versie voor het gegenereerde versienummer. Bepaal wat 'nieuwste' is op basis van versies met deze waarde als primaire versie. -1 is gelijk aan het verlaten ervan.	Int

DistributeVersionerSource

Naam	Beschrijving	Waarde
plan	Versienummeringsschema dat moet worden gebruikt.	Bron (vereist)

ImageTemplateVhdDistributor

Naam	Beschrijving	Waarde
type	Type distributie.	VHD (vereist)
Uri	Optionele Azure Storage-URI voor de gedistribueerde VHD-blob. Laat het gebruik van de standaardwaarde (lege tekenreeks) weg. In dat geval wordt VHD gepubliceerd naar het opslagaccount in de faseringsresourcegroep.	snaar

ImageTemplatePropertiesErrorHandling

Naam	Beschrijving	Waarde
onCustomizerError	Als er een aanpasserfout optreedt en dit veld is ingesteld op op opschonen, worden de build-VM en de bijbehorende netwerkbronnen opgeschoond. Dit is het standaardgedrag. Als er een aanpasserfout optreedt en dit veld is ingesteld op afbreken, blijft de build-VM behouden.	'afgebroken' 'opschonen'
onValidationError	Als er een validatiefout optreedt en dit veld is ingesteld op op opschonen, worden de build-VM en de bijbehorende netwerkbronnen opgeschoond. Dit is het standaardgedrag. Als er een validatiefout is en dit veld is ingesteld op 'afbreken', blijft de build-VM behouden.	'afgebroken' 'opschonen'

ImageTemplatePropertiesOptimize

Naam	Beschrijving	Waarde
vmBoot	Optimalisatie wordt toegepast op de installatiekopie voor een snellere vm-opstartbewerking.	ImageTemplatePropertiesOptimizeVmBoot

ImageTemplatePropertiesOptimizeVmBoot

Naam	Beschrijving	Waarde
staat	Als u dit veld inschakelt, wordt de opstarttijd van de VIRTUELE machine verbeterd door de uiteindelijke aangepaste uitvoer van de installatiekopie te optimaliseren.	'Uitgeschakeld' 'Ingeschakeld'

ImageTemplateSource

Naam	Beschrijving	Waarde
type	Het objecttype instellen	ManagedImage- PlatformImage- SharedImageVersion (vereist)

ImageTemplateManagedImageSource

Naam	Beschrijving	Waarde
type	Hiermee geeft u het type broninstallatiekopie waarmee u wilt beginnen.	ManagedImage (vereist)
imageId	ARM-resource-id van de beheerde installatiekopieën in het klantabonnement	tekenreeks (vereist)

ImageTemplatePlatformImageSource

Naam	Beschrijving	Waarde
type	Hiermee geeft u het type broninstallatiekopie waarmee u wilt beginnen.	PlatformImage (vereist)
aanbieden	Afbeeldingsaanbieding uit de Azure Gallery Images.	snaar
planInfo	Optionele configuratie van aankoopplan voor platforminstallatiekopieën.	PlatformImagePurchasePlan
uitgever	Image Publisher in Azure Gallery Images.	snaar
Sku	Afbeeldingsku uit de Azure Gallery-installatiekopieën.	snaar
Versie	Installatiekopieën van de Azure Gallery-installatiekopieën. Als hier 'nieuwste' is opgegeven, wordt de versie geëvalueerd wanneer de installatiekopieën worden gebouwd, niet wanneer de sjabloon wordt verzonden.	snaar

PlatformImagePurchasePlan

Naam	Beschrijving	Waarde
planName	Naam van het aankoopplan.	tekenreeks (vereist)
planProduct	Product van het aankoopplan.	tekenreeks (vereist)
planPublisher	Uitgever van het aankoopplan.	tekenreeks (vereist)

ImageTemplateSharedImageVersionSource

Naam	Beschrijving	Waarde
type	Hiermee geeft u het type broninstallatiekopie waarmee u wilt beginnen.	SharedImageVersion (vereist)
imageVersionId	ARM-resource-id van de versie van de installatiekopieën. Wanneer de naam van de installatiekopieënversie 'nieuwste' is, wordt de versie geëvalueerd wanneer de installatiekopieën worden gebouwd.	tekenreeks (vereist)

ImageTemplatePropertiesValidate

Naam	Beschrijving	Waarde
continueDistributeOnFailure	Als de validatie mislukt en dit veld is ingesteld op false, worden de uitvoerafbeeldingen niet gedistribueerd. Dit is het standaardgedrag. Als de validatie mislukt en dit veld is ingesteld op true, worden uitvoerafbeeldingen nog steeds gedistribueerd. Gebruik deze optie met voorzichtigheid, omdat dit kan leiden tot slechte installatiekopieën die voor gebruik worden gedistribueerd. In beide gevallen (waar of onwaar) wordt de end-to-end-installatiekopieuitvoering gerapporteerd als mislukt in het geval van een validatiefout. [Opmerking: dit veld heeft geen effect als de validatie slaagt.]	Bool
inVMValidations	Lijst met validaties die moeten worden uitgevoerd.	ImageTemplateInVMValidator[]
sourceValidationOnly	Als dit veld is ingesteld op true, wordt de afbeelding die is opgegeven in de sectie Bron rechtstreeks gevalideerd. Er wordt geen afzonderlijke build uitgevoerd om een aangepaste installatiekopieën te genereren en vervolgens te valideren.	Bool

ImageTemplateInVMValidator

Naam	Beschrijving	Waarde
naam	Beschrijvende naam om context op te geven over wat deze validatiestap doet	snaar
type	Het objecttype instellen	bestand PowerShell- Shell- (vereist)

ImageTemplateFileValidator

Naam	Beschrijving	Waarde
type	Het type validatie dat u wilt gebruiken op de afbeelding. Shell kan bijvoorbeeld shellvalidatie zijn	'Bestand' (vereist)
bestemming	Het absolute pad naar een bestand (met geneste mapstructuren die al zijn gemaakt) waar het bestand (van sourceUri) naar wordt geüpload in de VIRTUELE machine	snaar
sha256Checksum	SHA256-controlesom van het bestand dat is opgegeven in het bovenstaande bronuri-veld	snaar
sourceUri	De URI van het bestand dat moet worden geüpload naar de VIRTUELE machine voor validatie. Het kan een github-koppeling, Azure Storage-URI (geautoriseerd of SAS) zijn, enzovoort	snaar

ImageTemplatePowerShellValidator

Naam	Beschrijving	Waarde
type	Het type validatie dat u wilt gebruiken op de afbeelding. Shell kan bijvoorbeeld shellvalidatie zijn	PowerShell (vereist)
Inline	Matrix met PowerShell-opdrachten die moeten worden uitgevoerd	tekenreeks[]
runAsSystem	Als dit is opgegeven, wordt het PowerShell-script uitgevoerd met verhoogde bevoegdheden met behulp van de gebruiker van het lokale systeem. Kan alleen waar zijn wanneer het bovenstaande runElevated-veld is ingesteld op true.	Bool
runElevated	Als dit is opgegeven, wordt het PowerShell-script uitgevoerd met verhoogde bevoegdheden	Bool
scriptUri	URI van het PowerShell-script dat moet worden uitgevoerd voor validatie. Dit kan een github-koppeling, Azure Storage-URI, enzovoort zijn	snaar
sha256Checksum	SHA256-controlesom van het Power Shell-script dat is opgegeven in het bovenstaande scriptUri-veld	snaar
validExitCodes	Geldige afsluitcodes voor het PowerShell-script. [Standaard: 0]	int[]

ImageTemplateShellValidator

Naam	Beschrijving	Waarde
type	Het type validatie dat u wilt gebruiken op de afbeelding. Shell kan bijvoorbeeld shellvalidatie zijn	'Shell' (vereist)
Inline	Matrix van shell-opdrachten die moeten worden uitgevoerd	tekenreeks[]
scriptUri	URI van het shellscript dat moet worden uitgevoerd voor validatie. Dit kan een github-koppeling, Azure Storage-URI, enzovoort zijn	snaar
sha256Checksum	SHA256-controlesom van het shellscript dat is opgegeven in het scriptUri-veld	snaar

ImageTemplateVmProfile

Naam	Beschrijving	Waarde
osDiskSizeGB	Grootte van de besturingssysteemschijf in GB. Laat 0 weg of geef 0 op om de standaardschijfgrootte van het besturingssysteem van Azure te gebruiken.	Int Beperkingen: Minimumwaarde = 0
userAssignedIdentities	Optionele matrix van resource-id's van door de gebruiker toegewezen beheerde identiteiten die moeten worden geconfigureerd op de build-VM en validatie-VM. Dit kan de identiteit van de afbeeldingssjabloon zijn.	tekenreeks[]
vmSize	Grootte van de virtuele machine die wordt gebruikt voor het bouwen, aanpassen en vastleggen van installatiekopieën. Laat de lege tekenreeks weg of geef deze op om de standaardreeks te gebruiken (Standard_D1_v2 voor Gen1-installatiekopieën en Standard_D2ds_v4 voor Gen2-afbeeldingen).	snaar
vnetConfig	Optionele configuratie van het virtuele netwerk dat moet worden gebruikt voor het implementeren van de build-VM en validatie-VM in. Weglaten als er geen specifiek virtueel netwerk moet worden gebruikt.	VirtualNetworkConfig-

VirtualNetworkConfig

Naam	Beschrijving	Waarde
containerInstanceSubnetId	Resource-id van een bestaand subnet waarop Azure Container Instance wordt geïmplementeerd voor geïsoleerde builds. Dit veld mag alleen worden opgegeven als subnetId ook is opgegeven en moet zich in hetzelfde virtuele netwerk bevinden als het subnet dat is opgegeven in subnetId.	snaar
proxyVmSize	De grootte van de virtuele proxymachine die wordt gebruikt om verkeer door te geven aan de build-VM en validatie-VM. Dit mag niet worden opgegeven als containerInstanceSubnetId is opgegeven omdat er in dat geval geen virtuele proxymachine wordt geïmplementeerd. Laat de lege tekenreeks weg of geef deze op om de standaardwaarde te gebruiken (Standard_A1_v2).	snaar
subnetId	Resource-id van een bestaand subnet waarop de build-VM en validatie-VM worden geïmplementeerd	snaar

Quickstart-sjablonen

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

Sjabloon	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 quickstartgids voor Dev Box (https://learn.microsoft.com/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@2024-02-01"
  name = "string"
  location = "string"
  parent_id = "string"
  tags = {
    tagName1 = "tagValue1"
    tagName2 = "tagValue2"
  }
  identity {
    type =  "UserAssigned"
    identity_ids = []
  }
  body = jsonencode({
    properties = {
      autoRun = {
        state = "string"
      }
      buildTimeoutInMinutes = int
      customize = [
        {
          name = "string"
          type = "string"
          // For remaining properties, see ImageTemplateCustomizer objects
        }
      ]
      distribute = [
        {
          artifactTags = {}
          runOutputName = "string"
          type = "string"
          // For remaining properties, see ImageTemplateDistributor objects
        }
      ]
      errorHandling = {
        onCustomizerError = "string"
        onValidationError = "string"
      }
      managedResourceTags = {}
      optimize = {
        vmBoot = {
          state = "string"
        }
      }
      source = {
        type = "string"
        // For remaining properties, see ImageTemplateSource objects
      }
      stagingResourceGroup = "string"
      validate = {
        continueDistributeOnFailure = bool
        inVMValidations = [
          {
            name = "string"
            type = "string"
            // For remaining properties, see ImageTemplateInVMValidator objects
          }
        ]
        sourceValidationOnly = bool
      }
      vmProfile = {
        osDiskSizeGB = int
        userAssignedIdentities = [
          "string"
        ]
        vmSize = "string"
        vnetConfig = {
          containerInstanceSubnetId = "string"
          proxyVmSize = "string"
          subnetId = "string"
        }
      }
    }
  })
}

ImageTemplateCustomizer-objecten

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

Gebruik voor Bestand:

  type = "File"
  destination = "string"
  sha256Checksum = "string"
  sourceUri = "string"

Gebruik voor PowerShell-:

  type = "PowerShell"
  inline = [
    "string"
  ]
  runAsSystem = bool
  runElevated = bool
  scriptUri = "string"
  sha256Checksum = "string"
  validExitCodes = [
    int
  ]

Gebruik voor Shell-:

  type = "Shell"
  inline = [
    "string"
  ]
  scriptUri = "string"
  sha256Checksum = "string"

Gebruik voor WindowsRestart:

  type = "WindowsRestart"
  restartCheckCommand = "string"
  restartCommand = "string"
  restartTimeout = "string"

Gebruik voor WindowsUpdate-:

  type = "WindowsUpdate"
  filters = [
    "string"
  ]
  searchCriteria = "string"
  updateLimit = int

ImageTemplateDistributor-objecten

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

Gebruik voor ManagedImage:

  type = "ManagedImage"
  imageId = "string"
  location = "string"

Gebruik voor SharedImage:

  type = "SharedImage"
  excludeFromLatest = bool
  galleryImageId = "string"
  replicationRegions = [
    "string"
  ]
  storageAccountType = "string"
  targetRegions = [
    {
      name = "string"
      replicaCount = int
      storageAccountType = "string"
    }
  ]
  versioning = {
    scheme = "string"
    // For remaining properties, see DistributeVersioner objects
  }

Gebruik voor VHD-:

  type = "VHD"
  uri = "string"

DistributeVersioner-objecten

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

Gebruik voor Meest recente:

  scheme = "Latest"
  major = int

Gebruik voor bron:

  scheme = "Source"

ImageTemplateSource-objecten

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

Gebruik voor ManagedImage:

  type = "ManagedImage"
  imageId = "string"

Gebruik voor PlatformImage:

  type = "PlatformImage"
  offer = "string"
  planInfo = {
    planName = "string"
    planProduct = "string"
    planPublisher = "string"
  }
  publisher = "string"
  sku = "string"
  version = "string"

Gebruik voor SharedImageVersion:

  type = "SharedImageVersion"
  imageVersionId = "string"

ImageTemplateInVMValidator-objecten

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

Gebruik voor Bestand:

  type = "File"
  destination = "string"
  sha256Checksum = "string"
  sourceUri = "string"

Gebruik voor PowerShell-:

  type = "PowerShell"
  inline = [
    "string"
  ]
  runAsSystem = bool
  runElevated = bool
  scriptUri = "string"
  sha256Checksum = "string"
  validExitCodes = [
    int
  ]

Gebruik voor Shell-:

  type = "Shell"
  inline = [
    "string"
  ]
  scriptUri = "string"
  sha256Checksum = "string"

Eigenschapswaarden

imageTemplates

Naam	Beschrijving	Waarde
type	Het resourcetype	"Microsoft.VirtualMachineImages/imageTemplates@2024-02-01"
naam	De resourcenaam	tekenreeks (vereist)
plaats	De geografische locatie waar de resource zich bevindt	tekenreeks (vereist)
parent_id	Als u wilt implementeren in een resourcegroep, gebruikt u de id van die resourcegroep.	tekenreeks (vereist)
Tags	Resourcetags.	Woordenlijst met tagnamen en -waarden.
identiteit	De identiteit van de afbeeldingssjabloon, indien geconfigureerd.	ImageTemplateIdentity (vereist)
Eigenschappen	De eigenschappen van de afbeeldingssjabloon	ImageTemplateProperties-

ImageTemplateIdentity

Naam	Beschrijving	Waarde
type	Het type identiteit dat wordt gebruikt voor de afbeeldingssjabloon. Met het type None worden alle identiteiten uit de afbeeldingssjabloon verwijderd.	"UserAssigned"
identity_ids	De set door de gebruiker toegewezen identiteiten die aan de resource zijn gekoppeld. De woordenlijstsleutels userAssignedIdentities zijn ARM-resource-id's in de vorm: /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ManagedIdentity/userAssignedIdentities/{identityName}. De waarden van de woordenlijst kunnen lege objecten ({}) zijn in aanvragen.	Matrix van id's van gebruikersidentiteit.

UserAssignedIdentities

Naam	Beschrijving	Waarde
{aangepaste eigenschap}		UserAssignedIdentity-

UserAssignedIdentity

Dit object bevat geen eigenschappen die tijdens de implementatie moeten worden ingesteld. Alle eigenschappen zijn ReadOnly.

ImageTemplateProperties

Naam	Beschrijving	Waarde
autoRun	Hiermee wordt aangegeven of de installatiekopiesjabloon automatisch moet worden uitgevoerd bij het maken of bijwerken van een sjabloon.	ImageTemplateAutoRun
buildTimeoutInMinutes	Maximale duur om te wachten tijdens het bouwen van de afbeeldingssjabloon (inclusief alle aanpassingen, optimalisatie, validaties en distributies). Laat 0 weg of geef 0 op om de standaardwaarde (4 uur) te gebruiken.	Int Beperkingen: Minimumwaarde = 0 Maximumwaarde = 960
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)
errorHandling	Opties voor foutafhandeling bij een buildfout	ImageTemplatePropertiesErrorHandling
managedResourceTags	Tags die worden toegepast op de resourcegroep en/of resources die door de service zijn gemaakt.	object
optimaliseren	Hiermee geeft u optimalisatie moet worden uitgevoerd op de afbeelding.	ImageTemplatePropertiesOptimize
bron	Hiermee geeft u de eigenschappen op die worden gebruikt om de broninstallatiekopieën te beschrijven.	ImageTemplateSource (vereist)
stagingResourceGroup	De id van de faseringsresourcegroep in hetzelfde abonnement als de installatiekopieënsjabloon die wordt gebruikt om de installatiekopieën te bouwen. Als dit veld leeg is, wordt er een resourcegroep met een willekeurige naam gemaakt. Als de resourcegroep die in dit veld is opgegeven niet bestaat, wordt deze gemaakt met dezelfde naam. Als de opgegeven resourcegroep bestaat, moet deze leeg zijn en zich in dezelfde regio bevinden als de afbeeldingssjabloon. De gemaakte resourcegroep wordt verwijderd tijdens het verwijderen van de sjabloon als dit veld leeg is of als de opgegeven resourcegroep niet bestaat, maar als de opgegeven resourcegroep bestaat, worden de resources verwijderd die in de resourcegroep zijn gemaakt tijdens het verwijderen van de sjabloon en blijft de resourcegroep zelf behouden.	snaar
valideren	Configuratieopties en lijst met validaties die moeten worden uitgevoerd op de resulterende afbeelding.	ImageTemplatePropertiesValidate-
vmProfile	Beschrijft hoe de virtuele machine is ingesteld voor het bouwen van installatiekopieën	ImageTemplateVmProfile

ImageTemplateAutoRun

Naam	Beschrijving	Waarde
staat	Als u dit veld inschakelt, wordt automatisch een build geactiveerd voor het maken of bijwerken van een installatiekopiesjabloon.	"Uitgeschakeld" "Ingeschakeld"

ImageTemplateCustomizer

Naam	Beschrijving	Waarde
naam	Beschrijvende naam om context te geven over wat deze aanpassingsstap doet	snaar
type	Het objecttype instellen	bestand PowerShell- Shell- WindowsRestart- WindowsUpdate- (vereist)

ImageTemplateFileCustomizer

Naam	Beschrijving	Waarde
type	Het type aanpassingsprogramma dat u wilt gebruiken op de afbeelding. 'Shell' kan bijvoorbeeld shell-customizer zijn	Bestand (vereist)
bestemming	Het absolute pad naar een bestand (met geneste mapstructuren die al zijn gemaakt) waar het bestand (van sourceUri) naar wordt geüpload in de VIRTUELE machine	snaar
sha256Checksum	SHA256-controlesom van het bestand dat is opgegeven in het bovenstaande bronuri-veld	snaar
sourceUri	De URI van het bestand dat moet worden geüpload voor het aanpassen van de VIRTUELE machine. Het kan een github-koppeling, SAS-URI voor Azure Storage, enzovoort zijn	snaar

ImageTemplatePowerShellCustomizer

Naam	Beschrijving	Waarde
type	Het type aanpassingsprogramma dat u wilt gebruiken op de afbeelding. 'Shell' kan bijvoorbeeld shell-customizer zijn	"PowerShell" (vereist)
Inline	Matrix met PowerShell-opdrachten die moeten worden uitgevoerd	tekenreeks[]
runAsSystem	Als dit is opgegeven, wordt het PowerShell-script uitgevoerd met verhoogde bevoegdheden met behulp van de gebruiker van het lokale systeem. Kan alleen waar zijn wanneer het bovenstaande runElevated-veld is ingesteld op true.	Bool
runElevated	Als dit is opgegeven, wordt het PowerShell-script uitgevoerd met verhoogde bevoegdheden	Bool
scriptUri	URI van het PowerShell-script dat moet worden uitgevoerd voor het aanpassen. Het kan een github-koppeling, SAS-URI voor Azure Storage, enzovoort zijn	snaar
sha256Checksum	SHA256-controlesom van het Power Shell-script dat is opgegeven in het bovenstaande scriptUri-veld	snaar
validExitCodes	Geldige afsluitcodes voor het PowerShell-script. [Standaard: 0]	int[]

ImageTemplateShellCustomizer

Naam	Beschrijving	Waarde
type	Het type aanpassingsprogramma dat u wilt gebruiken op de afbeelding. 'Shell' kan bijvoorbeeld shell-customizer zijn	'Shell' (vereist)
Inline	Matrix van shell-opdrachten die moeten worden uitgevoerd	tekenreeks[]
scriptUri	URI van het shell-script dat moet worden uitgevoerd voor het aanpassen. Het kan een github-koppeling, SAS-URI voor Azure Storage, enzovoort zijn	snaar
sha256Checksum	SHA256-controlesom van het shellscript dat is opgegeven in het scriptUri-veld	snaar

ImageTemplateRestartCustomizer

Naam	Beschrijving	Waarde
type	Het type aanpassingsprogramma dat u wilt gebruiken op de afbeelding. 'Shell' kan bijvoorbeeld shell-customizer zijn	"WindowsRestart" (vereist)
restartCheckCommand	Opdracht om te controleren of opnieuw opstarten is geslaagd [Standaard: '']	snaar
restartCommand	Opdracht om opnieuw opstarten uit te voeren [Standaard: afsluiten /r /f /t /t 0 /c "packer restart""]	snaar
restartTimeout	Time-out voor opnieuw opstarten opgegeven als een tekenreeks van grootte en eenheid, bijvoorbeeld '5m' (5 minuten) of '2h' (2 uur) [Standaard: '5m']	snaar

ImageTemplateWindowsUpdateCustomizer

Naam	Beschrijving	Waarde
type	Het type aanpassingsprogramma dat u wilt gebruiken op de afbeelding. 'Shell' kan bijvoorbeeld shell-customizer zijn	"WindowsUpdate" (vereist)
Filters	Matrix met filters om updates te selecteren die moeten worden toegepast. Laat de lege matrix weg of geef deze op om de standaardwaarde te gebruiken (geen filter). Raadpleeg de bovenstaande koppeling voor voorbeelden en gedetailleerde beschrijving van dit veld.	tekenreeks[]
searchCriteria	Criteria voor het zoeken naar updates. Laat de lege tekenreeks weg of geef deze op om de standaardreeks te gebruiken (zoek alles). Raadpleeg de bovenstaande koppeling voor voorbeelden en gedetailleerde beschrijving van dit veld.	snaar
updateLimit	Maximum aantal updates dat tegelijk moet worden toegepast. Laat 0 weg of geef 0 op om de standaardwaarde te gebruiken (1000)	Int Beperkingen: Minimumwaarde = 0

ImageTemplateDistributor

Naam	Beschrijving	Waarde
artifactTags	Tags die worden toegepast op het artefact nadat het is gemaakt/bijgewerkt door de distributeur.	object
runOutputName	De naam die moet worden gebruikt voor de bijbehorende RunOutput.	tekenreeks (vereist) Beperkingen: Patroon = ^[A-Za-z0-9-_.]{1,64}$
type	Het objecttype instellen	ManagedImage- SharedImage- VHD- (vereist)

ImageTemplateManagedImageDistributor

Naam	Beschrijving	Waarde
type	Type distributie.	ManagedImage (vereist)
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)

ImageTemplateSharedImageDistributor

Naam	Beschrijving	Waarde
type	Type distributie.	SharedImage (vereist)
excludeFromLatest	Vlag die aangeeft of de gemaakte installatiekopieënversie moet worden uitgesloten van de meest recente versie. Weglaten om de standaardwaarde (onwaar) te gebruiken.	Bool
galleryImageId	Resource-id van de azure Compute Gallery-installatiekopieën	tekenreeks (vereist)
replicationRegions	[Afgeschaft] Een lijst met regio's waarnaar de installatiekopieën worden gerepliceerd. Deze lijst kan alleen worden opgegeven als targetRegions niet is opgegeven. Dit veld is afgeschaft. Gebruik in plaats daarvan targetRegions.	tekenreeks[]
storageAccountType	[Afgeschaft] Het type opslagaccount dat moet worden gebruikt voor het opslaan van de gedeelde installatiekopie. Laat het gebruik van de standaardwaarde weg (Standard_LRS). Dit veld kan alleen worden opgegeven als replicationRegions is opgegeven. Dit veld is afgeschaft. Gebruik in plaats daarvan targetRegions.	"Premium_LRS" "Standard_LRS" "Standard_ZRS"
targetRegions	De doelregio's waarnaar de gedistribueerde versie van de installatiekopieën wordt gerepliceerd. Dit object vervangt replicationRegions en kan alleen worden opgegeven als replicationRegions niet is opgegeven.	TargetRegion[]
versiebeheer	Hierin wordt beschreven hoe u een nieuw x.y.z-versienummer voor distributie genereert.	DistributeVersioner-

TargetRegion

Naam	Beschrijving	Waarde
naam	De naam van de regio.	tekenreeks (vereist)
replicaCount	Het aantal replica's van de versie van de installatiekopieën dat in deze regio moet worden gemaakt. Laat het gebruik van de standaardwaarde weg (1).	Int Beperkingen: Minimumwaarde = 1
storageAccountType	Hiermee geeft u het type opslagaccount op dat moet worden gebruikt voor het opslaan van de installatiekopie in deze regio. Laat het gebruik van de standaardwaarde weg (Standard_LRS).	"Premium_LRS" "Standard_LRS" "Standard_ZRS"

DistributeVersioner

Naam	Beschrijving	Waarde
plan	Het objecttype instellen	meest recente bron- (vereist)

DistributeVersionerLatest

Naam	Beschrijving	Waarde
plan	Versienummeringsschema dat moet worden gebruikt.	'Nieuwste' (vereist)
majoor	Primaire versie voor het gegenereerde versienummer. Bepaal wat 'nieuwste' is op basis van versies met deze waarde als primaire versie. -1 is gelijk aan het verlaten ervan.	Int

DistributeVersionerSource

Naam	Beschrijving	Waarde
plan	Versienummeringsschema dat moet worden gebruikt.	"Bron" (vereist)

ImageTemplateVhdDistributor

Naam	Beschrijving	Waarde
type	Type distributie.	"VHD" (vereist)
Uri	Optionele Azure Storage-URI voor de gedistribueerde VHD-blob. Laat het gebruik van de standaardwaarde (lege tekenreeks) weg. In dat geval wordt VHD gepubliceerd naar het opslagaccount in de faseringsresourcegroep.	snaar

ImageTemplatePropertiesErrorHandling

Naam	Beschrijving	Waarde
onCustomizerError	Als er een aanpasserfout optreedt en dit veld is ingesteld op op opschonen, worden de build-VM en de bijbehorende netwerkbronnen opgeschoond. Dit is het standaardgedrag. Als er een aanpasserfout optreedt en dit veld is ingesteld op afbreken, blijft de build-VM behouden.	"afgebroken" "opschonen"
onValidationError	Als er een validatiefout optreedt en dit veld is ingesteld op op opschonen, worden de build-VM en de bijbehorende netwerkbronnen opgeschoond. Dit is het standaardgedrag. Als er een validatiefout is en dit veld is ingesteld op 'afbreken', blijft de build-VM behouden.	"afgebroken" "opschonen"

ImageTemplatePropertiesOptimize

Naam	Beschrijving	Waarde
vmBoot	Optimalisatie wordt toegepast op de installatiekopie voor een snellere vm-opstartbewerking.	ImageTemplatePropertiesOptimizeVmBoot

ImageTemplatePropertiesOptimizeVmBoot

Naam	Beschrijving	Waarde
staat	Als u dit veld inschakelt, wordt de opstarttijd van de VIRTUELE machine verbeterd door de uiteindelijke aangepaste uitvoer van de installatiekopie te optimaliseren.	"Uitgeschakeld" "Ingeschakeld"

ImageTemplateSource

Naam	Beschrijving	Waarde
type	Het objecttype instellen	ManagedImage- PlatformImage- SharedImageVersion (vereist)

ImageTemplateManagedImageSource

Naam	Beschrijving	Waarde
type	Hiermee geeft u het type broninstallatiekopie waarmee u wilt beginnen.	ManagedImage (vereist)
imageId	ARM-resource-id van de beheerde installatiekopieën in het klantabonnement	tekenreeks (vereist)

ImageTemplatePlatformImageSource

Naam	Beschrijving	Waarde
type	Hiermee geeft u het type broninstallatiekopie waarmee u wilt beginnen.	"PlatformImage" (vereist)
aanbieden	Afbeeldingsaanbieding uit de Azure Gallery Images.	snaar
planInfo	Optionele configuratie van aankoopplan voor platforminstallatiekopieën.	PlatformImagePurchasePlan
uitgever	Image Publisher in Azure Gallery Images.	snaar
Sku	Afbeeldingsku uit de Azure Gallery-installatiekopieën.	snaar
Versie	Installatiekopieën van de Azure Gallery-installatiekopieën. Als hier 'nieuwste' is opgegeven, wordt de versie geëvalueerd wanneer de installatiekopieën worden gebouwd, niet wanneer de sjabloon wordt verzonden.	snaar

PlatformImagePurchasePlan

Naam	Beschrijving	Waarde
planName	Naam van het aankoopplan.	tekenreeks (vereist)
planProduct	Product van het aankoopplan.	tekenreeks (vereist)
planPublisher	Uitgever van het aankoopplan.	tekenreeks (vereist)

ImageTemplateSharedImageVersionSource

Naam	Beschrijving	Waarde
type	Hiermee geeft u het type broninstallatiekopie waarmee u wilt beginnen.	"SharedImageVersion" (vereist)
imageVersionId	ARM-resource-id van de versie van de installatiekopieën. Wanneer de naam van de installatiekopieënversie 'nieuwste' is, wordt de versie geëvalueerd wanneer de installatiekopieën worden gebouwd.	tekenreeks (vereist)

ImageTemplatePropertiesValidate

Naam	Beschrijving	Waarde
continueDistributeOnFailure	Als de validatie mislukt en dit veld is ingesteld op false, worden de uitvoerafbeeldingen niet gedistribueerd. Dit is het standaardgedrag. Als de validatie mislukt en dit veld is ingesteld op true, worden uitvoerafbeeldingen nog steeds gedistribueerd. Gebruik deze optie met voorzichtigheid, omdat dit kan leiden tot slechte installatiekopieën die voor gebruik worden gedistribueerd. In beide gevallen (waar of onwaar) wordt de end-to-end-installatiekopieuitvoering gerapporteerd als mislukt in het geval van een validatiefout. [Opmerking: dit veld heeft geen effect als de validatie slaagt.]	Bool
inVMValidations	Lijst met validaties die moeten worden uitgevoerd.	ImageTemplateInVMValidator[]
sourceValidationOnly	Als dit veld is ingesteld op true, wordt de afbeelding die is opgegeven in de sectie Bron rechtstreeks gevalideerd. Er wordt geen afzonderlijke build uitgevoerd om een aangepaste installatiekopieën te genereren en vervolgens te valideren.	Bool

ImageTemplateInVMValidator

Naam	Beschrijving	Waarde
naam	Beschrijvende naam om context op te geven over wat deze validatiestap doet	snaar
type	Het objecttype instellen	bestand PowerShell- Shell- (vereist)

ImageTemplateFileValidator

Naam	Beschrijving	Waarde
type	Het type validatie dat u wilt gebruiken op de afbeelding. Shell kan bijvoorbeeld shellvalidatie zijn	Bestand (vereist)
bestemming	Het absolute pad naar een bestand (met geneste mapstructuren die al zijn gemaakt) waar het bestand (van sourceUri) naar wordt geüpload in de VIRTUELE machine	snaar
sha256Checksum	SHA256-controlesom van het bestand dat is opgegeven in het bovenstaande bronuri-veld	snaar
sourceUri	De URI van het bestand dat moet worden geüpload naar de VIRTUELE machine voor validatie. Het kan een github-koppeling, Azure Storage-URI (geautoriseerd of SAS) zijn, enzovoort	snaar

ImageTemplatePowerShellValidator

Naam	Beschrijving	Waarde
type	Het type validatie dat u wilt gebruiken op de afbeelding. Shell kan bijvoorbeeld shellvalidatie zijn	"PowerShell" (vereist)
Inline	Matrix met PowerShell-opdrachten die moeten worden uitgevoerd	tekenreeks[]
runAsSystem	Als dit is opgegeven, wordt het PowerShell-script uitgevoerd met verhoogde bevoegdheden met behulp van de gebruiker van het lokale systeem. Kan alleen waar zijn wanneer het bovenstaande runElevated-veld is ingesteld op true.	Bool
runElevated	Als dit is opgegeven, wordt het PowerShell-script uitgevoerd met verhoogde bevoegdheden	Bool
scriptUri	URI van het PowerShell-script dat moet worden uitgevoerd voor validatie. Dit kan een github-koppeling, Azure Storage-URI, enzovoort zijn	snaar
sha256Checksum	SHA256-controlesom van het Power Shell-script dat is opgegeven in het bovenstaande scriptUri-veld	snaar
validExitCodes	Geldige afsluitcodes voor het PowerShell-script. [Standaard: 0]	int[]

ImageTemplateShellValidator

Naam	Beschrijving	Waarde
type	Het type validatie dat u wilt gebruiken op de afbeelding. Shell kan bijvoorbeeld shellvalidatie zijn	'Shell' (vereist)
Inline	Matrix van shell-opdrachten die moeten worden uitgevoerd	tekenreeks[]
scriptUri	URI van het shellscript dat moet worden uitgevoerd voor validatie. Dit kan een github-koppeling, Azure Storage-URI, enzovoort zijn	snaar
sha256Checksum	SHA256-controlesom van het shellscript dat is opgegeven in het scriptUri-veld	snaar

ImageTemplateVmProfile

Naam	Beschrijving	Waarde
osDiskSizeGB	Grootte van de besturingssysteemschijf in GB. Laat 0 weg of geef 0 op om de standaardschijfgrootte van het besturingssysteem van Azure te gebruiken.	Int Beperkingen: Minimumwaarde = 0
userAssignedIdentities	Optionele matrix van resource-id's van door de gebruiker toegewezen beheerde identiteiten die moeten worden geconfigureerd op de build-VM en validatie-VM. Dit kan de identiteit van de afbeeldingssjabloon zijn.	tekenreeks[]
vmSize	Grootte van de virtuele machine die wordt gebruikt voor het bouwen, aanpassen en vastleggen van installatiekopieën. Laat de lege tekenreeks weg of geef deze op om de standaardreeks te gebruiken (Standard_D1_v2 voor Gen1-installatiekopieën en Standard_D2ds_v4 voor Gen2-afbeeldingen).	snaar
vnetConfig	Optionele configuratie van het virtuele netwerk dat moet worden gebruikt voor het implementeren van de build-VM en validatie-VM in. Weglaten als er geen specifiek virtueel netwerk moet worden gebruikt.	VirtualNetworkConfig-

VirtualNetworkConfig

Naam	Beschrijving	Waarde
containerInstanceSubnetId	Resource-id van een bestaand subnet waarop Azure Container Instance wordt geïmplementeerd voor geïsoleerde builds. Dit veld mag alleen worden opgegeven als subnetId ook is opgegeven en moet zich in hetzelfde virtuele netwerk bevinden als het subnet dat is opgegeven in subnetId.	snaar
proxyVmSize	De grootte van de virtuele proxymachine die wordt gebruikt om verkeer door te geven aan de build-VM en validatie-VM. Dit mag niet worden opgegeven als containerInstanceSubnetId is opgegeven omdat er in dat geval geen virtuele proxymachine wordt geïmplementeerd. Laat de lege tekenreeks weg of geef deze op om de standaardwaarde te gebruiken (Standard_A1_v2).	snaar
subnetId	Resource-id van een bestaand subnet waarop de build-VM en validatie-VM worden geïmplementeerd	snaar