Preconditions
Related command
az vm application set
az vmss application set
Resource Provider
Microsoft.Compute/virtualmachines, Microsoft.Compute/virtualmachinescalesets
Description of Feature or Work Requested
At the present,
az vm application set
and
az vmss application set
accept the following parameters:
az vm application set --app-version-ids
[--app-config-overrides]
[--ids]
[--name]
[--order-applications]
[--resource-group]
[--subscription]
[--treat-deployment-as-failure]
az vmss application set --app-version-ids
[--app-config-overrides]
[--ids]
[--name]
[--order-applications]
[--resource-group]
[--subscription]
[--treat-deployment-as-failure]
The request is to support additional parameter that has been a part of the API spec since 2023-03-01
--enable-automatic-upgrade
"VMGalleryApplication": {
"type": "object",
"description": "Specifies the required information to reference a compute gallery application version",
"properties": {
"tags": {
"type": "string",
"description": "Optional, Specifies a passthrough value for more generic context."
},
"order": {
"type": "integer",
"format": "int32",
"description": "Optional, Specifies the order in which the packages have to be installed"
},
"packageReferenceId": {
"type": "string",
"description": "Specifies the GalleryApplicationVersion resource id on the form of /subscriptions/{SubscriptionId}/resourceGroups/{ResourceGroupName}/providers/Microsoft.Compute/galleries/{galleryName}/applications/{application}/versions/{version}"
},
"configurationReference": {
"type": "string",
"description": "Optional, Specifies the uri to an azure blob that will replace the default configuration for the package if provided"
},
"treatFailureAsDeploymentFailure": {
"type": "boolean",
"description": "Optional, If true, any failure for any operation in the VmApplication will fail the deployment"
},
"enableAutomaticUpgrade": {
"type": "boolean",
"description": "If set to true, when a new Gallery Application version is available in PIR/SIG, it will be automatically updated for the VM/VMSS"
}
},
"required": [
"packageReferenceId"
]
}
Minimum API Version Required
2023-03-01
Swagger PR link / SDK link
https://github.com/Azure/azure-rest-api-specs/pull/17988/files#diff-a1893aa026db543bfef1bfa96d44bbe54551ec9ccb62f92f4fc9c3c9d86317e2
Request Example
https://github.com/Azure/azure-rest-api-specs/blob/efb324c39958e927ada65376abb8b0f3c33c491d/specification/compute/resource-manager/Microsoft.Compute/stable/2022-03-01/ComputeRP/examples/virtualMachineExamples/VirtualMachine_Create_WithApplicationProfile.json#L37
https://github.com/Azure/azure-rest-api-specs/blob/efb324c39958e927ada65376abb8b0f3c33c491d/specification/compute/resource-manager/Microsoft.Compute/stable/2022-03-01/ComputeRP/examples/virtualMachineScaleSetExamples/VirtualMachineScaleSet_Create_WithApplicationProfile.json#L40
Target Date
2025-10-15
PM Contact
@GabstaMSFT
Engineer Contact
@D1v38om83r
Additional context
Note: all the properties under Swagger VMGalleryApplication are read-write, the Request Examples don't reflect that.
Preconditions
Related command
az vm application set
az vmss application set
Resource Provider
Microsoft.Compute/virtualmachines, Microsoft.Compute/virtualmachinescalesets
Description of Feature or Work Requested
At the present,
az vm application setand
az vmss application setaccept the following parameters:
The request is to support additional parameter that has been a part of the API spec since 2023-03-01
--enable-automatic-upgradeMinimum API Version Required
2023-03-01
Swagger PR link / SDK link
https://github.com/Azure/azure-rest-api-specs/pull/17988/files#diff-a1893aa026db543bfef1bfa96d44bbe54551ec9ccb62f92f4fc9c3c9d86317e2
Request Example
https://github.com/Azure/azure-rest-api-specs/blob/efb324c39958e927ada65376abb8b0f3c33c491d/specification/compute/resource-manager/Microsoft.Compute/stable/2022-03-01/ComputeRP/examples/virtualMachineExamples/VirtualMachine_Create_WithApplicationProfile.json#L37
https://github.com/Azure/azure-rest-api-specs/blob/efb324c39958e927ada65376abb8b0f3c33c491d/specification/compute/resource-manager/Microsoft.Compute/stable/2022-03-01/ComputeRP/examples/virtualMachineScaleSetExamples/VirtualMachineScaleSet_Create_WithApplicationProfile.json#L40
Target Date
2025-10-15
PM Contact
@GabstaMSFT
Engineer Contact
@D1v38om83r
Additional context
Note: all the properties under Swagger VMGalleryApplication are read-write, the Request Examples don't reflect that.