API version change log for deployment of Microsoft.Compute/virtualMachineScaleSets/virtualMachines

This article describes the properties that changed in each API version for microsoft.compute/virtualmachinescalesets/virtualmachines. It only covers properties that are available during deployments.

2025-04-01

Updated:

• AdditionalCapabilities: Added property 'enableFips1403Encryption'
• ProxyAgentSettings: Added property 'addProxyAgentExtension'
• VirtualMachineNetworkInterfaceConfiguration: Added property 'tags'
• VirtualMachineScaleSetNetworkConfiguration: Added property 'tags'

2024-11-01

Added:

• HostEndpointSettings
• TrackedResourceTags
• VirtualMachineIdentityUserAssignedIdentities

Removed:

• ResourceTags
• UserAssignedIdentities

Updated:

• Microsoft.Compute/virtualMachineScaleSets/virtualMachines: Added property 'systemData'
• ProxyAgentSettings: Added property 'imds'
• ProxyAgentSettings: Added property 'wireServer'
• StorageProfile: Added property 'alignRegionalDisksToVMZone'
• VirtualMachineScaleSetVMProperties: Added property 'resilientVMDeletionStatus'

2024-07-01

No properties added, updated or removed.

2024-03-01

Updated:

• DataDisk: Added property 'sourceResource'

2023-09-01

Added:

• EncryptionIdentity
• ProxyAgentSettings

Updated:

• Microsoft.Compute/virtualMachineScaleSets/virtualMachines: Added property 'etag'
• SecurityProfile: Added property 'encryptionIdentity'
• SecurityProfile: Added property 'proxyAgentSettings'

2023-07-01

Updated:

• VirtualMachineScaleSetVMProperties: Added property 'timeCreated'

2023-03-01

Updated:

• LinuxVMGuestPatchAutomaticByPlatformSettings: Added property 'bypassPlatformSafetyChecksOnUserSchedule'
• WindowsVMGuestPatchAutomaticByPlatformSettings: Added property 'bypassPlatformSafetyChecksOnUserSchedule'

2022-11-01

Updated:

• VirtualMachineScaleSetNetworkConfiguration: Removed property 'id'

2022-08-01

Updated:

• LinuxConfiguration: Added property 'enableVMAgentPlatformUpdates'
• StorageProfile: Added property 'diskControllerType'
• WindowsConfiguration: Added property 'enableVMAgentPlatformUpdates'

2022-03-01

Added:

• LinuxVMGuestPatchAutomaticByPlatformSettings
• UserAssignedIdentities
• UserAssignedIdentitiesValue
• VirtualMachineIdentity
• WindowsVMGuestPatchAutomaticByPlatformSettings

Updated:

• LinuxPatchSettings: Added property 'automaticByPlatformSettings'
• Microsoft.Compute/virtualMachineScaleSets/virtualMachines: Added property 'identity'
• PatchSettings: Added property 'automaticByPlatformSettings'

2021-11-01

Added:

• VMDiskSecurityProfile

Updated:

• ImageReference: Added property 'communityGalleryImageId'
• ManagedDiskParameters: Added property 'securityProfile'

2021-07-01

Added:

• VMSizeProperties

Updated:

• AdditionalCapabilities: Added property 'hibernationEnabled'
• HardwareProfile: Added property 'vmSizeProperties'
• ImageReference: Added property 'sharedGalleryImageId'

2021-04-01

No properties added, updated or removed.

2021-03-01

Added:

• VirtualMachineNetworkInterfaceConfiguration

Updated:

• DataDisk: Added property 'deleteOption'
• LinuxPatchSettings: Added property 'assessmentMode'
• NetworkProfile: Added property 'networkApiVersion'
• NetworkProfile: Added property 'networkInterfaceConfigurations'
• OSDisk: Added property 'deleteOption'
• PatchSettings: Added property 'assessmentMode'
• VirtualMachineScaleSetVMProperties: Added property 'userData'

2020-12-01

Added:

• LinuxPatchSettings
• UefiSettings

Updated:

• DataDisk: Added property 'detachOption'
• LinuxConfiguration: Added property 'patchSettings'
• PatchSettings: Added property 'enableHotpatching'
• SecurityProfile: Added property 'securityType'
• SecurityProfile: Added property 'uefiSettings'

2020-06-01

Added:

• PatchSettings
• SecurityProfile

Updated:

• VirtualMachineScaleSetVMProperties: Added property 'securityProfile'
• WindowsConfiguration: Added property 'patchSettings'

2019-12-01

Updated:

• DiffDiskSettings: Added property 'placement'

2019-07-01

Added:

• DiskEncryptionSetParameters

Updated:

• DataDisk: Added property 'diskIOPSReadWrite'
• DataDisk: Added property 'diskMBpsReadWrite'
• ImageReference: Added property 'exactVersion'
• ManagedDiskParameters: Added property 'diskEncryptionSet'

2019-03-01

Added:

• VirtualMachineScaleSetNetworkConfiguration
• VirtualMachineScaleSetVMNetworkProfileConfiguration
• VirtualMachineScaleSetVMProtectionPolicy

Updated:

• DataDisk: Added property 'toBeDetached'
• OSProfile: Added property 'requireGuestProvisionSignal'
• VirtualMachineScaleSetVMProperties: Added property 'modelDefinitionApplied'
• VirtualMachineScaleSetVMProperties: Added property 'networkProfileConfiguration'
• VirtualMachineScaleSetVMProperties: Added property 'protectionPolicy'

2018-10-01

No properties added, updated or removed.

2018-06-01

Added:

• AdditionalCapabilities
• DiffDiskSettings

Updated:

• LinuxConfiguration: Added property 'provisionVMAgent'
• OSDisk: Added property 'diffDiskSettings'
• OSProfile: Added property 'allowExtensionOperations'
• VirtualMachineScaleSetVMProperties: Added property 'additionalCapabilities'

2018-04-01

Updated:

• Microsoft.Compute/virtualMachineScaleSets/virtualmachines: Added property 'zones'

2017-12-01

Added:

• AdditionalUnattendContent
• BootDiagnostics
• DataDisk
• DiagnosticsProfile
• DiskEncryptionSettings
• HardwareProfile
• ImageReference
• KeyVaultKeyReference
• KeyVaultSecretReference
• LinuxConfiguration
• ManagedDiskParameters
• NetworkInterfaceReference
• NetworkProfile
• OSDisk
• OSProfile
• Plan
• ResourceTags
• SshConfiguration
• SshPublicKey
• StorageProfile
• SubResource
• VaultSecretGroup
• VirtualHardDisk
• VirtualMachineScaleSetVMProperties
• WindowsConfiguration
• WinRMConfiguration
• WinRMListener

2017-03-30

No properties added, updated or removed.

2016-04-30-preview

No properties added, updated or removed.

2016-03-30

No properties added, updated or removed.

2015-06-15

Oldest version tracked in change log