VMUtils - Global

  • Release version: Zurich
  • Updated July 31, 2025
  • 1 minute to read
  • The VMUtils script include provides methods for discovery and provisioning of virtual machines.

    This script include is available in server-side scripts to convert between UUID and Correlation ID formats.

    VMUtils - turnCorrelationIdToUuid(String correlationId)

    Converts a correlation ID into a UUID for a virtual machine in the ServiceNow system.

    Table 1. Parameters
    Name Type Description
    correlationId String The correlation ID to convert
    Table 2. Returns
    Type Description
    String The UUID, or an empty string if invalid.
    gs.info(VMUtils.turnCorrelationIdToUuid('42 10 82 82 62 35 ca 68-b5 1c 1e f8 5c 0a 0d 5b'));

    Output:

    42108282-6235-ca68-b51c-1ef85c0a0d5b

    VMUtils - turnUuidToCorrelationId(String uuid)

    Converts a WMware universal unique identifier (UUID) to a format that matches the original format in the ServiceNow system.

    vCenter works with UUIDs where the ESXi Linux console worked with this format.

    Table 3. Parameters
    Name Type Description
    uuid String The UUID to convert.
    Table 4. Returns
    Type Description
    String The identifier converted to the ServiceNow format.
    gs.info(VMUtils.turnUuidToCorrelationId('13eb78d0-d504-11e1-9b23-0800200c9a66'));

    Output:

    13 eb 78 d0 d5 04 11 e1-9b 23 08 00 20 0c 9a 66