Microsoft.VirtualMachineImages imageTemplates 2021-10-01

Článek
12/17/2024

nejnovější
2024-02-01
2023-07-01
2022-07-07
2022-02-14
10. 10. 2021
2020-02-14
2019-05-01-Preview
2019-02-01-preview
2018-02-01-Preview

Definice prostředku Bicep

Typ prostředku imageTemplates je možné nasadit s operacemi, které cílí:

skupiny prostředků – viz příkazy nasazení skupiny prostředků

Seznam změněných vlastností v jednotlivých verzích rozhraní API najdete v protokolu změn.

Formát prostředku

Pokud chcete vytvořit prostředek Microsoft.VirtualMachineImages/imageTemplates, přidejte do šablony následující bicep.

resource symbolicname 'Microsoft.VirtualMachineImages/imageTemplates@2021-10-01' = {
  identity: {
    type: 'string'
    userAssignedIdentities: {
      {customized property}: {}
    }
  }
  location: 'string'
  name: 'string'
  properties: {
    buildTimeoutInMinutes: int
    customize: [
      {
        name: 'string'
        type: 'string'
        // For remaining properties, see ImageTemplateCustomizer objects
      }
    ]
    distribute: [
      {
        artifactTags: {
          {customized property}: 'string'
        }
        runOutputName: 'string'
        type: 'string'
        // For remaining properties, see ImageTemplateDistributor objects
      }
    ]
    source: {
      type: 'string'
      // For remaining properties, see ImageTemplateSource objects
    }
    vmProfile: {
      osDiskSizeGB: int
      userAssignedIdentities: [
        'string'
      ]
      vmSize: 'string'
      vnetConfig: {
        proxyVmSize: 'string'
        subnetId: 'string'
      }
    }
  }
  tags: {
    {customized property}: 'string'
  }
}

ImageTemplateSource – objekty

Nastavte typ vlastnost určit typ objektu.

Pro ManagedImagepoužijte:

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

Pro PlatformImage použijte:

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

Pro SharedImageVersionpoužijte:

{
  imageVersionId: 'string'
  type: 'SharedImageVersion'
}

ImageTemplateDistributor – objekty

Nastavte typ vlastnost určit typ objektu.

Pro ManagedImagepoužijte:

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

Pro SharedImagepoužijte:

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

Pro virtuálního pevného disku použijte:

{
  type: 'VHD'
}

ImageTemplateCustomizer – objekty

Nastavte typ vlastnost určit typ objektu.

Prosoubor použijte:

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

Pro PowerShellpoužijte:

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

Proprostředí použijte:

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

Pro windowsRestartpoužijte:

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

Pro WindowsUpdatepoužijte:

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

Hodnoty vlastností

ComponentsVrq145SchemasImagetemplateidentityPropertiesUserassignedidentitiesAdditionalproperties

Jméno	Popis	Hodnota

ImageTemplateCustomizer

Jméno	Popis	Hodnota
Jméno	Popisný název, který poskytuje kontext k tomu, co tento krok přizpůsobení dělá	řetězec
typ	Pro typ ImageTemplateFileCustomizernastavte hodnotu File . Nastavte na PowerShell pro typ ImageTemplatePowerShellCustomizer. Nastavte na Shell pro typ ImageTemplateShellCustomizer. Pro typ ImageTemplateRestartCustomizernastavte hodnotu WindowsRestart. Nastavte hodnotu WindowsUpdate pro typ ImageTemplateWindowsUpdateCustomizer.	"Soubor" PowerShell Shell WindowsRestart WindowsUpdate (povinné)

ImageTemplateDistributor

Jméno	Popis	Hodnota
artifactTags	Značky, které se po vytvoření nebo aktualizaci distributora použijí na artefakt.	ImageTemplateDistributorArtifactTags
runOutputName	Název, který se má použít pro přidružený RunOutput.	řetězec Omezení: Model = `^[A-Za-z0-9-_.]{1,64}$` (povinné)
typ	Nastavte na ManagedImage pro typ ImageTemplateManagedImageDistributor. Nastavte na SharedImage pro typ ImageTemplateSharedImageDistributor. Nastavte na VHD pro typ ImageTemplateVhdDistributor.	ManagedImage SharedImage VHD (povinné)

ImageTemplateDistributorArtifactTags

Jméno	Popis	Hodnota

ImageTemplateFileCustomizer

Jméno	Popis	Hodnota
cíl	Absolutní cesta k souboru (s již vytvořenými vnořenými adresářovými strukturami), do kterého se soubor (ze zdrojového identifikátoruURI) nahraje do virtuálního počítače.	řetězec
sha256Checksum	Kontrolní součet souboru SHA256 uvedený v poli sourceUri výše	řetězec
sourceUri	Identifikátor URI souboru, který se má nahrát pro přizpůsobení virtuálního počítače. Může to být odkaz githubu, identifikátor URI SAS pro Azure Storage atd.	řetězec
typ	Typ nástroje pro přizpůsobení, který chcete použít na obrázku. Například "Shell" může být úpravce prostředí.	"Soubor" (povinné)

ImageTemplateIdentity

Jméno	Popis	Hodnota
typ	Typ identity používané pro šablonu obrázku. Typ None odebere ze šablony obrázku všechny identity.	None (Žádný) UserAssigned
userAssignedIdentities	Seznam identit uživatelů přidružených k šabloně obrázku. Odkazy na klíč slovníku identit uživatele budou ID prostředků ARM ve formátu: /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ManagedIdentity/userAssignedIdentities/{identityName}.	ImageTemplateIdentityUserAssignedIdentities

ImageTemplateIdentityUserAssignedIdentities

Jméno	Popis	Hodnota

ImageTemplateManagedImageDistributor

Jméno	Popis	Hodnota
imageId	ID prostředku image spravovaného disku	string (povinné)
umístění	Umístění Azure pro image by se mělo shodovat, pokud image již existuje.	string (povinné)
typ	Typ distribuce.	ManagedImage (povinné)

ImageTemplateManagedImageSource

Jméno	Popis	Hodnota
imageId	ID prostředku ARM spravované image v předplatném zákazníka	string (povinné)
typ	Určuje typ zdrojové image, se kterou chcete začít.	ManagedImage (povinné)

ImageTemplatePlatformImageSource

Jméno	Popis	Hodnota
nabídnout	Image offer from the Azure Gallery Images.	řetězec
planInfo	Volitelná konfigurace nákupního plánu pro image platformy	PlatformImagePurchasePlan
vydavatel	Image Publisher v imagích galerie Azure.	řetězec
sku	SKU obrázku zimagí galerie Azure .	řetězec
typ	Určuje typ zdrojové image, se kterou chcete začít.	PlatformImage (povinné)
verze	Verze image z image galerie Azure. Pokud je zde zadána hodnota latest, vyhodnotí se verze, když se sestavení image provede, ne při odeslání šablony.	řetězec

ImageTemplatePowerShellCustomizer

Jméno	Popis	Hodnota
vložený	Pole příkazů PowerShellu pro spuštění	string[]
runAsSystem	Pokud je zadáno, skript PowerShellu se spustí se zvýšenými oprávněními pomocí uživatele místního systému. Může být true pouze v případech, kdy je výše uvedené pole runElevated nastaveno na hodnotu true.	Bool
runElevated	Pokud je zadáno, skript PowerShellu se spustí se zvýšenými oprávněními.	Bool
scriptUri	Identifikátor URI skriptu PowerShellu, který se má spustit pro přizpůsobení. Může to být odkaz githubu, identifikátor URI SAS pro Azure Storage atd.	řetězec
sha256Checksum	Kontrolní součet SHA256 skriptu power shellu uvedený v poli scriptUri výše	řetězec
typ	Typ nástroje pro přizpůsobení, který chcete použít na obrázku. Například "Shell" může být úpravce prostředí.	PowerShell (povinné)
validExitCodes	Platné ukončovací kódy pro skript PowerShellu [Výchozí: 0]	int[]

ImageTemplateProperties

Jméno	Popis	Hodnota
buildTimeoutInMinutes	Maximální doba čekání při sestavování šablony obrázku Vynecháte nebo zadejte hodnotu 0, která se má použít jako výchozí (4 hodiny).	Int Omezení: Minimální hodnota = 0 Maximální hodnota = 960
přizpůsobit	Určuje vlastnosti použité k popisu kroků přizpůsobení obrázku, jako je zdroj image atd.	ImageTemplateCustomizer[]
distribuovat	Distribuční cíle, kam je potřeba výstup obrázku přejít.	ImageTemplateDistributor[] (povinné)
zdroj	Určuje vlastnosti použité k popisu zdrojové image.	imageTemplateSource (povinné)
vmProfile	Popisuje, jak je virtuální počítač nastavený tak, aby se sestavily image.	imageTemplateVmProfile

ImageTemplateRestartCustomizer

Jméno	Popis	Hodnota
restartCheckCommand	Příkaz, který zkontroluje, jestli restartování proběhlo úspěšně [Výchozí: '']	řetězec
restartCommand	Příkaz pro spuštění restartování [Výchozí: "shutdown /r /f /t 0 /c "packer restart"']	řetězec
restartTimeout	Časový limit restartování zadaný jako řetězec velikosti a jednotky, například 5 min (5 minut) nebo 2h (2 hodiny) [Výchozí hodnota: 5 min]	řetězec
typ	Typ nástroje pro přizpůsobení, který chcete použít na obrázku. Například "Shell" může být úpravce prostředí.	WindowsRestart (povinné)

ImageTemplateSharedImageDistributor

Jméno	Popis	Hodnota
excludeFromLatest	Příznak označující, jestli má být vytvořená verze image vyloučena z nejnovější verze. Vynecháte použití výchozí hodnoty (false).	Bool
galleryImageId	ID prostředku image sdílené galerie imagí	string (povinné)
replicationRegions	Seznam oblastí, do kterých se image bude replikovat	string[] (povinné)
storageAccountType	Typ účtu úložiště, který se má použít k uložení sdílené image. Vynecháte použití výchozího nastavení (Standard_LRS).	"Standard_LRS" "Standard_ZRS"
typ	Typ distribuce.	SharedImage (povinné)

ImageTemplateSharedImageVersionSource

Jméno	Popis	Hodnota
imageVersionId	ID prostředku ARM verze image ve sdílené galerii imagí	string (povinné)
typ	Určuje typ zdrojové image, se kterou chcete začít.	SharedImageVersion (povinné)

ImageTemplateShellCustomizer

Jméno	Popis	Hodnota
vložený	Pole příkazů prostředí ke spuštění	string[]
scriptUri	Identifikátor URI skriptu prostředí, který se má spustit pro přizpůsobení. Může to být odkaz githubu, identifikátor URI SAS pro Azure Storage atd.	řetězec
sha256Checksum	Kontrolní součet sha256 skriptu prostředí zadaného v poli scriptUri	řetězec
typ	Typ nástroje pro přizpůsobení, který chcete použít na obrázku. Například "Shell" může být úpravce prostředí.	Shell (povinné)

ImageTemplateSource

Jméno	Popis	Hodnota
typ	Nastavte na ManagedImage pro typ ImageTemplateManagedImageSource. Nastavte na PlatformImage pro typ ImageTemplatePlatformImageSource. Nastavte na SharedImageVersion pro typ ImageTemplateSharedImageVersionSource.	ManagedImage PlatformImage SharedImageVersion (povinné)

ImageTemplateVhdDistributor

Jméno	Popis	Hodnota
typ	Typ distribuce.	VHD (povinné)

ImageTemplateVmProfile

Jméno	Popis	Hodnota
osDiskSizeGB	Velikost disku s operačním systémem v GB Vynecháte nebo zadejte hodnotu 0 pro použití výchozí velikosti disku s operačním systémem Azure.	Int Omezení: Minimální hodnota = 0
userAssignedIdentities	Volitelné pole ID prostředků spravovaných identit přiřazených uživatelem, které se mají nakonfigurovat na virtuálním počítači sestavení. Může to zahrnovat identitu šablony obrázku.	string[]
vmSize	Velikost virtuálního počítače použitého k sestavení, přizpůsobení a zachycení imagí Vynecháte nebo zadejte prázdný řetězec, který se má použít jako výchozí (Standard_D2ds_v4).	řetězec
vnetConfig	Volitelná konfigurace virtuální sítě, která se má použít k nasazení virtuálního počítače sestavení. Vynecháte, pokud není potřeba použít žádnou konkrétní virtuální síť.	VirtualNetworkConfig

ImageTemplateWindowsUpdateCustomizer

Jméno	Popis	Hodnota
filtruje	Polefiltrůch Vynechání nebo zadání prázdného pole pro použití výchozího pole (bez filtru) Příklady a podrobný popis tohoto pole najdete na výše uvedeném odkazu.	string[]
searchCriteria	Kritéria pro vyhledávání aktualizací Vynecháte nebo zadejte prázdný řetězec, který se má použít jako výchozí (prohledávat vše). Příklady a podrobný popis tohoto pole najdete na výše uvedeném odkazu.	řetězec
typ	Typ nástroje pro přizpůsobení, který chcete použít na obrázku. Například "Shell" může být úpravce prostředí.	WindowsUpdate (povinné)
updateLimit	Maximální početaktualizacích Vynechání nebo zadání hodnoty 0 pro použití výchozího nastavení (1000)	Int Omezení: Minimální hodnota = 0