VirtualMachineScaleSetOSProfile Class

  • java.lang.Object
    • com.azure.resourcemanager.compute.models.VirtualMachineScaleSetOSProfile

Implements

public final class VirtualMachineScaleSetOSProfile
implements JsonSerializable<VirtualMachineScaleSetOSProfile>

Describes a virtual machine scale set OS profile.

Constructor Summary

Constructor Description
VirtualMachineScaleSetOSProfile()

Creates an instance of VirtualMachineScaleSetOSProfile class.

Method Summary

Modifier and Type Method and Description
String adminPassword()

Get the adminPassword property: Specifies the password of the administrator account.

String adminUsername()

Get the adminUsername property: Specifies the name of the administrator account.

Boolean allowExtensionOperations()

Get the allowExtensionOperations property: Specifies whether extension operations should be allowed on the virtual machine scale set.

String computerNamePrefix()

Get the computerNamePrefix property: Specifies the computer name prefix for all of the virtual machines in the scale set.

String customData()

Get the customData property: Specifies a base-64 encoded string of custom data.

static VirtualMachineScaleSetOSProfile fromJson(JsonReader jsonReader)

Reads an instance of VirtualMachineScaleSetOSProfile from the JsonReader.

LinuxConfiguration linuxConfiguration()

Get the linuxConfiguration property: Specifies the Linux operating system settings on the virtual machine.

Boolean requireGuestProvisionSignal()

Get the requireGuestProvisionSignal property: Optional property which must either be set to True or omitted.

List<VaultSecretGroup> secrets()

Get the secrets property: Specifies set of certificates that should be installed onto the virtual machines in the scale set.

JsonWriter toJson(JsonWriter jsonWriter)
void validate()

Validates the instance.

WindowsConfiguration windowsConfiguration()

Get the windowsConfiguration property: Specifies Windows operating system settings on the virtual machine.

VirtualMachineScaleSetOSProfile withAdminPassword(String adminPassword)

Set the adminPassword property: Specifies the password of the administrator account.

VirtualMachineScaleSetOSProfile withAdminUsername(String adminUsername)

Set the adminUsername property: Specifies the name of the administrator account.

VirtualMachineScaleSetOSProfile withAllowExtensionOperations(Boolean allowExtensionOperations)

Set the allowExtensionOperations property: Specifies whether extension operations should be allowed on the virtual machine scale set.

VirtualMachineScaleSetOSProfile withComputerNamePrefix(String computerNamePrefix)

Set the computerNamePrefix property: Specifies the computer name prefix for all of the virtual machines in the scale set.

VirtualMachineScaleSetOSProfile withCustomData(String customData)

Set the customData property: Specifies a base-64 encoded string of custom data.

VirtualMachineScaleSetOSProfile withLinuxConfiguration(LinuxConfiguration linuxConfiguration)

Set the linuxConfiguration property: Specifies the Linux operating system settings on the virtual machine.

VirtualMachineScaleSetOSProfile withRequireGuestProvisionSignal(Boolean requireGuestProvisionSignal)

Set the requireGuestProvisionSignal property: Optional property which must either be set to True or omitted.

VirtualMachineScaleSetOSProfile withSecrets(List<VaultSecretGroup> secrets)

Set the secrets property: Specifies set of certificates that should be installed onto the virtual machines in the scale set.

VirtualMachineScaleSetOSProfile withWindowsConfiguration(WindowsConfiguration windowsConfiguration)

Set the windowsConfiguration property: Specifies Windows operating system settings on the virtual machine.

Methods inherited from java.lang.Object

Constructor Details

VirtualMachineScaleSetOSProfile

public VirtualMachineScaleSetOSProfile()

Creates an instance of VirtualMachineScaleSetOSProfile class.

Method Details

adminPassword

public String adminPassword()

Get the adminPassword property: 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](https://docs.microsoft.com/troubleshoot/azure/virtual-machines/reset-rdp)

For resetting root password, see [Manage users, SSH, and check or repair disks on Azure Linux VMs using the VMAccess Extension](https://docs.microsoft.com/troubleshoot/azure/virtual-machines/troubleshoot-ssh-connection).

Returns:

the adminPassword value.

adminUsername

public String adminUsername()

Get the adminUsername property: Specifies the name of the administrator account.

**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.

Returns:

the adminUsername value.

allowExtensionOperations

public Boolean allowExtensionOperations()

Get the allowExtensionOperations property: Specifies whether extension operations should be allowed on the virtual machine scale set. This may only be set to False when no extensions are present on the virtual machine scale set.

Returns:

the allowExtensionOperations value.

computerNamePrefix

public String computerNamePrefix()

Get the computerNamePrefix property: Specifies the computer name prefix for all of the virtual machines in the scale set. Computer name prefixes must be 1 to 15 characters long.

Returns:

the computerNamePrefix value.

customData

public String customData()

Get the customData property: 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. For using cloud-init for your VM, see [Using cloud-init to customize a Linux VM during creation](https://docs.microsoft.com/azure/virtual-machines/linux/using-cloud-init).

Returns:

the customData value.

fromJson

public static VirtualMachineScaleSetOSProfile fromJson(JsonReader jsonReader)

Reads an instance of VirtualMachineScaleSetOSProfile from the JsonReader.

Parameters:

jsonReader - The JsonReader being read.

Returns:

An instance of VirtualMachineScaleSetOSProfile if the JsonReader was pointing to an instance of it, or null if it was pointing to JSON null.

Throws:

IOException

- If an error occurs while reading the VirtualMachineScaleSetOSProfile.

linuxConfiguration

public LinuxConfiguration linuxConfiguration()

Get the linuxConfiguration property: Specifies the Linux operating system settings on the virtual machine. For a list of supported Linux distributions, see [Linux on Azure-Endorsed Distributions](https://docs.microsoft.com/azure/virtual-machines/linux/endorsed-distros).

Returns:

the linuxConfiguration value.

requireGuestProvisionSignal

public Boolean requireGuestProvisionSignal()

Get the requireGuestProvisionSignal property: Optional property which must either be set to True or omitted.

Returns:

the requireGuestProvisionSignal value.

secrets

public List secrets()

Get the secrets property: Specifies set of certificates that should be installed onto the virtual machines in the scale set. To install certificates on a virtual machine it is recommended to use the [Azure Key Vault virtual machine extension for Linux](https://docs.microsoft.com/azure/virtual-machines/extensions/key-vault-linux) or the [Azure Key Vault virtual machine extension for Windows](https://docs.microsoft.com/azure/virtual-machines/extensions/key-vault-windows).

Returns:

the secrets value.

toJson

public JsonWriter toJson(JsonWriter jsonWriter)

Parameters:

jsonWriter

Throws:

validate

public void validate()

Validates the instance.

windowsConfiguration

public WindowsConfiguration windowsConfiguration()

Get the windowsConfiguration property: Specifies Windows operating system settings on the virtual machine.

Returns:

the windowsConfiguration value.

withAdminPassword

public VirtualMachineScaleSetOSProfile withAdminPassword(String adminPassword)

Set the adminPassword property: 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](https://docs.microsoft.com/troubleshoot/azure/virtual-machines/reset-rdp)

For resetting root password, see [Manage users, SSH, and check or repair disks on Azure Linux VMs using the VMAccess Extension](https://docs.microsoft.com/troubleshoot/azure/virtual-machines/troubleshoot-ssh-connection).

Parameters:

adminPassword - the adminPassword value to set.

Returns:

the VirtualMachineScaleSetOSProfile object itself.

withAdminUsername

public VirtualMachineScaleSetOSProfile withAdminUsername(String adminUsername)

Set the adminUsername property: Specifies the name of the administrator account.

**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.

Parameters:

adminUsername - the adminUsername value to set.

Returns:

the VirtualMachineScaleSetOSProfile object itself.

withAllowExtensionOperations

public VirtualMachineScaleSetOSProfile withAllowExtensionOperations(Boolean allowExtensionOperations)

Set the allowExtensionOperations property: Specifies whether extension operations should be allowed on the virtual machine scale set. This may only be set to False when no extensions are present on the virtual machine scale set.

Parameters:

allowExtensionOperations - the allowExtensionOperations value to set.

Returns:

the VirtualMachineScaleSetOSProfile object itself.

withComputerNamePrefix

public VirtualMachineScaleSetOSProfile withComputerNamePrefix(String computerNamePrefix)

Set the computerNamePrefix property: Specifies the computer name prefix for all of the virtual machines in the scale set. Computer name prefixes must be 1 to 15 characters long.

Parameters:

computerNamePrefix - the computerNamePrefix value to set.

Returns:

the VirtualMachineScaleSetOSProfile object itself.

withCustomData

public VirtualMachineScaleSetOSProfile withCustomData(String customData)

Set the customData property: 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. For using cloud-init for your VM, see [Using cloud-init to customize a Linux VM during creation](https://docs.microsoft.com/azure/virtual-machines/linux/using-cloud-init).

Parameters:

customData - the customData value to set.

Returns:

the VirtualMachineScaleSetOSProfile object itself.

withLinuxConfiguration

public VirtualMachineScaleSetOSProfile withLinuxConfiguration(LinuxConfiguration linuxConfiguration)

Set the linuxConfiguration property: Specifies the Linux operating system settings on the virtual machine. For a list of supported Linux distributions, see [Linux on Azure-Endorsed Distributions](https://docs.microsoft.com/azure/virtual-machines/linux/endorsed-distros).

Parameters:

linuxConfiguration - the linuxConfiguration value to set.

Returns:

the VirtualMachineScaleSetOSProfile object itself.

withRequireGuestProvisionSignal

public VirtualMachineScaleSetOSProfile withRequireGuestProvisionSignal(Boolean requireGuestProvisionSignal)

Set the requireGuestProvisionSignal property: Optional property which must either be set to True or omitted.

Parameters:

requireGuestProvisionSignal - the requireGuestProvisionSignal value to set.

Returns:

the VirtualMachineScaleSetOSProfile object itself.

withSecrets

public VirtualMachineScaleSetOSProfile withSecrets(List secrets)

Set the secrets property: Specifies set of certificates that should be installed onto the virtual machines in the scale set. To install certificates on a virtual machine it is recommended to use the [Azure Key Vault virtual machine extension for Linux](https://docs.microsoft.com/azure/virtual-machines/extensions/key-vault-linux) or the [Azure Key Vault virtual machine extension for Windows](https://docs.microsoft.com/azure/virtual-machines/extensions/key-vault-windows).

Parameters:

secrets - the secrets value to set.

Returns:

the VirtualMachineScaleSetOSProfile object itself.

withWindowsConfiguration

public VirtualMachineScaleSetOSProfile withWindowsConfiguration(WindowsConfiguration windowsConfiguration)

Set the windowsConfiguration property: Specifies Windows operating system settings on the virtual machine.

Parameters:

windowsConfiguration - the windowsConfiguration value to set.

Returns:

the VirtualMachineScaleSetOSProfile object itself.

Applies to