Microsoft.VirtualMachineImages imageTemplates
Bicep-resursdefinition
Resurstypen imageTemplates kan distribueras till:
- Resursgrupper – Se kommandon för resursgruppsdistribution
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 |
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 |
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:
- Resursgrupper – Se distributionskommandon för 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 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 |
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 |
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 |
Feedback
https://aka.ms/ContentUserFeedback.
Kommer snart: Under hela 2024 kommer vi att fasa ut GitHub-problem som feedbackmekanism för innehåll och ersätta det med ett nytt feedbacksystem. Mer information finns i:Skicka och visa feedback för