OSProfile interface
Specifies the operating system settings for the virtual machine. Some of the settings cannot be changed once VM is provisioned.
Properties
admin |
Specifies the password of the administrator account. |
admin |
Specifies the name of the administrator account. |
allow |
Specifies whether extension operations should be allowed on the virtual machine. |
computer |
Specifies the host OS name of the virtual machine. |
custom |
Specifies a base-64 encoded string of custom data. The base-64 encoded string is decoded to a binary array that is saved as a file on the Virtual Machine. The maximum length of the binary array is 65535 bytes. |
linux |
Specifies the Linux operating system settings on the virtual machine. |
require |
Specifies whether the guest provision signal is required to infer provision success of the virtual machine. Note: This property is for private testing only, and all customers must not set the property to false. |
secrets | Specifies set of certificates that should be installed onto the virtual machine. |
windows |
Specifies Windows operating system settings on the virtual machine. |
Property Details
adminPassword
Specifies the password of the administrator account.
Minimum-length (Windows): 8 characters
Minimum-length (Linux): 6 characters
Max-length (Windows): 123 characters
Max-length (Linux): 72 characters
Complexity requirements: 3 out of 4 conditions below need to be fulfilled
Has lower characters
Has upper characters
Has a digit
Has a special character (Regex match [\W_])
Disallowed values: "abc@123", "P@$$w0rd", "P@ssw0rd", "P@ssword123", "Pa$$word", "pass@word1", "Password!", "Password1", "Password22", "iloveyou!"
For resetting the password, see How to reset the Remote Desktop service or its login password in a Windows VM
For resetting root password, see Manage users, SSH, and check or repair disks on Azure Linux VMs using the VMAccess Extension
adminPassword?: string
Property Value
string
adminUsername
Specifies the name of the administrator account.
This property cannot be updated after the VM is created.
Windows-only restriction: Cannot end in "."
Disallowed values: "administrator", "admin", "user", "user1", "test", "user2", "test1", "user3", "admin1", "1", "123", "a", "actuser", "adm", "admin2", "aspnet", "backup", "console", "david", "guest", "john", "owner", "root", "server", "sql", "support", "support_388945a0", "sys", "test2", "test3", "user4", "user5".
Minimum-length (Linux): 1 character
Max-length (Linux): 64 characters
Max-length (Windows): 20 characters
adminUsername?: string
Property Value
string
allowExtensionOperations
Specifies whether extension operations should be allowed on the virtual machine.
This may only be set to False when no extensions are present on the virtual machine.
allowExtensionOperations?: boolean
Property Value
boolean
computerName
Specifies the host OS name of the virtual machine.
This name cannot be updated after the VM is created.
Max-length (Windows): 15 characters
Max-length (Linux): 64 characters.
For naming conventions and restrictions see Azure infrastructure services implementation guidelines.
computerName?: string
Property Value
string
customData
Specifies a base-64 encoded string of custom data. The base-64 encoded string is decoded to a binary array that is saved as a file on the Virtual Machine. The maximum length of the binary array is 65535 bytes.
Note: Do not pass any secrets or passwords in customData property
This property cannot be updated after the VM is created.
customData is passed to the VM to be saved as a file, for more information see Custom Data on Azure VMs
For using cloud-init for your Linux VM, see Using cloud-init to customize a Linux VM during creation
customData?: string
Property Value
string
linuxConfiguration
Specifies the Linux operating system settings on the virtual machine.
For a list of supported Linux distributions, see Linux on Azure-Endorsed Distributions
For running non-endorsed distributions, see Information for Non-Endorsed Distributions.
linuxConfiguration?: LinuxConfiguration
Property Value
requireGuestProvisionSignal
Specifies whether the guest provision signal is required to infer provision success of the virtual machine. Note: This property is for private testing only, and all customers must not set the property to false.
requireGuestProvisionSignal?: boolean
Property Value
boolean
secrets
Specifies set of certificates that should be installed onto the virtual machine.
secrets?: VaultSecretGroup[]
Property Value
windowsConfiguration
Specifies Windows operating system settings on the virtual machine.
windowsConfiguration?: WindowsConfiguration