Documentación de productos
Azure
Ver PDF

Plantillas de inicio

January 9, 2026
Contribución de: 
C

Esta sección contiene un conjunto completo de plantillas ARM que se pueden usar con el conector de implementaciones de Azure. Estas plantillas se pueden usar tal cual o se pueden modificar para satisfacer necesidades específicas.

Cada recurso creado por estas plantillas se etiqueta con el mismo conjunto de etiquetas. Estas etiquetas incluyen información útil sobre el contexto de la implementación, como el nombre del usuario que inició la tarea y el comentario que introdujo.

Las plantillas hacen un uso extensivo de los datos personalizados en la configuración del conector. Los datos personalizados permiten al usuario definir parámetros comunes como location, vmSize, generation y otros parámetros sin necesidad de modificar la plantilla.

La siguiente tabla enumera todas las propiedades de datos personalizados usadas por estas plantillas. Especifica qué plantillas se aplican a cada propiedad y si la propiedad es obligatoria.

R = Obligatorio, O = Opcional, - = No usado

Nombre Tipo Descripción Predeterminado Disco de caché Imagen de arranque Máquina Imagen en capas
location string La región donde se crean los recursos. La misma región que el grupo de recursos de destino. O O O O
gallery string El nombre de la galería de proceso en la que crear imágenes. La galería debe estar en el grupo de recursos de destino. - - R - R
storageSku string El nombre de la SKU que se usará para los discos administrados. “StandardSSD_LRS” O - O -
NVMe boolean true para usar controladores de disco NVMe, false en caso contrario. Este debe ser el mismo valor para todos los tipos de implementación. false O O O O
generation string La generación de la máquina virtual. “V2” - O O O
trustedLaunch boolean true para habilitar el inicio de confianza, false en caso contrario. Este debe ser el mismo valor para todos los tipos de implementación. false O O O O
diskAccessId string El ID de recurso del acceso al disco usado al cargar el contenido del disco. Si se especifica, el disco se crea con el acceso a la red pública deshabilitado. Para obtener más información, consulta la documentación de Azure. null O - - -
vmSize string El tamaño de la VM que se va a crear. “Standard_D2s_v3” - - O -
prefix string Un prefijo para anteponer al nombre de los recursos creados por la implementación de la máquina “al-“ - - O -
licenseType string El tipo de licencia local que se aplicará a las máquinas virtuales creadas. null - - O -
subnetId string El ID de recurso de la subred a la que se adjuntará la tarjeta de red de la VM. - - - R -
acceleratedNetworking boolean true para habilitar la red acelerada, false en caso contrario. Este debe ser el mismo valor para todos los tipos de implementación. false O O O O
replicaCount number El número predeterminado de réplicas por región de la versión de la imagen de la galería 1 - - - O
imageStorageAccountType string Especifica el tipo de cuenta de almacenamiento que se usará para almacenar la imagen. “Standard_LRS” - - - O
targetRegions array Las regiones de destino de la versión de la imagen de la galería. Se especifica como una matriz de cadenas de nombres de región y/o objetos TargetRegion. La matriz debe contener la región del disco de origen (que se especifica mediante los datos personalizados de location). La región especificada por los datos personalizados de location - - - O
publishAs string o array El tipo de recurso(s) para publicar imágenes. Se especifica como una matriz o cadena que consta de ‘galleryImage’ y/o ‘managedDisk’ [“galleryImage”] - - - O
diskNameFormat string Controla el nombre de las imágenes publicadas como discos administrados. “version” para anexar la versión al nombre de la imagen, “timestamp” para anexar la hora de publicación. “version” - - - O

Ejemplo de datos personalizados:

{
    "gallery": "MyGallery",
    "subnetId": "/subscriptions/ab3d1259-f5a9-407f-bbdd-bfd5701e2e94/resourceGroups/PDGTPB/providers/Microsoft.Network/virtualNetworks/MyVnet/subnets/mysubnet"
}
<!--NeedCopy-->

Otro ejemplo de datos personalizados:

{
    "location": "eastus",
    "gallery": "MyGallery",
    "storageSku": "Premium_LRS",
    "trustedLaunch": true,
    "diskAccessId": "/subscriptions/ab3d1259-f5a9-407f-bbdd-bfd5701e2e94/resourceGroups/MyResourceGroup/providers/Microsoft.Compute/diskAccesses/MyDiskAccess",
    "vmSize": "Standard_D4s_v3",
    "subnetId": "/subscriptions/ab3d1259-f5a9-407f-bbdd-bfd5701e2e94/resourceGroups/MyResourceGroup/providers/Microsoft.Network/virtualNetworks/MyVnet/subnets/mysubnet",
    "replicaCount": 2,
    "targetRegions": [
        "eastus",
        {
            "name": "eastus2",
            "regionalReplicaCount": 5,
            "storageAccountType": "Premium_LRS"
        },
        "westus"
    ]
}
<!--NeedCopy-->

Disco de caché

Crea un disco administrado.

Datos personalizados del disco de caché

Nombre Tipo Descripción Predeterminado Obligatorio
location string La región en la que se crean los recursos. La misma región que el grupo de recursos de destino no
storageSku string El nombre de la SKU que se usará. “StandardSSD_LRS” no
NVMe boolean true para habilitar los controladores de disco NVMe, false en caso contrario. Este debe ser el mismo valor para todos los tipos de implementación. false no
acceleratedNetworking boolean true para habilitar la red acelerada, false en caso contrario. Este debe ser el mismo valor para todos los tipos de implementación. false no
trustedLaunch boolean true para habilitar el inicio de confianza, false en caso contrario. Este debe ser el mismo valor para todos los tipos de implementación. false no
diskAccessId string El ID de recurso del acceso al disco que se usará al cargar el contenido del disco. Si se especifica, el disco se crea con el acceso a la red pública deshabilitado. null no

Plantilla de disco de caché

  • 1.2.0.0 - Se agregó compatibilidad con la red acelerada y los controladores de disco NVMe
  • 1.1.0.0 - Se agregó compatibilidad con el inicio de confianza
  • 1.0.0.0 - Versión inicial
{
    "$schema": "https://schema.management.azure.com/schemas/2019-04-01/deploymentTemplate.json#",
    "contentVersion": "1.2.0.0",
    "parameters": {
        "al": {
            "type": "object"
        }
    },
    "variables": {
        "custom": "[parameters('al').context.config.custom]",
        "location": "[if(contains(variables('custom'), 'location'), variables('custom').location, resourceGroup().location)]",
        "name": "[concat(parameters('al').context.item.name,'-', parameters('al').context.item.id)]",
        "tags": {
            "alTaskId": "[parameters('al').context.taskId]",
            "alUser": "[parameters('al').context.user]",
            "alComment": "[parameters('al').context.comment]",
            "alItemType": "[parameters('al').context.item.type]",
            "alItemId": "[parameters('al').context.item.id]",
            "alItemName": "[parameters('al').context.item.name]",
            "alItemVersion": "[parameters('al').context.item.version.name]",
            "alConfigId": "[parameters('al').context.config.id]",
            "alConfigName": "[parameters('al').context.config.name]"
        },
        "hasDiskAccess": "[contains(variables('custom'), 'diskAccessId')]",
        "storageSku": "[if(contains(variables('custom'), 'storageSku'), variables('custom').storageSku, 'StandardSSD_LRS')]",
        "trustedLaunch": "[if(contains(variables('custom'), 'trustedLaunch'), variables('custom').trustedLaunch, false())]",
        "acceleratedNetworking": "[if(contains(variables('custom'), 'acceleratedNetworking'), variables('custom').acceleratedNetworking, false())]",
        "NVMe": "[if(contains(variables('custom'), 'NVMe'), variables('custom').NVMe, false())]"
    },
    "resources": [
        {
            "type": "Microsoft.Compute/disks",
            "apiVersion": "2024-03-02",
            "name": "[variables('name')]",
            "location": "[variables('location')]",
            "tags": "[variables('tags')]",
            "sku": {
                "name": "[variables('storageSku')]"
            },
            "properties": {
                "creationData": {
                    "createOption": "Upload",
                    "uploadSizeBytes": "[parameters('al').input.uploadSize]"
                },
                "incremental": "false",
                "diskAccessId": "[if(variables('hasDiskAccess'), variables('custom').diskAccessId, null())]",
                "networkAccessPolicy": "[if(variables('hasDiskAccess'), 'AllowPrivate', 'AllowAll')]",
                "publicNetworkAccess": "[if(variables('hasDiskAccess'), 'Disabled', 'Enabled')]",
                "securityProfile": "[if(variables('trustedLaunch'), createObject('securityType', 'TrustedLaunch'), null())]",
                "supportedCapabilities": {
                    "diskControllerTypes": "[if(variables('NVMe'), 'NVMe, SCSI', 'SCSI')]",
                    "acceleratedNetwork": "[variables('acceleratedNetworking')]"
                }
            }
        }
    ]
}
<!--NeedCopy-->

Imagen de arranque

La implementación de la imagen de arranque crea una imagen de galería y una versión de imagen en la galería especificada por los datos personalizados. Genera el ID de la versión de la imagen de la galería de proceso creada para que lo use la plantilla de Máquina.

Datos personalizados de la imagen de arranque

Nombre Tipo Descripción Predeterminado Obligatorio
location string La región en la que se crean los recursos. La misma región que el grupo de recursos de destino. no
generation string La generación de la máquina virtual usada en el disco. “V2” no
NVMe boolean true para habilitar los controladores de disco NVMe, false en caso contrario. Este debe ser el mismo valor para todos los tipos de implementación. false no
acceleratedNetworking boolean true para habilitar la red acelerada, false en caso contrario. Este debe ser el mismo valor para todos los tipos de implementación. false no
trustedLaunch boolean true para habilitar el inicio de confianza, false en caso contrario. Este debe ser el mismo valor para todos los tipos de implementación. false no
gallery string El nombre de la galería de proceso en la que crear la imagen. La galería debe estar en el grupo de recursos de destino. - sí

Plantilla de imagen de arranque

  • 1.2.0.0 - Se agregó compatibilidad con la red acelerada y los controladores de disco NVMe
  • 1.1.0.0 - Se agregó compatibilidad con el inicio de confianza
  • 1.0.0.0 - Versión inicial
{
    "$schema": "https://schema.management.azure.com/schemas/2019-04-01/deploymentTemplate.json#",
    "contentVersion": "1.2.0.0",
    "parameters": {
        "al": {
            "type": "object"
        }
    },
    "variables": {
        "custom": "[parameters('al').context.config.custom]",
        "location": "[if(contains(variables('custom'), 'location'), variables('custom').location, resourceGroup().location)]",
        "tags": {
            "alTaskId": "[parameters('al').context.taskId]",
            "alUser": "[parameters('al').context.user]",
            "alComment": "[parameters('al').context.comment]",
            "alItemType": "[parameters('al').context.item.type]",
            "alItemId": "[parameters('al').context.item.id]",
            "alItemName": "[parameters('al').context.item.name]",
            "alItemVersion": "[parameters('al').context.item.version.name]",
            "alConfigId": "[parameters('al').context.config.id]",
            "alConfigName": "[parameters('al').context.config.name]"
        },
        "name": "[concat(parameters('al').context.item.name, '.', replace(parameters('al').context.config.id, '-', ''), '.', parameters('al').context.item.id)]",
        "version": "[parameters('al').context.item.version.name]",
        "galleryName": "[variables('custom').gallery]",
        "generation": "[if(contains(variables('custom'), 'generation'), variables('custom').generation, 'V2')]",
        "acceleratedNetworking": "[if(contains(variables('custom'), 'acceleratedNetworking'), variables('custom').acceleratedNetworking, false())]",
        "NVMe": "[if(contains(variables('custom'), 'NVMe'), variables('custom').NVMe, false())]",
        "trustedLaunch": "[if(contains(variables('custom'), 'trustedLaunch'), variables('custom').trustedLaunch, false())]",
        "possibleFeatures": [
            {
                "include": "[variables('trustedLaunch')]",
                "feature": {
                    "name": "SecurityType",
                    "value": "TrustedLaunch"
                }
            },
            {
                "include": "[variables('acceleratedNetworking')]",
                "feature": {
                    "name": "IsAcceleratedNetworkSupported",
                    "value": "True"
                }
            },
            {
                "include": "[variables('NVMe')]",
                "feature": {
                    "name": "DiskControllerTypes",
                    "value": "NVMe, SCSI"
                }
            }
        ]
    },
    "resources": [
        {
            "type": "Microsoft.Compute/galleries/images",
            "name": "[concat(variables('galleryName'), '/', variables('name'))]",
            "apiVersion": "2021-07-01",
            "location": "[variables('location')]",
            "tags": "[variables('tags')]",
            "properties": {
                "description": "[parameters('al').context.item.description]",
                "features": "[map(filter(variables('possibleFeatures'), lambda('x', lambdaVariables('x').include)), lambda('x', lambdaVariables('x').feature))]",
                "hyperVGeneration": "[variables('generation')]",
                "osType": "Windows",
                "osState": "Specialized",
                "endOfLifeDate": "2030-01-01T00:00:00Z",
                "identifier": {
                    "publisher": "Citrix",
                    "offer": "[parameters('al').context.config.id]",
                    "sku": "[parameters('al').context.item.id]"
                }
            },
            "resources": [
                {
                    "type": "versions",
                    "apiVersion": "2021-07-01",
                    "name": "[variables('version')]",
                    "location": "[variables('location')]",
                    "dependsOn": [
                        "[resourceId('Microsoft.Compute/galleries/images', variables('galleryName'), variables('name'))]"
                    ],
                    "tags": "[variables('tags')]",
                    "properties": {
                        "publishingProfile": {
                            "replicaCount": 1,
                            "targetRegions": [
                                {
                                    "name": "[variables('location')]"
                                }
                            ]
                        },
                        "storageProfile": {
                            "osDiskImage": {
                                "source": {
                                    "id": "[parameters('al').input.source.diskId]"
                                }
                            }
                        }
                    }
                }
            ]
        }
    ],
    "outputs": {
        "id": {
            "type": "string",
            "value": "[resourceId('Microsoft.Compute/galleries/images/versions', variables('galleryName'), variables('name'), variables('version'))]"
        }
    }
}
<!--NeedCopy-->

Máquina

La implementación de la máquina crea una máquina virtual, una NIC y un disco administrado. Esta plantilla funciona con o sin la especificación de la implementación de la imagen de arranque.

Datos personalizados de la máquina

Nombre Tipo Descripción Predeterminado Obligatorio
location string La región en la que se crean los recursos. La misma región que el grupo de recursos de destino. no
storageSku string El nombre de la SKU para el disco creado. “StandardSSD_LRS” no
generation string La generación de la máquina virtual. “V2” no
NVMe boolean true para usar controladores de disco NVMe, false en caso contrario. Este debe ser el mismo valor para todos los tipos de implementación. false no
acceleratedNetworking boolean true para habilitar la red acelerada, false en caso contrario. Este debe ser el mismo valor para todos los tipos de implementación. false no
trustedLaunch boolean true para habilitar el inicio de confianza, false en caso contrario. Este debe ser el mismo valor para todos los tipos de implementación. false no
secureBoot boolean true para habilitar el arranque seguro, false en caso contrario. Esto solo se aplica si trustedLaunch se establece en true. true no
vTpm boolean true para habilitar el vTPM, false en caso contrario. Esto solo se aplica si trustedLaunch se establece en true. true no
vmSize string El tamaño de la VM que se va a crear. “Standard_D2s_v3” no
licenseType string El tipo de licencia local que se aplicará a la máquina virtual. null no
subnetId string El ID de recurso de la subred a la que se adjuntará la NIC. - sí
prefix string Un prefijo para anteponer al nombre de los recursos creados “al-“ no

Plantilla de máquina

  • 1.2.0.0
    • Se agregó compatibilidad con la red acelerada
    • Se agregó compatibilidad con los controladores de disco NVMe
    • Se agregó compatibilidad con la exportación de IPS
    • Se agregó la capacidad de personalizar el prefijo antepuesto a los nombres de los recursos
    • Se agregó la dirección IP al mensaje que se muestra en la subtarea de App Layering
    • Se deshabilitó el acceso a la red al disco del sistema operativo
  • 1.1.0.0 - Se agregó compatibilidad con el inicio de confianza
  • 1.0.0.0 - Versión inicial
{
    "$schema": "https://schema.management.azure.com/schemas/2019-04-01/deploymentTemplate.json#",
    "contentVersion": "1.2.0.0",
    "parameters": {
        "al": {
            "type": "object"
        }
    },
    "variables": {
        "custom": "[parameters('al').context.config.custom]",
        "location": "[if(contains(variables('custom'), 'location'), variables('custom').location, resourceGroup().location)]",
        "prefix": "[if(contains(variables('custom'), 'prefix'), variables('custom').prefix, 'al-')]",
        "name": "[concat(variables('prefix'), parameters('al').context.taskId)]",
        "vmName": "[concat(variables('name'), '-vm')]",
        "nicName": "[concat(variables('name'), '-nic')]",
        "diskName": "[concat(variables('name'), '-disk')]",
        "diskId": "[resourceId('Microsoft.Compute/disks', variables('diskName'))]",
        "tags": {
            "alTaskId": "[parameters('al').context.taskId]",
            "alUser": "[parameters('al').context.user]",
            "alComment": "[parameters('al').context.comment]",
            "alItemType": "[parameters('al').context.item.type]",
            "alItemId": "[parameters('al').context.item.id]",
            "alItemName": "[parameters('al').context.item.name]",
            "alItemVersion": "[parameters('al').context.item.version.name]",
            "alConfigId": "[parameters('al').context.config.id]",
            "alConfigName": "[parameters('al').context.config.name]"
        },
        "source": "[parameters('al').input.disk.image]",
        "isFromImage": "[not(contains(variables('source'), 'diskId'))]",
        "generation": "[if(contains(variables('custom'), 'generation'), variables('custom').generation, 'V2')]",
        "vmSize": "[if(contains(variables('custom'), 'vmSize'), variables('custom').vmSize, 'Standard_D2s_v3')]",
        "storageSku": "[if(contains(variables('custom'), 'storageSku'), variables('custom').storageSku, 'StandardSSD_LRS')]",
        "trustedLaunch": "[if(contains(variables('custom'), 'trustedLaunch'), variables('custom').trustedLaunch, false())]",
        "secureBoot": "[if(contains(variables('custom'), 'secureBoot'), variables('custom').secureBoot, variables('trustedLaunch'))]",
        "vTpm": "[if(contains(variables('custom'), 'vTpm'), variables('custom').vTpm, variables('trustedLaunch'))]",
        "acceleratedNetworking": "[if(contains(variables('custom'), 'acceleratedNetworking'), variables('custom').acceleratedNetworking, false())]",
        "NVMe": "[if(contains(variables('custom'), 'NVMe'), variables('custom').NVMe, false())]",
        "securityProfile": {
            "securityType": "TrustedLaunch",
            "uefiSettings": {
                "secureBootEnabled": "[variables('secureBoot')]",
                "vTpmEnabled": "[variables('vTpm')]"
            }
        },
        "dataDiskTemplate": {
            "createOption": "Attach",
            "deleteOption": "Delete",
            "managedDisk": {
                "id": "ToBeReplaced"
            }
        },
        "dataDiskName": "[concat(variables('name'), '-disk{0}')]",
        "additionalDisks": "[if(contains(parameters('al').input, 'additionalDisks'), parameters('al').input.additionalDisks, createArray())]",     
        "additionalDiskIds": "[map(variables('additionalDisks'), lambda('x', lambdaVariables('x').diskId))]",
        "dataDiskIds": "[map(variables('additionalDiskIds'), lambda('x', 'i', resourceId('Microsoft.Compute/disks',format(variables('dataDiskName'), lambdaVariables('i')))))]"
    
    },
    "resources": [
        {
            "type": "Microsoft.Network/networkInterfaces",
            "apiVersion": "2020-11-01",
            "name": "[variables('nicName')]",
            "location": "[variables('location')]",
            "tags": "[variables('tags')]",
            "properties": {
                "ipConfigurations": [
                    {
                        "name": "ipconfig1",
                        "properties": {
                            "privateIPAllocationMethod": "Dynamic",
                            "subnet": {
                                "id": "[variables('custom').subnetId]"
                            },
                            "primary": true,
                            "privateIPAddressVersion": "IPv4"
                        }
                    }
                ],
                "dnsSettings": {
                    "dnsServers": []
                },
                "enableAcceleratedNetworking": "[variables('acceleratedNetworking')]",
                "enableIPForwarding": false
            }
        },
        {
            "condition": "[not(variables('isFromImage'))]",
            "type": "Microsoft.Compute/disks",
            "apiVersion": "2021-08-01",
            "name": "[variables('diskName')]",
            "location": "[variables('location')]",
            "tags": "[variables('tags')]",
            "sku": {
                "name": "[variables('storageSku')]"
            },
            "properties": {
                "osType": "Windows",
                "hyperVGeneration": "[variables('generation')]",
                "creationData": {
                    "createOption": "Copy",
                    "sourceResourceId": "[variables('source').diskId]"
                },
                "diskSizeGB": "[parameters('al').input.disk.size]",
                "networkAccessPolicy": "DenyAll",
                "publicNetworkAccess": "Disabled",
                "supportedCapabilities": {
                    "acceleratedNetwork": "[variables('acceleratedNetworking')]"
                }
            }
        },
        {
            "copy": {
                "name": "data-disk-loop",
                "count": "[length(variables('additionalDiskIds'))]",
                "mode": "Parallel"
            },
            "type": "Microsoft.Compute/disks",
            "apiVersion": "2021-08-01",
            "name": "[format(variables('dataDiskName'), copyIndex())]",
            "location": "[variables('location')]",
            "tags": "[variables('tags')]",
            "sku": {
                "name": "[variables('storageSku')]"
            },
            "properties": {
                "creationData": {
                    "createOption": "Copy",
                    "sourceResourceId": "[variables('additionalDiskIds')[copyIndex()]]"
                },
                "networkAccessPolicy": "DenyAll",
                "publicNetworkAccess": "Disabled"
            }
        },
        {
            "type": "Microsoft.Compute/virtualMachines",
            "apiVersion": "2022-08-01",
            "name": "[variables('vmName')]",
            "location": "[variables('location')]",
            "dependsOn": [
                "[resourceId('Microsoft.Network/networkInterfaces', variables('nicName'))]",
                "[variables('diskId')]",
                "data-disk-loop"
            ],
            "tags": "[variables('tags')]",
            "properties": {
                "hardwareProfile": {
                    "vmSize": "[variables('vmSize')]"
                },
                "securityProfile": "[if(variables('trustedLaunch'), variables('securityProfile'), null())]",
                "storageProfile": {
                    "imageReference": "[if(variables('isFromImage'), createObject('id', variables('source').id), null())]",
                    "diskControllerType": "[if(variables('NVMe'), 'NVMe', null())]",
                    "osDisk": {
                        "osType": "Windows",
                        "createOption": "[if(variables('isFromImage'), 'FromImage', 'Attach')]",
                        "caching": "ReadWrite",
                        "deleteOption": "Delete",
                        "diskSizeGB": "[parameters('al').input.disk.size]",
                        "managedDisk": "[if(variables('isFromImage'), createObject('storageAccountType', variables('storageSku')), createObject('id', variables('diskId')))]"
                    },
                    "dataDisks": "[map(variables('dataDiskIds'), lambda('x', 'i', union(variables('dataDiskTemplate'), createObject('lun', lambdaVariables('i'), 'managedDisk', createObject('id', lambdaVariables('x'))))))]"
                },
                "networkProfile": {
                    "networkInterfaces": [
                        {
                            "id": "[resourceId('Microsoft.Network/networkInterfaces', variables('nicName'))]"
                        }
                    ]
                },
                "diagnosticsProfile": {
                    "bootDiagnostics": {
                        "enabled": true
                    }
                },
                "licenseType": "[if(contains(variables('custom'), 'licenseType'), variables('custom').licenseType, null())]",
                "userData": "[parameters('al').input.vm.userData]"
            }
        }
    ],
    "outputs": {
        "diskId": {
            "type": "string",
            "value": "[reference(variables('vmName')).storageProfile.osDisk.managedDisk.id]"
        },
        "message": {
            "type": "string",
            "value": "[format('See [link=\"{0}/#@{1}/resource/{2}\"]{2}[/link]. IP Address: {3}', environment().portal, tenant().tenantId, resourceId('Microsoft.Compute/virtualMachines', variables('vmName')), reference(variables('nicName')).ipConfigurations[0].properties.privateIPAddress)]"
        }
    }
}
<!--NeedCopy-->

Imagen en capas

La implementación de la imagen en capas puede crear dos tipos de recursos: una versión de imagen de galería y/o un disco administrado. Ambos tipos de recursos se nombran usando el nombre de la plantilla de imagen de App Layering que se publica y su número de versión construido. El número de versión se construye usando los números principales y secundarios del nombre del disco de la plantilla de imagen de App Layering. Si el nombre del disco no tiene formato de versión numérica (número.número), se aplica 1.0 de forma predeterminada. El número de revisión es el número de versión de la plantilla de imagen de App Layering (el número de veces que se ha publicado). A la imagen de la galería se le asigna el nombre y a la versión de la imagen de la galería se le asigna el número de versión. Al disco administrado se le asigna el nombre anexado con el número de versión o la marca de tiempo actual, según diskNameFormat.

La imagen de la galería y la versión se crean en la galería especificada por los datos personalizados. Cuando una imagen se publica varias veces, se agrega una nueva versión a la imagen de la galería de proceso y la versión anterior permanece.

Datos personalizados de la imagen en capas

R = Obligatorio, O = Opcional, - = No usado

Nombre Tipo Descripción Predeterminado Imagen de galería Disco administrado
publishAs string o array El tipo de recurso(s) que se va a crear. Se especifica como una matriz o cadena que consta de ‘galleryImage’ y/o ‘managedDisk’ [“galleryImage”] O R
location string La región donde se crean los recursos. La misma región que el grupo de recursos de destino O O
generation string La generación de la máquina virtual que admitirá la imagen. “V2” O O
NVMe boolean true para habilitar los controladores de disco NVMe, false en caso contrario. Este debe ser el mismo valor para todos los tipos de implementación. false O O
acceleratedNetworking boolean true para habilitar la red acelerada, false en caso contrario. Este debe ser el mismo valor para todos los tipos de implementación. false O O
trustedLaunch boolean true para habilitar el inicio de confianza, false en caso contrario. Este debe ser el mismo valor para todos los tipos de implementación. false O O
gallery string El nombre de la galería de proceso en la que crear la imagen. La galería debe estar en el grupo de recursos de destino. - R -
replicaCount number El número predeterminado de réplicas por región de la versión de la imagen de la galería 1 O -
imageStorageAccountType string Especifica el tipo de cuenta de almacenamiento que se usará para almacenar la imagen. “Standard_LRS” O -
targetRegions array Las regiones de destino de la versión de la imagen de la galería. Se especifica como una matriz de cadenas de nombres de región y/o objetos TargetRegion. La matriz debe contener la región del disco de origen (según lo especificado por los datos personalizados de location). La región especificada por los datos personalizados de location O -
storageSku string El nombre de la SKU que se usará. “StandardSSD_LRS” - O
diskAccessId string El ID de recurso del acceso al disco que se usará al cargar el contenido del disco. Si se especifica, el disco se crea con el acceso a la red pública deshabilitado. null - O
diskNameFormat string Controla el nombre de las imágenes publicadas como discos administrados. “version” para anexar la versión al nombre de la imagen, “timestamp” para anexar la hora de publicación. “version” - O

Plantilla de imagen en capas

  • 1.2.0.0
    • Se agregó compatibilidad con la red acelerada
    • Se agregó compatibilidad con los controladores de disco NVMe
    • Se agregó la capacidad de especificar el tipo de cuenta de almacenamiento de las versiones de imagen de la galería
    • Se agregó la opción de nombrar los discos administrados usando la hora de publicación en lugar de la versión de la imagen (similar a la nomenclatura heredada)
    • Se corrigió un error que hacía que galleryName fuera obligatorio incluso cuando no se publicaba como una versión de imagen de galería
  • 1.1.0.0
    • Se agregó compatibilidad con el inicio de confianza
    • Se agregó compatibilidad con el recuento de réplicas y la región de destino para las versiones de imagen de la galería
    • Se agregó compatibilidad con la publicación como disco administrado
  • 1.0.0.0 - Versión inicial
{
    "$schema": "https://schema.management.azure.com/schemas/2019-04-01/deploymentTemplate.json#",
    "contentVersion": "1.2.0.0",
    "parameters": {
        "al": {
            "type": "object"
        },
        "timestamp": {
            "type": "string",
            "defaultValue": "[utcNow('yyyy-MM-dd_HH-mm-ss')]"
        }
    },
    "variables": {
        "invalidChars": [ " ", "(", ")", "[[", "]", "{", "}", "!", "@", "#", "$", "%", "^", "&", "*", "+", "/", "\\", "'", "\"", "|", "`", "~", "<", ">", ",", "?", "*" ],
        "numericChars": [ "0", "1", "2", "3", "4", "5", "6", "7", "8", "9" ],
        "custom": "[parameters('al').context.config.custom]",
        "location": "[if(contains(variables('custom'), 'location'), variables('custom').location, resourceGroup().location)]",
        "name": "[join(split(parameters('al').context.item.name, variables('invalidChars')), '_')]",
        "tags": {
            "alTaskId": "[parameters('al').context.taskId]",
            "alUser": "[parameters('al').context.user]",
            "alComment": "[parameters('al').context.comment]",
            "alItemType": "[parameters('al').context.item.type]",
            "alItemId": "[parameters('al').context.item.id]",
            "alItemName": "[parameters('al').context.item.name]",
            "alItemVersion": "[parameters('al').context.item.version.name]",
            "alConfigId": "[parameters('al').context.config.id]",
            "alConfigName": "[parameters('al').context.config.name]"
        },
        "splitVer": "[split(parameters('al').input.diskName, '.')]",
        "major": "[if(equals(0, length(join(split(variables('splitVer')[0], variables('numericChars')), ''))), variables('splitVer')[0], '1')]",
        "minor": "[if(greater(length(variables('splitVer')), 1), if(equals(0, length(join(split(variables('splitVer')[1], variables('numericChars')), ''))), variables('splitVer')[1], '0'), '0')]",
        "version": "[format('{0}.{1}.{2}', variables('major'), variables('minor'), parameters('al').context.item.version.number)]",
        "galleryName": "[if(contains(variables('custom'), 'gallery'), variables('custom').gallery, 'galleryName.required.in.custom.data')]",
        "generation": "[if(contains(variables('custom'), 'generation'), variables('custom').generation, 'V2')]",
        "trustedLaunch": "[if(contains(variables('custom'), 'trustedLaunch'), variables('custom').trustedLaunch, false())]",
        "acceleratedNetworking": "[if(contains(variables('custom'), 'acceleratedNetworking'), variables('custom').acceleratedNetworking, false())]",
        "NVMe": "[if(contains(variables('custom'), 'NVMe'), variables('custom').NVMe, false())]",
        "replicaCount": "[if(contains(variables('custom'), 'replicaCount'), variables('custom').replicaCount, 1)]",
        "targetRegions": "[if(contains(variables('custom'), 'targetRegions'), variables('custom').targetRegions, createArray(variables('location')))]",
        "diskNames": {
            "version": "[format('{0}_{1}-{2}-{3}', variables('name'), variables('major'), variables('minor'), parameters('al').context.item.version.number)]",
            "timestamp": "[format('{0}_{1}', variables('name'), parameters('timestamp'))]"
        },
        "diskName": "[variables('diskNames')[coalesce(tryGet(variables('custom'), 'diskNameFormat'), 'version')]]",
        "hasDiskAccess": "[contains(variables('custom'), 'diskAccessId')]",
        "storageSku": "[if(contains(variables('custom'), 'storageSku'), variables('custom').storageSku, 'StandardSSD_LRS')]",
        "imageStorageAccountType": "[coalesce(tryGet(variables('custom'), 'imageStorageAccountType'), 'Standard_LRS')]",
        "publishAs": "[if(contains(variables('custom'), 'publishAs'), variables('custom').publishAs, createArray('galleryImage'))]",
        "galleryLink": "[format('[link=\"{0}/#@{1}/resource/{2}\"]{2}[/link].', environment().portal, tenant().tenantId, resourceId('Microsoft.Compute/galleries/images/versions', variables('galleryName'), variables('name'), variables('version')))]",
        "diskLink": "[format('[link=\"{0}/#@{1}/resource/{2}\"]{2}[/link].', environment().portal, tenant().tenantId, resourceId('Microsoft.Compute/disks', variables('diskName')))]",
        "outputLinks": "[filter(createArray(if(contains(variables('publishAs'), 'galleryImage'), variables('galleryLink'), null()), if(contains(variables('publishAs'), 'managedDisk'), variables('diskLink'), null())), lambda('link', not(equals(lambdaVariables('link'), null()))))]",
        "possibleFeatures": [
            {
                "include": "[variables('trustedLaunch')]",
                "feature": {
                    "name": "SecurityType",
                    "value": "TrustedLaunch"
                }
            },
            {
                "include": "[variables('acceleratedNetworking')]",
                "feature": {
                    "name": "IsAcceleratedNetworkSupported",
                    "value": "True"
                }
            },
            {
                "include": "[variables('NVMe')]",
                "feature": {
                    "name": "DiskControllerTypes",
                    "value": "NVMe, SCSI"
                }
            }
        ]
    },
    "resources": [
        {
            "condition": "[contains(variables('publishAs'), 'galleryImage')]",
            "type": "Microsoft.Compute/galleries/images",
            "name": "[format('{0}/{1}', variables('galleryName'), variables('name'))]",
            "apiVersion": "2021-07-01",
            "location": "[variables('location')]",
            "properties": {
                "description": "[parameters('al').context.item.description]",
                "features": "[map(filter(variables('possibleFeatures'), lambda('x', lambdaVariables('x').include)), lambda('x', lambdaVariables('x').feature))]",
                "hyperVGeneration": "[variables('generation')]",
                "osType": "Windows",
                "osState": "Specialized",
                "endOfLifeDate": "2030-01-01T00:00:00Z",
                "identifier": {
                    "publisher": "AppLayering",
                    "offer": "[variables('name')]",
                    "sku": "[variables('generation')]"
                }
            },
            "tags": "[variables('tags')]",
            "resources": [
                {
                    "condition": "[contains(variables('publishAs'), 'galleryImage')]",
                    "type": "versions",
                    "apiVersion": "2022-03-03",
                    "name": "[variables('version')]",
                    "location": "[variables('location')]",
                    "dependsOn": [
                        "[resourceId('Microsoft.Compute/galleries/images', variables('galleryName'), variables('name'))]"
                    ],
                    "tags": "[variables('tags')]",
                    "properties": {
                        "publishingProfile": {
                            "replicaCount": "[variables('replicaCount')]",
                            "storageAccountType": "[variables('imageStorageAccountType')]",
                            "targetRegions": "[map(variables('targetRegions'), lambda('item', if(contains(lambdaVariables('item'), 'name'), lambdaVariables('item'), createObject('name', lambdaVariables('item')))))]"
                        },
                        "storageProfile": {
                            "osDiskImage": {
                                "source": {
                                    "id": "[parameters('al').input.source.diskId]"
                                }
                            }
                        }
                    }
                }
            ]
        },
        {
            "condition": "[contains(variables('publishAs'), 'managedDisk')]",
            "type": "Microsoft.Compute/disks",
            "apiVersion": "2021-08-01",
            "name": "[variables('diskName')]",
            "location": "[variables('location')]",
            "tags": "[variables('tags')]",
            "sku": {
                "name": "[variables('storageSku')]"
            },
            "properties": {
                "osType": "Windows",
                "hyperVGeneration": "[variables('generation')]",
                "creationData": {
                    "createOption": "Copy",
                    "sourceResourceId": "[parameters('al').input.source.diskId]"
                },
                "diskAccessId": "[if(variables('hasDiskAccess'), variables('custom').diskAccessId, null())]",
                "networkAccessPolicy": "[if(variables('hasDiskAccess'), 'AllowPrivate', 'AllowAll')]",
                "publicNetworkAccess": "[if(variables('hasDiskAccess'), 'Disabled', 'Enabled')]"
            }
        }
    ],
    "outputs": {
        "message": {
            "type": "string",
            "value": "[if(empty(variables('outputLinks')), null(), format('See {0}.', join(variables('outputLinks'), ' and ')))]"
        }
    }
}
<!--NeedCopy-->
Plantillas de inicio
January 9, 2026
Contribución de: 
C
January 9, 2026
Contribución de: 
C

En este artículo

Comentarios sobre el sitio | Your privacy choices footer linkSus opciones de privacidad | Condiciones legales y de privacidad | Preferencias de cookies | Parámetros de consentimiento | docs.cloud.com
© 1999- Cloud Software Group, Inc. All rights reserved.