Microsoft.VirtualMachineImages imageTemplates

Bicep-resursdefinition

Resurstypen imageTemplates kan distribueras till:

En lista över ändrade egenskaper i varje API-version finns i ändringsloggen.

Resursformat

Om du vill skapa en Microsoft.VirtualMachineImages/imageTemplates-resurs lägger du till följande Bicep i mallen.

resource symbolicname 'Microsoft.VirtualMachineImages/imageTemplates@2022-02-14' = {
  name: 'string'
  location: 'string'
  tags: {
    tagName1: 'tagValue1'
    tagName2: 'tagValue2'
  }
  identity: {
    type: 'string'
    userAssignedIdentities: {}
  }
  properties: {
    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
      }
    ]
    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: {
        proxyVmSize: 'string'
        subnetId: 'string'
      }
    }
  }
}

ImageTemplateCustomizer-objekt

Ange typegenskapen för att ange typ av objekt.

För Fil använder du:

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

För PowerShell använder du:

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

För Shell använder du:

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

För WindowsRestart använder du:

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

För WindowsUpdate använder du:

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

ImageTemplateDistributor-objekt

Ange typegenskapen för att ange typ av objekt.

För ManagedImage använder du:

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

För SharedImage använder du:

  type: 'SharedImage'
  excludeFromLatest: bool
  galleryImageId: 'string'
  replicationRegions: [
    'string'
  ]
  storageAccountType: 'string'

För VHD använder du:

  type: 'VHD'

ImageTemplateSource-objekt

Ange typegenskapen för att ange typ av objekt.

För ManagedImage använder du:

  type: 'ManagedImage'
  imageId: 'string'

För PlatformImage använder du:

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

För SharedImageVersion använder du:

  type: 'SharedImageVersion'
  imageVersionId: 'string'

ImageTemplateInVMValidator-objekt

Ange typegenskapen för att ange typ av objekt.

För PowerShell använder du:

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

För Shell använder du:

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

Egenskapsvärden

imageTemplates

Name Beskrivning Värde
name Resursnamnet sträng (krävs)
location Den geo-plats där resursen finns sträng (krävs)
tags Resurstaggar. Ordlista med taggnamn och värden. Se Taggar i mallar
identity Identiteten för avbildningsmallen, om den har konfigurerats. ImageTemplateIdentity (krävs)
properties Egenskaperna för bildmallen ImageTemplateProperties

ImageTemplateIdentity

Name Beskrivning Värde
typ Den typ av identitet som används för avbildningsmallen. Typen None (Ingen) tar bort alla identiteter från bildmallen. "Ingen"
"Användartilldelade"
userAssignedIdentities Listan över användaridentiteter som är associerade med avbildningsmallen. Nyckelreferenserna för användaridentitetsordlistan är ARM-resurs-ID:er i formatet: '/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ManagedIdentity/userAssignedIdentities/{identityName}'. objekt

ImageTemplateProperties

Name Beskrivning Värde
buildTimeoutInMinutes Maximal väntetid när du skapar avbildningsmallen (omfattar alla anpassningar, valideringar och distributioner). Utelämna eller ange 0 för att använda standardvärdet (4 timmar). int
Anpassa Anger de egenskaper som används för att beskriva anpassningsstegen för bilden, t.ex. bildkälla osv. ImageTemplateCustomizer[]
Distribuera Distributionen är avsedd för var avbildningens utdata ska gå. ImageTemplateDistributor[] (krävs)
källa Anger de egenskaper som används för att beskriva källbilden. ImageTemplateSource (krävs)
stagingResourceGroup Resursgrupps-ID:t för mellanlagring i samma prenumeration som avbildningsmallen som ska användas för att skapa avbildningen. Om det här fältet är tomt skapas en resursgrupp med ett slumpmässigt namn. Om resursgruppen som anges i det här fältet inte finns skapas den med samma namn. Om den angivna resursgruppen finns måste den vara tom och i samma region som avbildningsmallen. Resursgruppen som skapas tas bort under borttagningen av mallen om det här fältet är tomt eller om den angivna resursgruppen inte finns, men om den angivna resursgruppen finns tas resurserna som skapades i resursgruppen bort under borttagningen av mallen och själva resursgruppen finns kvar. sträng
validate Konfigurationsalternativ och lista över valideringar som ska utföras på den resulterande avbildningen. ImageTemplatePropertiesValidate
vmProfile Beskriver hur den virtuella datorn är konfigurerad för att skapa avbildningar ImageTemplateVmProfile

ImageTemplateCustomizer

Name Beskrivning Värde
name Eget namn för att ge kontext om vad det här anpassningssteget gör sträng
typ Ange objekttyp Fil
PowerShell
Gränssnitt
WindowsRestart
WindowsUpdate (krävs)

ImageTemplateFileCustomizer

Name Beskrivning Värde
typ Den typ av anpassningsverktyg som du vill använda på avbildningen. Till exempel kan "Shell" vara gränssnittsanpassare "Fil" (krävs)
mål Den absoluta sökvägen till en fil (med kapslade katalogstrukturer som redan har skapats) där filen (från sourceUri) laddas upp till på den virtuella datorn sträng
sha256Checksum SHA256-kontrollsumma för filen som anges i sourceUri-fältet ovan sträng
sourceUri URI:n för filen som ska laddas upp för att anpassa den virtuella datorn. Det kan vara en github-länk, SAS-URI för Azure Storage osv. sträng

ImageTemplatePowerShellCustomizer

Name Beskrivning Värde
typ Den typ av anpassningsverktyg som du vill använda på avbildningen. Till exempel kan "Shell" vara gränssnittsanpassare "PowerShell" (krävs)
inline Matris med PowerShell-kommandon som ska köras string[]
runAsSystem Om det anges körs PowerShell-skriptet med förhöjd behörighet med hjälp av den lokala systemanvändaren. Kan bara vara sant när fältet runElevated ovan är inställt på true. boolesk
runElevated Om det anges körs PowerShell-skriptet med förhöjd behörighet boolesk
scriptUri URI för PowerShell-skriptet som ska köras för anpassning. Det kan vara en github-länk, SAS-URI för Azure Storage osv. sträng
sha256Checksum SHA256-kontrollsumma för power shell-skriptet som anges i fältet scriptUri ovan sträng
validExitCodes Giltiga slutkoder för PowerShell-skriptet. [Standard: 0] int[]

ImageTemplateShellCustomizer

Name Beskrivning Värde
typ Den typ av anpassningsverktyg som du vill använda på avbildningen. Till exempel kan "Shell" vara gränssnittsanpassare "Shell" (krävs)
inline Matris med gränssnittskommandon som ska köras string[]
scriptUri URI för shell-skriptet som ska köras för anpassning. Det kan vara en github-länk, SAS-URI för Azure Storage osv. sträng
sha256Checksum SHA256-kontrollsumma för shell-skriptet som anges i fältet scriptUri sträng

ImageTemplateRestartCustomizer

Name Beskrivning Värde
typ Den typ av anpassningsverktyg som du vill använda på avbildningen. Till exempel kan "Shell" vara gränssnittsanpassare "WindowsRestart" (krävs)
restartCheckCommand Kommando för att kontrollera om omstarten lyckades [Standard: ''] sträng
restartCommand Kommando för att köra omstarten [Standard: 'shutdown /r /f /t 0 /c "packer restart"'] sträng
restartTimeout Tidsgränsen för omstart anges som en storlekssträng och enhet, t.ex. 5 m (5 minuter) eller 2 timmar [Standard: 5 m] sträng

ImageTemplateWindowsUpdateCustomizer

Name Beskrivning Värde
typ Den typ av anpassningsverktyg som du vill använda på avbildningen. Till exempel kan "Shell" vara gränssnittsanpassare "WindowsUpdate" (krävs)
filter Matris med filter för att välja uppdateringar som ska tillämpas. Utelämna eller ange en tom matris för att använda standardvärdet (inget filter). Se länken ovan för exempel och detaljerad beskrivning av det här fältet. string[]
searchCriteria Kriterier för att söka efter uppdateringar. Utelämna eller ange en tom sträng för att använda standardvärdet (sök alla). Se länken ovan för exempel och detaljerad beskrivning av det här fältet. sträng
updateLimit Maximalt antal uppdateringar som ska tillämpas åt gången. Utelämna eller ange 0 för att använda standardvärdet (1 000) int

ImageTemplateDistributor

Name Beskrivning Värde
artifactTags Taggar som tillämpas på artefakten när den har skapats/uppdaterats av distributören. objekt
runOutputName Namnet som ska användas för det associerade RunOutput. sträng (krävs)
typ Ange objekttyp ManagedImage
SharedImage
VHD (krävs)

ImageTemplateManagedImageDistributor

Name Beskrivning Värde
typ Typ av distribution. "ManagedImage" (krävs)
Imageid Resurs-ID för managed disk-avbildningen sträng (krävs)
location Azure-platsen för avbildningen ska matcha om avbildningen redan finns sträng (krävs)

ImageTemplateSharedImageDistributor

Name Beskrivning Värde
typ Typ av distribution. "SharedImage" (krävs)
excludeFromLatest Flagga som anger om den skapade avbildningsversionen ska undantas från den senaste versionen. Utelämna att använda standardvärdet (false). boolesk
galleryImageId Resurs-ID för Shared Image Gallery-avbildningen sträng (krävs)
replicationRegions En lista över regioner som avbildningen ska replikeras till string[] (krävs)
storageAccountType Lagringskontotyp som ska användas för att lagra den delade avbildningen. Utelämna att använda standardvärdet (Standard_LRS). "Standard_LRS"
"Standard_ZRS"

ImageTemplateVhdDistributor

Name Beskrivning Värde
typ Typ av distribution. "VHD" (krävs)

ImageTemplateSource

Name Beskrivning Värde
typ Ange objekttyp ManagedImage
PlatformImage
SharedImageVersion (obligatoriskt)

ImageTemplateManagedImageSource

Name Beskrivning Värde
typ Anger vilken typ av källbild du vill börja med. "ManagedImage" (krävs)
Imageid ARM-resurs-ID för den hanterade avbildningen i kundprenumerationen sträng (krävs)

ImageTemplatePlatformImageSource

Name Beskrivning Värde
typ Anger vilken typ av källbild du vill börja med. "PlatformImage" (krävs)
offer Bilderbjudande från Azure Gallery Images. sträng
planInfo Valfri konfiguration av inköpsplan för plattformsbild. PlatformImagePurchasePlan
utgivare Image Publisher i Azure Gallery Images. sträng
sku Avbildnings-SKU från Azure Gallery Images. sträng
version Avbildningsversion från Azure Gallery Images. Om "senaste" anges här utvärderas versionen när avbildningsversionen sker, inte när mallen skickas. sträng

PlatformImagePurchasePlan

Name Beskrivning Värde
planName Namnet på inköpsplanen. sträng (krävs)
planProduct Produkt av köpplanen. sträng (krävs)
planPublisher Utgivare av inköpsplanen. sträng (krävs)

ImageTemplateSharedImageVersionSource

Name Beskrivning Värde
typ Anger vilken typ av källbild du vill börja med. "SharedImageVersion" (krävs)
imageVersionId ARM-resurs-ID för avbildningsversionen i det delade bildgalleriet sträng (krävs)

ImageTemplatePropertiesValidate

Name Beskrivning Värde
continueDistributeOnFailure Om verifieringen misslyckas och det här fältet är inställt på falskt distribueras inte utdatabilder. Det här är standardbeteendet. Om verifieringen misslyckas och det här fältet är inställt på sant distribueras utdatabilder fortfarande. Använd det här alternativet med försiktighet eftersom det kan leda till att felaktiga bilder distribueras för användning. I båda fallen (sant eller falskt) rapporteras avbildningskörningen från slutpunkt till slutpunkt som misslyckad vid valideringsfel. [Obs! Det här fältet har ingen effekt om valideringen lyckas.] boolesk
inVMValidations Lista över valideringar som ska utföras. ImageTemplateInVMValidator[]
sourceValidationOnly Om det här fältet är inställt på sant verifieras den avbildning som anges i avsnittet "källa". Ingen separat version kommer att köras för att generera och sedan validera en anpassad avbildning. boolesk

ImageTemplateInVMValidator

Name Beskrivning Värde
name Eget namn för att ge kontext om vad det här valideringssteget gör sträng
typ Ange objekttyp PowerShell
Gränssnitt (krävs)

ImageTemplatePowerShellValidator

Name Beskrivning Värde
typ Den typ av validering som du vill använda på avbildningen. "Shell" kan till exempel vara gränssnittsvalidering "PowerShell" (krävs)
inline Matris med PowerShell-kommandon som ska köras string[]
runAsSystem Om det anges körs PowerShell-skriptet med förhöjd behörighet med hjälp av den lokala systemanvändaren. Kan bara vara sant när fältet runElevated ovan är inställt på true. boolesk
runElevated Om det anges körs PowerShell-skriptet med förhöjd behörighet boolesk
scriptUri URI för PowerShell-skriptet som ska köras för validering. Det kan vara en github-länk, Azure Storage-URI osv. sträng
sha256Checksum SHA256-kontrollsumma för power shell-skriptet som anges i fältet scriptUri ovan sträng
validExitCodes Giltiga slutkoder för PowerShell-skriptet. [Standard: 0] int[]

ImageTemplateShellValidator

Name Beskrivning Värde
typ Den typ av validering som du vill använda på bilden. Till exempel kan "Shell" vara gränssnittsvalidering "Shell" (krävs)
inline Matris med gränssnittskommandon som ska köras string[]
scriptUri URI för shell-skriptet som ska köras för validering. Det kan vara en github-länk, Azure Storage-URI osv. sträng
sha256Checksum SHA256-kontrollsumma för shell-skriptet som tillhandahålls i fältet scriptUri sträng

ImageTemplateVmProfile

Name Beskrivning Värde
osDiskSizeGB Storleken på OS-disken i GB. Utelämna eller ange 0 för att använda Azures standardstorlek för OS-diskar. int
userAssignedIdentities Valfri matris med resurs-ID:n för användartilldelade hanterade identiteter som ska konfigureras på den virtuella byggdatorn och den virtuella valideringsdatorn. Detta kan omfatta bildmallens identitet. string[]
vmSize Storleken på den virtuella dator som används för att skapa, anpassa och avbilda avbildningar. Utelämna eller ange tom sträng för att använda standardvärdet (Standard_D1_v2 för Gen1-bilder och Standard_D2ds_v4 för Gen2-avbildningar). sträng
vnetConfig Valfri konfiguration av det virtuella nätverket som ska användas för att distribuera den virtuella byggdatorn och den virtuella valideringsdatorn i. Utelämna om inget specifikt virtuellt nätverk behöver användas. VirtualNetworkConfig

VirtualNetworkConfig

Name Beskrivning Värde
proxyVmSize Storleken på den virtuella proxydatorn som används för att skicka trafik till den virtuella byggdatorn och den virtuella valideringsdatorn. Utelämna eller ange en tom sträng för att använda standardvärdet (Standard_A1_v2). sträng
subnetId Resurs-ID för ett befintligt undernät. sträng

Snabbstartsmallar

Följande snabbstartsmallar distribuerar den här resurstypen.

Mall Description
Azure Image Builder med Azure Windows-baslinje

Distribuera till Azure
Skapar en Azure Image Builder-miljö och skapar en Windows Server-avbildning med den senaste Windows-Uppdateringar och Azure Windows-baslinjen tillämpad.
Konfigurera Dev Box-tjänsten

Distribuera till Azure
Den här mallen skapar alla Dev Box-administratörsresurser enligt snabbstartsguiden för Dev Box. Du kan visa alla resurser som skapats eller gå direkt till DevPortal.microsoft.com för att skapa din första Dev Box.

Resursdefinition för ARM-mall

Resurstypen imageTemplates kan distribueras till:

En lista över ändrade egenskaper i varje API-version finns i ändringsloggen.

Resursformat

Om du vill skapa en Microsoft.VirtualMachineImages/imageTemplates-resurs lägger du till följande JSON i mallen.

{
  "type": "Microsoft.VirtualMachineImages/imageTemplates",
  "apiVersion": "2022-02-14",
  "name": "string",
  "location": "string",
  "tags": {
    "tagName1": "tagValue1",
    "tagName2": "tagValue2"
  },
  "identity": {
    "type": "string",
    "userAssignedIdentities": {}
  },
  "properties": {
    "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
      }
    ],
    "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": {
        "proxyVmSize": "string",
        "subnetId": "string"
      }
    }
  }
}

ImageTemplateCustomizer-objekt

Ange typegenskapen för att ange typ av objekt.

För Fil använder du:

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

För PowerShell använder du:

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

För Shell använder du:

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

För WindowsRestart använder du:

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

För WindowsUpdate använder du:

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

ImageTemplateDistributor-objekt

Ange typegenskapen för att ange typ av objekt.

För ManagedImage använder du:

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

För SharedImage använder du:

  "type": "SharedImage",
  "excludeFromLatest": "bool",
  "galleryImageId": "string",
  "replicationRegions": [ "string" ],
  "storageAccountType": "string"

För VHD använder du:

  "type": "VHD"

ImageTemplateSource-objekt

Ange typegenskapen för att ange typ av objekt.

För ManagedImage använder du:

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

För PlatformImage använder du:

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

För SharedImageVersion använder du:

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

ImageTemplateInVMValidator-objekt

Ange typegenskapen för att ange typ av objekt.

För PowerShell använder du:

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

För Shell använder du:

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

Egenskapsvärden

imageTemplates

Name Beskrivning Värde
typ Resurstypen "Microsoft.VirtualMachineImages/imageTemplates"
apiVersion Resurs-API-versionen '2022-02-14'
name Resursnamnet sträng (krävs)
location Den geo-plats där resursen finns sträng (krävs)
tags Resurstaggar. Ordlista med taggnamn och värden. Se Taggar i mallar
identity Identiteten för avbildningsmallen, om den är konfigurerad. ImageTemplateIdentity (krävs)
properties Egenskaperna för bildmallen ImageTemplateProperties

ImageTemplateIdentity

Name Beskrivning Värde
typ Den typ av identitet som används för bildmallen. Typen "Ingen" tar bort alla identiteter från bildmallen. "Ingen"
"Användartilldelade"
userAssignedIdentities Listan över användaridentiteter som är associerade med bildmallen. Nyckelreferenserna för användaridentitetsordlistan är ARM-resurs-ID:er i formatet: '/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ManagedIdentity/userAssignedIdentities/{identityName}'. objekt

ImageTemplateProperties

Name Beskrivning Värde
buildTimeoutInMinutes Maximal väntetid när du skapar avbildningsmallen (omfattar alla anpassningar, valideringar och distributioner). Utelämna eller ange 0 för att använda standardvärdet (4 timmar). int
Anpassa Anger de egenskaper som används för att beskriva anpassningsstegen för bilden, till exempel Bildkälla osv. ImageTemplateCustomizer[]
Distribuera Distributionen riktar sig till de avbildningsutdata som ska gå till. ImageTemplateDistributor[] (krävs)
källa Anger de egenskaper som används för att beskriva källavbildningen. ImageTemplateSource (krävs)
stagingResourceGroup Mellanlagringsresursgruppens ID i samma prenumeration som avbildningsmallen som ska användas för att skapa avbildningen. Om det här fältet är tomt skapas en resursgrupp med ett slumpmässigt namn. Om resursgruppen som anges i det här fältet inte finns skapas den med samma namn. Om den angivna resursgruppen finns måste den vara tom och i samma region som bildmallen. Den skapade resursgruppen tas bort under borttagningen av mallen om det här fältet är tomt eller om den angivna resursgruppen inte finns, men om den angivna resursgruppen finns tas resurserna som skapats i resursgruppen bort under borttagningen av mallen och själva resursgruppen blir kvar. sträng
validate Konfigurationsalternativ och lista över valideringar som ska utföras på den resulterande avbildningen. ImageTemplatePropertiesValidate
vmProfile Beskriver hur en virtuell dator har konfigurerats för att skapa avbildningar ImageTemplateVmProfile

ImageTemplateCustomizer

Name Beskrivning Värde
name Eget namn för att ge kontext för vad det här anpassningssteget gör sträng
typ Ange objekttyp Fil
PowerShell
Gränssnitt
WindowsRestart
WindowsUpdate (krävs)

ImageTemplateFileCustomizer

Name Beskrivning Värde
typ Den typ av anpassningsverktyg som du vill använda på avbildningen. Till exempel kan "Shell" vara gränssnittsanpassare "Fil" (krävs)
mål Den absoluta sökvägen till en fil (med kapslade katalogstrukturer som redan har skapats) där filen (från sourceUri) laddas upp till på den virtuella datorn sträng
sha256Checksum SHA256-kontrollsumma för filen som anges i sourceUri-fältet ovan sträng
sourceUri URI:n för filen som ska laddas upp för att anpassa den virtuella datorn. Det kan vara en github-länk, SAS-URI för Azure Storage osv. sträng

ImageTemplatePowerShellCustomizer

Name Beskrivning Värde
typ Den typ av anpassningsverktyg som du vill använda på avbildningen. Till exempel kan "Shell" vara gränssnittsanpassare "PowerShell" (krävs)
inline Matris med PowerShell-kommandon som ska köras string[]
runAsSystem Om det anges körs PowerShell-skriptet med förhöjd behörighet med hjälp av den lokala systemanvändaren. Kan bara vara sant när fältet runElevated ovan är inställt på true. boolesk
runElevated Om det anges körs PowerShell-skriptet med förhöjd behörighet boolesk
scriptUri URI för PowerShell-skriptet som ska köras för anpassning. Det kan vara en github-länk, SAS-URI för Azure Storage osv. sträng
sha256Checksum SHA256-kontrollsumma för power shell-skriptet som anges i fältet scriptUri ovan sträng
validExitCodes Giltiga slutkoder för PowerShell-skriptet. [Standard: 0] int[]

ImageTemplateShellCustomizer

Name Beskrivning Värde
typ Den typ av anpassningsverktyg som du vill använda på avbildningen. Till exempel kan "Shell" vara gränssnittsanpassare "Shell" (krävs)
inline Matris med gränssnittskommandon som ska köras string[]
scriptUri URI för det gränssnittsskript som ska köras för anpassning. Det kan vara en github-länk, SAS-URI för Azure Storage osv. sträng
sha256Checksum SHA256-kontrollsumma för shell-skriptet som tillhandahålls i fältet scriptUri sträng

ImageTemplateRestartCustomizer

Name Beskrivning Värde
typ Den typ av anpassningsverktyg som du vill använda på avbildningen. Till exempel kan "Shell" vara gränssnittsanpassare "WindowsRestart" (krävs)
restartCheckCommand Kommando för att kontrollera om omstarten lyckades [Standard: ''] sträng
restartCommand Kommando för att köra omstarten [Standard: 'shutdown /r /f /t 0 /c "packer restart"'] sträng
restartTimeout Tidsgränsen för omstart anges som en storlekssträng och enhet, t.ex. "5m" (5 minuter) eller "2h" (2 timmar) [Standard: "5m"] sträng

ImageTemplateWindowsUpdateCustomizer

Name Beskrivning Värde
typ Den typ av anpassningsverktyg som du vill använda på avbildningen. Till exempel kan "Shell" vara gränssnittsanpassare "WindowsUpdate" (krävs)
filter Matris med filter för att välja uppdateringar som ska tillämpas. Utelämna eller ange en tom matris för att använda standardvärdet (inget filter). Se länken ovan för exempel och detaljerad beskrivning av det här fältet. string[]
searchCriteria Kriterier för att söka efter uppdateringar. Utelämna eller ange en tom sträng för att använda standardvärdet (sök alla). Se länken ovan för exempel och detaljerad beskrivning av det här fältet. sträng
updateLimit Maximalt antal uppdateringar som ska tillämpas åt gången. Utelämna eller ange 0 för att använda standardvärdet (1 000) int

ImageTemplateDistributor

Name Beskrivning Värde
artifactTags Taggar som ska tillämpas på artefakten när den har skapats/uppdaterats av distributören. objekt
runOutputName Namnet som ska användas för det associerade RunOutput. sträng (krävs)
typ Ange objekttyp ManagedImage
SharedImage
VHD (krävs)

ImageTemplateManagedImageDistributor

Name Beskrivning Värde
typ Typ av distribution. "ManagedImage" (krävs)
Imageid Resurs-ID för managed disk-avbildningen sträng (krävs)
location Azure-platsen för avbildningen ska matcha om avbildningen redan finns sträng (krävs)

ImageTemplateSharedImageDistributor

Name Beskrivning Värde
typ Typ av distribution. "SharedImage" (krävs)
excludeFromLatest Flagga som anger om den skapade avbildningsversionen ska undantas från den senaste versionen. Utelämna att använda standardvärdet (false). boolesk
galleryImageId Resurs-ID för Shared Image Gallery-avbildningen sträng (krävs)
replicationRegions En lista över regioner som avbildningen ska replikeras till string[] (krävs)
storageAccountType Lagringskontotyp som ska användas för att lagra den delade avbildningen. Utelämna att använda standardvärdet (Standard_LRS). "Standard_LRS"
"Standard_ZRS"

ImageTemplateVhdDistributor

Name Beskrivning Värde
typ Typ av distribution. "VHD" (krävs)

ImageTemplateSource

Name Beskrivning Värde
typ Ange objekttyp ManagedImage
PlatformImage
SharedImageVersion (obligatoriskt)

ImageTemplateManagedImageSource

Name Beskrivning Värde
typ Anger vilken typ av källbild du vill börja med. "ManagedImage" (krävs)
Imageid ARM-resurs-ID för den hanterade avbildningen i kundprenumerationen sträng (krävs)

ImageTemplatePlatformImageSource

Name Beskrivning Värde
typ Anger vilken typ av källbild du vill börja med. "PlatformImage" (krävs)
offer Bilderbjudande från Azure Gallery Images. sträng
planInfo Valfri konfiguration av inköpsplan för plattformsbild. PlatformImagePurchasePlan
utgivare Image Publisher i Azure Gallery Images. sträng
sku Avbildnings-SKU från Azure Gallery Images. sträng
version Avbildningsversion från Azure Gallery Images. Om "senaste" anges här utvärderas versionen när avbildningsversionen sker, inte när mallen skickas. sträng

PlatformImagePurchasePlan

Name Beskrivning Värde
planName Namnet på inköpsplanen. sträng (krävs)
planProduct Produkt av köpplanen. sträng (krävs)
planPublisher Utgivare av inköpsplanen. sträng (krävs)

ImageTemplateSharedImageVersionSource

Name Beskrivning Värde
typ Anger vilken typ av källbild du vill börja med. "SharedImageVersion" (krävs)
imageVersionId ARM-resurs-ID för avbildningsversionen i det delade bildgalleriet sträng (krävs)

ImageTemplatePropertiesValidate

Name Beskrivning Värde
continueDistributeOnFailure Om verifieringen misslyckas och fältet är inställt på falskt distribueras inte utdatabilder. Det här är standardbeteendet. Om verifieringen misslyckas och fältet är inställt på sant distribueras utdatabilder fortfarande. Använd det här alternativet med försiktighet eftersom det kan leda till att felaktiga bilder distribueras för användning. I båda fallen (sant eller falskt) rapporteras avbildningskörningen från slutpunkt till slutpunkt som misslyckad i händelse av ett valideringsfel. [Obs! Det här fältet har ingen effekt om valideringen lyckas.] boolesk
inVMValidations Lista över valideringar som ska utföras. ImageTemplateInVMValidator[]
sourceValidationOnly Om det här fältet är inställt på true verifieras avbildningen som anges i avsnittet "källa" direkt. Ingen separat version körs för att generera och validera sedan en anpassad avbildning. boolesk

ImageTemplateInVMValidator

Name Beskrivning Värde
name Eget namn för att ge kontext för vad det här verifieringssteget gör sträng
typ Ange objekttyp PowerShell
Shell (krävs)

ImageTemplatePowerShellValidator

Name Beskrivning Värde
typ Den typ av validering som du vill använda på bilden. Till exempel kan "Shell" vara gränssnittsvalidering "PowerShell" (krävs)
inline Matris med PowerShell-kommandon som ska köras string[]
runAsSystem Om det anges körs PowerShell-skriptet med förhöjd behörighet med hjälp av den lokala systemanvändaren. Kan bara vara sant när fältet runElevated ovan är inställt på true. boolesk
runElevated Om det anges körs PowerShell-skriptet med förhöjd behörighet boolesk
scriptUri URI för PowerShell-skriptet som ska köras för validering. Det kan vara en github-länk, Azure Storage-URI osv. sträng
sha256Checksum SHA256-kontrollsumma för power shell-skriptet som anges i fältet scriptUri ovan sträng
validExitCodes Giltiga slutkoder för PowerShell-skriptet. [Standard: 0] int[]

ImageTemplateShellValidator

Name Beskrivning Värde
typ Den typ av validering som du vill använda på bilden. Till exempel kan "Shell" vara gränssnittsvalidering "Shell" (krävs)
inline Matris med gränssnittskommandon som ska köras string[]
scriptUri URI för shell-skriptet som ska köras för validering. Det kan vara en github-länk, Azure Storage-URI osv. sträng
sha256Checksum SHA256-kontrollsumma för shell-skriptet som tillhandahålls i fältet scriptUri sträng

ImageTemplateVmProfile

Name Beskrivning Värde
osDiskSizeGB Storleken på OS-disken i GB. Utelämna eller ange 0 för att använda Azures standardstorlek för OS-diskar. int
userAssignedIdentities Valfri matris med resurs-ID:n för användartilldelade hanterade identiteter som ska konfigureras på den virtuella byggdatorn och den virtuella valideringsdatorn. Detta kan omfatta bildmallens identitet. string[]
vmSize Storleken på den virtuella dator som används för att skapa, anpassa och avbilda avbildningar. Utelämna eller ange tom sträng för att använda standardvärdet (Standard_D1_v2 för Gen1-bilder och Standard_D2ds_v4 för Gen2-avbildningar). sträng
vnetConfig Valfri konfiguration av det virtuella nätverket som ska användas för att distribuera den virtuella byggdatorn och den virtuella valideringsdatorn i. Utelämna om inget specifikt virtuellt nätverk behöver användas. VirtualNetworkConfig

VirtualNetworkConfig

Name Beskrivning Värde
proxyVmSize Storleken på den virtuella proxydatorn som används för att skicka trafik till den virtuella byggdatorn och den virtuella valideringsdatorn. Utelämna eller ange en tom sträng för att använda standardvärdet (Standard_A1_v2). sträng
subnetId Resurs-ID för ett befintligt undernät. sträng

Snabbstartsmallar

Följande snabbstartsmallar distribuerar den här resurstypen.

Mall Description
Azure Image Builder med Azure Windows-baslinje

Distribuera till Azure
Skapar en Azure Image Builder-miljö och skapar en Windows Server-avbildning med den senaste Windows-Uppdateringar och Azure Windows-baslinje tillämpad.
Konfigurera Dev Box-tjänsten

Distribuera till Azure
Den här mallen skapar alla Dev Box-administratörsresurser enligt snabbstartsguiden för Dev Box. Du kan visa alla resurser som skapats eller gå direkt till DevPortal.microsoft.com för att skapa din första Dev Box.

Resursdefinition för Terraform (AzAPI-provider)

Resurstypen imageTemplates kan distribueras till:

  • Resursgrupper

En lista över ändrade egenskaper i varje API-version finns i ändringsloggen.

Resursformat

Om du vill skapa en Microsoft.VirtualMachineImages/imageTemplates-resurs lägger du till följande Terraform i mallen.

resource "azapi_resource" "symbolicname" {
  type = "Microsoft.VirtualMachineImages/imageTemplates@2022-02-14"
  name = "string"
  location = "string"
  parent_id = "string"
  tags = {
    tagName1 = "tagValue1"
    tagName2 = "tagValue2"
  }
  identity {
    type =  "UserAssigned"
    identity_ids = []
  }
  body = jsonencode({
    properties = {
      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
        }
      ]
      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 = {
          proxyVmSize = "string"
          subnetId = "string"
        }
      }
    }
  })
}

ImageTemplateCustomizer-objekt

Ange typegenskapen för att ange typ av objekt.

För Fil använder du:

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

För PowerShell använder du:

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

För Shell använder du:

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

För WindowsRestart använder du:

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

För WindowsUpdate använder du:

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

ImageTemplateDistributor-objekt

Ange typegenskapen för att ange typ av objekt.

För ManagedImage använder du:

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

För SharedImage använder du:

  type = "SharedImage"
  excludeFromLatest = bool
  galleryImageId = "string"
  replicationRegions = [
    "string"
  ]
  storageAccountType = "string"

För VHD använder du:

  type = "VHD"

ImageTemplateSource-objekt

Ange typegenskapen för att ange typ av objekt.

För ManagedImage använder du:

  type = "ManagedImage"
  imageId = "string"

För PlatformImage använder du:

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

För SharedImageVersion använder du:

  type = "SharedImageVersion"
  imageVersionId = "string"

ImageTemplateInVMValidator-objekt

Ange typegenskapen för att ange typ av objekt.

För PowerShell använder du:

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

För Shell använder du:

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

Egenskapsvärden

imageTemplates

Name Beskrivning Värde
typ Resurstypen "Microsoft.VirtualMachineImages/imageTemplates@2022-02-14"
name Resursnamnet sträng (krävs)
location Den geo-plats där resursen finns sträng (krävs)
parent_id Om du vill distribuera till en resursgrupp använder du ID:t för den resursgruppen. sträng (krävs)
tags Resurstaggar. Ordlista med taggnamn och värden.
identity Identiteten för avbildningsmallen, om den har konfigurerats. ImageTemplateIdentity (krävs)
properties Egenskaperna för bildmallen ImageTemplateProperties

ImageTemplateIdentity

Name Beskrivning Värde
typ Den typ av identitet som används för avbildningsmallen. Typen None (Ingen) tar bort alla identiteter från bildmallen. "UserAssigned"
identity_ids Listan över användaridentiteter som är associerade med avbildningsmallen. Nyckelreferenserna för användaridentitetsordlistan är ARM-resurs-ID:er i formatet: '/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ManagedIdentity/userAssignedIdentities/{identityName}'. Matris med användaridentitets-ID:t.

ImageTemplateProperties

Name Beskrivning Värde
buildTimeoutInMinutes Maximal väntetid när du skapar avbildningsmallen (omfattar alla anpassningar, valideringar och distributioner). Utelämna eller ange 0 för att använda standardvärdet (4 timmar). int
Anpassa Anger de egenskaper som används för att beskriva anpassningsstegen för bilden, t.ex. bildkälla osv. ImageTemplateCustomizer[]
Distribuera Distributionen är avsedd för var avbildningens utdata ska gå. ImageTemplateDistributor[] (krävs)
källa Anger de egenskaper som används för att beskriva källbilden. ImageTemplateSource (krävs)
stagingResourceGroup Mellanlagringsresursgruppens ID i samma prenumeration som avbildningsmallen som ska användas för att skapa avbildningen. Om det här fältet är tomt skapas en resursgrupp med ett slumpmässigt namn. Om resursgruppen som anges i det här fältet inte finns skapas den med samma namn. Om den angivna resursgruppen finns måste den vara tom och i samma region som bildmallen. Den skapade resursgruppen tas bort under borttagningen av mallen om det här fältet är tomt eller om den angivna resursgruppen inte finns, men om den angivna resursgruppen finns tas resurserna som skapats i resursgruppen bort under borttagningen av mallen och själva resursgruppen blir kvar. sträng
validate Konfigurationsalternativ och lista över valideringar som ska utföras på den resulterande avbildningen. ImageTemplatePropertiesValidate
vmProfile Beskriver hur en virtuell dator har konfigurerats för att skapa avbildningar ImageTemplateVmProfile

ImageTemplateCustomizer

Name Beskrivning Värde
name Eget namn för att ge kontext för vad det här anpassningssteget gör sträng
typ Ange objekttyp Fil
PowerShell
Gränssnitt
WindowsRestart
WindowsUpdate (krävs)

ImageTemplateFileCustomizer

Name Beskrivning Värde
typ Den typ av anpassningsverktyg som du vill använda på avbildningen. Till exempel kan "Shell" vara gränssnittsanpassare "Fil" (krävs)
mål Den absoluta sökvägen till en fil (med kapslade katalogstrukturer som redan har skapats) där filen (från sourceUri) laddas upp till på den virtuella datorn sträng
sha256Checksum SHA256-kontrollsumma för filen som anges i sourceUri-fältet ovan sträng
sourceUri URI:n för filen som ska laddas upp för att anpassa den virtuella datorn. Det kan vara en github-länk, SAS-URI för Azure Storage osv. sträng

ImageTemplatePowerShellCustomizer

Name Beskrivning Värde
typ Den typ av anpassningsverktyg som du vill använda på avbildningen. Till exempel kan "Shell" vara gränssnittsanpassare "PowerShell" (krävs)
inline Matris med PowerShell-kommandon som ska köras string[]
runAsSystem Om det anges körs PowerShell-skriptet med förhöjd behörighet med hjälp av den lokala systemanvändaren. Kan bara vara sant när fältet runElevated ovan är inställt på true. boolesk
runElevated Om det anges körs PowerShell-skriptet med förhöjd behörighet boolesk
scriptUri URI för PowerShell-skriptet som ska köras för anpassning. Det kan vara en github-länk, SAS-URI för Azure Storage osv. sträng
sha256Checksum SHA256-kontrollsumma för power shell-skriptet som anges i fältet scriptUri ovan sträng
validExitCodes Giltiga slutkoder för PowerShell-skriptet. [Standard: 0] int[]

ImageTemplateShellCustomizer

Name Beskrivning Värde
typ Den typ av anpassningsverktyg som du vill använda på avbildningen. Till exempel kan "Shell" vara gränssnittsanpassare "Shell" (krävs)
inline Matris med gränssnittskommandon som ska köras string[]
scriptUri URI för det gränssnittsskript som ska köras för anpassning. Det kan vara en github-länk, SAS-URI för Azure Storage osv. sträng
sha256Checksum SHA256-kontrollsumma för shell-skriptet som tillhandahålls i fältet scriptUri sträng

ImageTemplateRestartCustomizer

Name Beskrivning Värde
typ Den typ av anpassningsverktyg som du vill använda på avbildningen. Till exempel kan "Shell" vara gränssnittsanpassare "WindowsRestart" (krävs)
restartCheckCommand Kommando för att kontrollera om omstarten lyckades [Standard: ''] sträng
restartCommand Kommando för att köra omstarten [Standard: 'shutdown /r /f /t 0 /c "packer restart"'] sträng
restartTimeout Tidsgränsen för omstart anges som en storlekssträng och enhet, t.ex. "5m" (5 minuter) eller "2h" (2 timmar) [Standard: "5m"] sträng

ImageTemplateWindowsUpdateCustomizer

Name Beskrivning Värde
typ Den typ av anpassningsverktyg som du vill använda på avbildningen. Till exempel kan "Shell" vara gränssnittsanpassare "WindowsUpdate" (krävs)
filter Matris med filter för att välja uppdateringar som ska tillämpas. Utelämna eller ange en tom matris för att använda standardvärdet (inget filter). Se länken ovan för exempel och detaljerad beskrivning av det här fältet. string[]
searchCriteria Kriterier för att söka efter uppdateringar. Utelämna eller ange en tom sträng för att använda standardvärdet (sök alla). Se länken ovan för exempel och detaljerad beskrivning av det här fältet. sträng
updateLimit Maximalt antal uppdateringar som ska tillämpas åt gången. Utelämna eller ange 0 för att använda standardvärdet (1 000) int

ImageTemplateDistributor

Name Beskrivning Värde
artifactTags Taggar som ska tillämpas på artefakten när den har skapats/uppdaterats av distributören. objekt
runOutputName Namnet som ska användas för det associerade RunOutput. sträng (krävs)
typ Ange objekttyp ManagedImage
SharedImage
VHD (krävs)

ImageTemplateManagedImageDistributor

Name Beskrivning Värde
typ Typ av distribution. "ManagedImage" (krävs)
Imageid Resurs-ID för managed disk-avbildningen sträng (krävs)
location Azure-plats för avbildningen ska matcha om avbildningen redan finns sträng (krävs)

ImageTemplateSharedImageDistributor

Name Beskrivning Värde
typ Typ av distribution. "SharedImage" (krävs)
excludeFromLatest Flagga som anger om den skapade avbildningsversionen ska undantas från den senaste. Utelämna att använda standardvärdet (false). boolesk
galleryImageId Resurs-ID för Shared Image Gallery-avbildningen sträng (krävs)
replicationRegions En lista över regioner som avbildningen ska replikeras till string[] (krävs)
storageAccountType Lagringskontotyp som ska användas för att lagra den delade avbildningen. Utelämna att använda standardvärdet (Standard_LRS). "Standard_LRS"
"Standard_ZRS"

ImageTemplateVhdDistributor

Name Beskrivning Värde
typ Typ av distribution. "VHD" (krävs)

ImageTemplateSource

Name Beskrivning Värde
typ Ange objekttyp ManagedImage
PlatformImage
SharedImageVersion (krävs)

ImageTemplateManagedImageSource

Name Beskrivning Värde
typ Anger vilken typ av källbild du vill börja med. "ManagedImage" (krävs)
Imageid ARM-resurs-ID för den hanterade avbildningen i kundprenumerationen sträng (krävs)

ImageTemplatePlatformImageSource

Name Beskrivning Värde
typ Anger vilken typ av källbild du vill börja med. "PlatformImage" (krävs)
offer Bilderbjudande från Azure Gallery Images. sträng
planInfo Valfri konfiguration av inköpsplan för plattformsbild. PlatformImagePurchasePlan
utgivare Image Publisher i Azure Gallery Images. sträng
sku Avbildnings-SKU från Azure Gallery Images. sträng
version Avbildningsversion från Azure Gallery Images. Om "senaste" anges här utvärderas versionen när avbildningsversionen sker, inte när mallen skickas. sträng

PlatformImagePurchasePlan

Name Beskrivning Värde
planName Namnet på inköpsplanen. sträng (krävs)
planProduct Produkt av köpplanen. sträng (krävs)
planPublisher Utgivare av inköpsplanen. sträng (krävs)

ImageTemplateSharedImageVersionSource

Name Beskrivning Värde
typ Anger vilken typ av källbild du vill börja med. "SharedImageVersion" (krävs)
imageVersionId ARM-resurs-ID för avbildningsversionen i det delade bildgalleriet sträng (krävs)

ImageTemplatePropertiesValidate

Name Beskrivning Värde
continueDistributeOnFailure Om verifieringen misslyckas och det här fältet är inställt på falskt distribueras inte utdatabilder. Det här är standardbeteendet. Om verifieringen misslyckas och det här fältet är inställt på sant distribueras utdatabilder fortfarande. Använd det här alternativet med försiktighet eftersom det kan leda till att felaktiga bilder distribueras för användning. I båda fallen (sant eller falskt) rapporteras avbildningskörningen från slutpunkt till slutpunkt som misslyckad vid valideringsfel. [Obs! Det här fältet har ingen effekt om valideringen lyckas.] boolesk
inVMValidations Lista över valideringar som ska utföras. ImageTemplateInVMValidator[]
sourceValidationOnly Om det här fältet är inställt på sant verifieras den avbildning som anges i avsnittet "källa". Ingen separat version kommer att köras för att generera och sedan validera en anpassad avbildning. boolesk

ImageTemplateInVMValidator

Name Beskrivning Värde
name Eget namn för att ge kontext om vad det här valideringssteget gör sträng
typ Ange objekttyp PowerShell
Gränssnitt (krävs)

ImageTemplatePowerShellValidator

Name Beskrivning Värde
typ Den typ av validering som du vill använda på avbildningen. "Shell" kan till exempel vara gränssnittsvalidering "PowerShell" (krävs)
inline Matris med PowerShell-kommandon som ska köras string[]
runAsSystem Om det anges körs PowerShell-skriptet med förhöjd behörighet med hjälp av den lokala systemanvändaren. Kan bara vara sant när fältet runElevated ovan är inställt på true. boolesk
runElevated Om det anges körs PowerShell-skriptet med förhöjd behörighet boolesk
scriptUri URI för PowerShell-skriptet som ska köras för validering. Det kan vara en github-länk, Azure Storage-URI osv. sträng
sha256Checksum SHA256-kontrollsumma för power shell-skriptet som anges i fältet scriptUri ovan sträng
validExitCodes Giltiga slutkoder för PowerShell-skriptet. [Standard: 0] int[]

ImageTemplateShellValidator

Name Beskrivning Värde
typ Den typ av validering som du vill använda på avbildningen. "Shell" kan till exempel vara gränssnittsvalidering "Shell" (krävs)
inline Matris med gränssnittskommandon som ska köras string[]
scriptUri URI för shell-skriptet som ska köras för validering. Det kan vara en github-länk, Azure Storage-URI osv. sträng
sha256Checksum SHA256-kontrollsumma för shell-skriptet som anges i fältet scriptUri sträng

ImageTemplateVmProfile

Name Beskrivning Värde
osDiskSizeGB Storleken på OS-disken i GB. Utelämna eller ange 0 för att använda Azures standarddiskstorlek för operativsystemet. int
userAssignedIdentities Valfri matris med resurs-ID:n för användartilldelade hanterade identiteter som ska konfigureras på den virtuella byggdatorn och den virtuella valideringsdatorn. Detta kan omfatta bildmallens identitet. string[]
vmSize Storleken på den virtuella dator som används för att skapa, anpassa och avbilda avbildningar. Utelämna eller ange en tom sträng för att använda standardvärdet (Standard_D1_v2 för Gen1-avbildningar och Standard_D2ds_v4 för Gen2-avbildningar). sträng
vnetConfig Valfri konfiguration av det virtuella nätverket som ska användas för att distribuera den virtuella byggdatorn och den virtuella valideringsdatorn i. Utelämna om inget specifikt virtuellt nätverk behöver användas. VirtualNetworkConfig

VirtualNetworkConfig

Name Beskrivning Värde
proxyVmSize Storleken på den virtuella proxydatorn som används för att skicka trafik till den virtuella byggdatorn och den virtuella valideringsdatorn. Utelämna eller ange en tom sträng för att använda standardvärdet (Standard_A1_v2). sträng
subnetId Resurs-ID för ett befintligt undernät. sträng