Using the VirtualGuestJob section


Through the VirtualGuestJob section in the Virtual Guest Job (VGJ) XML file, you can specify the following job settings:

  • JobName — Fill in a descriptive JobName for the Virtual Guest Job (VGJ) you are creating.
  • JobFolderID — You need to specify the ID of the job folder in which you want to store this job. To get the JobFolderID:

    JobGroup groupNameToId /myFolderInTheJobWorkspace
    200001

    In this example, the ID that is returned is 200001.

  • VirtualGuestDestination — The VirtualGuestDestination specifies where you want to store the new virtual guest. This value varies depending on your environment. For more information, see Getting the VirtualGuestDestination.
  • ExecuteNow — Set this to true if you want to run the VGJ immediately. Set this to false if you want to run the job at some other time.
    • If you set this to true (when you create the VGJ by running the Virtualization createVirtualGuest command), the command returns the following message:

      virtual guest Job running and the job DB Key is <JobDBKey>
    • If you set this to false (when you create the VGJ by running the createVirtualGuest command), the command returns the following message:

      Job is created and will execute by users request with Job DB Key <JobDBKey>
      Warning

      Note

      You can use this DBKey to manipulate and execute the job by using the commands in the Job namespace.

Warning

Note

This section in the VGJ file does not contain Server ACL information. Instead, Server ACL information is specified during job creation or modification, through the Virtual-Guest-Job-Server-ACL panel or tab. If you create a Virtual Guest Job through the BLCLI (using the createVirtualGuest command), Server ACL information cannot be specified as input, and the permissions of the selected virtualization platform are used for the Server ACL of the target VM.

 

Tip: For faster searching, add an asterisk to the end of your partial query. Example: cert*

TrueSight Server Automation 24.2