Guest customization Settings to customize a Linux guest operating system. The LinuxConfiguration structure contains settings that identify a Linux machine in the same way that the WindowsConfiguration structure identifies a Windows machine.


domain Required

The fully qualified domain name.

hostname Required

The network host name of the Linux virtual machine.

script_text Optional

The script to run before and after Linux guest customization. The max size of the script is 1500 bytes. As long as the script (shell, perl, python…) has the right “#!” in the header, it is supported. The caller should not assume any environment variables when the script is run. The script is invoked by the customization engine using the command line: 1) with argument “precustomization” before customization, 2) with argument “postcustomization” after customization. The script should parse this argument and implement pre-customization or post-customization task code details in the corresponding block.

A Linux shell script example:

#!/bin/sh if [ x\(1 == x"precustomization" ]; then echo "Do Precustomization tasks" #code for pre-customization actions... elif [ x\)1 == x”postcustomization” ]; then echo “Do Postcustomization tasks” #code for post-customization actions… fi

If unset, no script will be executed.

time_zone Optional

The case-sensitive time zone, such as Europe/Sofia. Valid time zone values are based on the tz (time zone) database used by Linux. The values are strings (string) in the form “Area/Location,” in which Area is a continent or ocean name, and Location is the city, island, or other regional designation. See the for a list of supported time zones for different versions in Linux.

If unset, time zone is not modified inside guest operating system.

JSON Example

    "domain": "string",
    "hostname": {
        "type": "enum"

Was this page helpful?