Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

...

...

The VM Clone activity parameters can be provided by manual inserted values or via IN arguments or variables:

Image RemovedImage Added

Parameters:

  • Location By ID (text box editor type) (type: string): the ID of the folder where you want to place the new virtual machine. If no value is provided, the new VM will be created in the same location as the initial VM.
  • New VM Name (text box editor type) (type: string): the name for the new virtual machine.
  • VM (text box editor type) (type: string): the input virtual machine to clone (enter the ID of the VM or the output from a VM Get activity).Virtual Machine ID (text box editor type) (type: string): the virtual machine ID.
    The value can also be obtained from activity: Get VM using the following steps:
    • use a Get VM activity to extract the VM ID:
      Image Added
    • bind the obtained VM ID (stored in variable) to the VirtualMachine ID field from VM Clone activity:
      Image Added
  • Wait (text box editor type) (type: string): if the parameter is set to 'true', the activity waits for the task execution to complete before moving to the next activity.

...

  • Output VM ID (type: string): outputs the new virtual machine ID.
 

 As mentioned above, the values for all the required parameters can be provided by IN arguments or variables. Below is an example of predefined arguments, ready to be used by the VM Clone activity:

Image RemovedExecution: The example below is an execution where a new vm is cloned after DemoWin7 virtual machine:

Image Added

 

VM Create

This activity creates a new virtual machine on Host.

...

The VM Create activity parameters can be provided by manual inserted values or via IN arguments or variables:

Image RemovedImage Added

Parameters:

  • Datacenter (text box editor type) (type: string): the datacenter root name.
  • Datastore (text box editor type) (type: string): the datastore name where you want to place the new virtual machine.
  • Disk Provisioning (combo box control) (type: string): the datastore name where you want to place the new virtual machine.Disk Provisioning (combo box control) (type: string): the virtual disk provisioning mode: the virtual disk provisioning mode.Flowster Studio provides the following options:
    • Thick Provision Lazy Zeroed: Creates a virtual disk in a default thick format. Space required for the virtual disk is allocated when the virtual disk is created. Data remaining on the physical device is not erased during creation, but is zeroed out on demand at a later time on first write from the virtual machine.
    • Thick Provision Eager Zeroed: A type of thick virtual disk that supports clustering features such as Fault Tolerance. Space required for the virtual disk is allocated at creation time. In contrast to the flat format, the data remaining on the physical device is zeroed out when the virtual disk is created. It might take much longer to create disks in this format than to create other types of disks.
    • Thin Provision: Use this format to save storage space. For the thin disk, you provision as much datastore space as the disk would require based on the value that you enter for the disk size. However, the thin disk starts small and at first, uses only as much datastore space as the disk needs for its initial operations.
  • Disk MB (text box editor type) (type: string): the size in MB of the disks that you want to create and add to the new virtual machine.
  • Guest ID (text box editor type) (type: string): the guest operating system id of the new virtual machine.
  • Host (text box editor type) (type: string): the host on which you want to create the new virtual machine.
  • Location (text box editor type) (type: string): the folder where you want to place the new virtual machine.For example: root/folder/sub-folder.
  • Location By ID (text box editor type) (type: string): the ID of the folder where you want to place the new virtual machine. If you enter a value for this parameter, the 'Location' parameter is ignored.
  • Memory MB (text box editor type) (type: string): the memory size in MB of the new virtual machine.
  • New VM Name (text box editor type) (type: string): the name for the new virtual machine. If you are registering or cloning an existing virtual machine, this parameter is not mandatory.
  • Num CPU (text box editor type) (type: string): the number of the virtual CPUs of the new virtual machine.
  • VM Description (text box editor type) (type: string): the description of the new virtual machine.
  • Wait (text box editor type) (type: string): if the parameter is set to 'true', the activity waits for the task execution to complete before moving to the next activity. 

...

  • Output (type: string): outputs the new virtual machine ID.
 

 As mentioned above, the values for all the required parameters can be provided by IN arguments or variables. Below is an example of predefined arguments, ready to be used by the VM Create activity:

Image Removed


 Execution: The example below is an execution where a new vm is created with given specifications:

Image Added

VM Create Screenshot

This activity creates a screenshot of the specified virtual machine.

Activity Parameters

The VM Create Screenshot activity parameters can be provided by manual inserted values or via IN arguments or variables:

Parameters:

  • Virtual Machine ID (text box editor type) (type: string): the virtual machine you want to create screenshot.
    The value can also be obtained from activity: Get VM using the following steps:
    • use a Get VM activity to extract the VM ID:
    • bind the obtained VM ID (stored in variable) to the VirtualMachine ID field from VM Create Screenshot activity:
  • Wait (text box editor type) (type: string): if the parameter is set to 'true', the activity waits for the task execution to complete before moving to the next activity.


 

VM Create Secondary

This activity creates secondary virtual machine for the specified virtual machine.

Activity Parameters

The VM Create Secondary activity parameters can be provided by manual inserted values or via IN arguments or variables:

Parameters:

  • Host (text box editor type) (type: string): the name of the host.
  • Host ID (text box editor type) (type: string): the ID of the host. If you enter a value for this parameter, the 'Host IP' parameter is ignored.
  • Virtual Machine ID (text box editor type) (type: string): the virtual machine you want to create secondary virtual machine (Enter the ID of the virtual machine or bind this parameter with the output parameter from Get VM activity).
  • Wait (text box editor type) (type: string): if the parameter is set to 'true', the activity waits for the task execution to complete before moving to the next activity.

As mentioned above, the values for all the required parameters can be provided by IN arguments or variables. Below is an example of predefined arguments, ready to be used by the VM Create Secondary activity:



 

VM Customize

This activity customize a virtual machine using a designated script.

Activity Parameters

The VM Customize activity parameters can be provided by manual inserted values or via IN arguments or variables:

Parameters:

  • Customization Spec (text box editor type) (type: string): the customization spec that will be used to customize the virtual machine.
  • Virtual Machine ID (text box editor type) (type: string): the virtual machine you want to customize (Enter the ID of the virtual machine or bind this parameter with the output parameter from Get VM activity).

The Read Only Output variable are the possible output values that the activity will provide:

  • Output (type: string): outputs the result message from the editing action.
 

As mentioned above, the values for all the required parameters can be provided by IN arguments or variables. Below is an example of predefined arguments, ready to be used by the VM Customize activity:



 

VM Defragment All Disks

This activity defragments all disks of the specified virtual machine.

Activity Parameters

The VM Defragment All Disks activity parameters can be provided by manual inserted values or via IN arguments or variables:

Parameters:

  • Virtual Device Name (text box editor type) (type: string): the virtual machine you want to have all disks defragmented(Enter the ID of the virtual machine or bind this parameter with the output parameter from Get VM activity).
  • Wait (text box editor type) (type: string): if the parameter is set to 'true', the activity waits for the task execution to complete before moving to the next activity.

 

 

VM Deploy

This activity deploys a new VM from an existing template.

...

 

As mentioned above, the values for all the required parameters can be provided by IN arguments or variables. Below is an example of predefined arguments, ready to be used by the VM Deploy activity:

 

 

VM Disable Secondary

This activity disables secondary virtual machine of the specified virtual machine.

...

 

As mentioned above, the values for all the required parameters can be provided by IN arguments or variables. Below is an example of predefined arguments, ready to be used by the VM Disable Secondary activity:



 

VM Edit

This activity edits the specified virtual machine.

...

  • Output (type: string): outputs the result message from the editing action.
 



 

VM Enable Secondary

This activity enables secondary virtual machine of the specified virtual machine.

...

As mentioned above, the values for all the required parameters can be provided by IN arguments or variables. Below is an example of predefined arguments, ready to be used by the VM Enable Secondary activity:



 

VM Exists

This activity verifies if the specified virtual machine exists.

...

  • Output (type: string): outputs 'true' if the specified VM exists, otherwise 'false'.
 

 

 

VM Export

This activity exports the specified virtual machine.

...

 

As mentioned above, the values for all the required parameters can be provided by IN arguments or variables.

 

 

VM Get Status

This activity retrieves the state and other related information about a virtual machine.

...

VM Get Storage Usage

This activity retrieves a subset of the storage information of this virtual machine.

Activity Parameters

The VM Get Attributes activity parameters can be provided by manual inserted values or via IN arguments or variables:

Parameters:

  • VirtualMachine ID (text box editor type) (type: string): the ID of the Virtual Machine for which you want to retrieve the storage usage information.

As mentioned above, the values for all the required parameters can be provided by IN arguments or variables. Below is an example of predefined arguments, ready to be used by the VM Get Storage Usage activity:

The Read Only Output variable are the possible output values that the activity will provide:

  • Output Commited (type: collection<string>): outputs a collection of information about the total storage space, commited to the VM across all datastores. 
  • Output Uncommited (type: collection<string>): outputs a collection of information about the additional storage space, potentially used by the VM across all datastores. 
  • Output Unshared (type: collection<string>): outputs a collection of information about the total storage space occupied by the VM across all datastores that is not shared with any other VM.

 

VM List

This activity lists all virtual machines from the specified location.

...

  • Output (type: collection<string>): outputs a collection of Snapshots .To use the elements of the collection, use Get Element From Collection activity where the Input Collection parameter should be bound to this parameter.
 



 

VM List from Host

This activity lists all virtual machines on a specified Host.

...

  • Output (type: collection<collection<string>>): outputs a collection of VMs and their IDs.To use the elements of the collection, use Get Element From Collection activity where the Input Collection parameter should be bind with this parameter.
  • Output Rows Count (type: int32): outputs Rows Count.

 

 

 

 

VM List Templates

This activity gets the list of VM templates from the specified location.

...

  • Output (type: collection<collection<string>>): outputs a collection of Templates and their IDs.To use the elements of the collection, use Get Element From Collection activity where the Input Collection parameter should be bind with this parameter.
  • Output Row Count (type: int32): outputs Rows Count.



 

VM Mark as Template

This activity marks the specified Virtual Machine as Template.

...

  • Virtual Machine ID (text box editor type) (type: string): the virtual machine you want to mark as Template(Enter the ID of the virtual machine or bind this parameter with the output parameter from Get VM activity).
  • Wait (text box editor type) (type: string): if the parameter is set to 'true', the activity waits for the task execution to complete before moving to the next activity.



 

VM Mount Tools Installer

This activity mounts Tools Installer for the specified virtual machine.

...

  • Virtual Machine ID (text box editor type) (type: string): the virtual machine you want to mount Tools Installer (Enter the ID of the virtual machine or bind this parameter with the output parameter from Get VM activity).
  • Wait (text box editor type) (type: string): if the parameter is set to 'true', the activity waits for the task execution to complete before moving to the next activity.



 

VM Move

This activity moves the specified virtual machine to the selected destination.

...

As mentioned above, the values for all the required parameters can be provided by IN arguments or variables. Below is an example of predefined arguments, ready to be used by the VM Move activity:

 

 

 

VM Power Off

This activity stops a virtual machine that has already been added to a VMware vSphere server.

...

  • Virtual Machine ID (text box editor type) (type: string): the virtual machine you want to power off (Enter the ID of the virtual machine or bind this parameter with the output parameter from Get VM activity).
  • Wait (text box editor type) (type: string): if the parameter is set to 'true', the activity waits for the task execution to complete before moving to the next activity.

 

 

 

VM Power On

This activity starts a virtual machine that has been added to a VMware vSphere server and is not already running.

...

  • Virtual Machine ID (text box editor type) (type: string): the virtual machine you want to power on (Enter the ID of the virtual machine or bind this parameter with the output parameter from Get VM activity).
  • Wait (text box editor type) (type: string): if the parameter is set to 'true', the activity waits for the task execution to complete before moving to the next activity.



 

VM Reboot Guest

This activity reboots the guest operating system of the specified virtual machine.

...

  • Virtual Machine ID (text box editor type) (type: string): the virtual machine you want to reset the guest information (Enter the ID of the virtual machine or bind this parameter with the output parameter from Get VM activity).
  • Wait (text box editor type) (type: string): if the parameter is set to 'true', the activity waits for the task execution to complete before moving to the next activity.


 

 

VM Refresh Storage Info

This activity refreshes Storage Info for the specified virtual machine.

...

  • Virtual Machine ID (text box editor type) (type: string): the virtual machine you want to refresh storage information (Enter the ID of the virtual machine or bind this parameter with the output parameter from Get VM activity).
  • Wait (text box editor type) (type: string): if the parameter is set to 'true', the activity waits for the task execution to complete before moving to the next activity.

 

 

 

VM Reload

This activity reloads the specified virtual machine.

...



VM Remove

This activity removes the specified virtual machine.

Activity Parameters

The VM Remove activity parameters can be provided by manual inserted values or via IN arguments or variables:

Parameters:

  • Virtual Machine ID (text box editor type) (type: string): the virtual machine you want to remove (Enter the ID of the virtual machine or bind this parameter with the output parameter from Get VM activity).



 

 

VM Remove All Snapshots

This activity removes All Snapshots of the specified virtual machine

...

  • Virtual Machine ID (text box editor type) (type: string): the virtual machine you want to remove all snapshots (Enter the ID of the virtual machine or bind this parameter with the output parameter from Get VM activity).
  • Wait (text box editor type) (type: string): if the parameter is set to 'true', the activity waits for the task execution to complete before moving to the next activity.


 

 

VM Remove Snapshot

This activity removes the specified Snapshot from the existing virtual machine.

...

 

As mentioned above, the values for all the required parameters can be provided by IN arguments or variables. Below is an example of predefined arguments, ready to be used by the VM Remove Snapshot activity:



 

 

VM Rename

This activity renames the specified virtual machine.

...

 

As mentioned above, the values for all the required parameters can be provided by IN arguments or variables. Below is an example of predefined arguments, ready to be used by the VM Rename activity:



 

VM Reset

This activity resets the specified virtual machine.

...

  • Virtual Machine ID (text box editor type) (type: string): the virtual machine you want to reset (Enter the ID of the virtual machine or bind this parameter with the output parameter from Get VM activity).
  • Wait (text box editor type) (type: string): if the parameter is set to 'true', the activity waits for the task execution to complete before moving to the next activity.




 

VM Reset Guest Information

...

  • Virtual Machine ID (text box editor type) (type: string): the virtual machine you want to reset the guest information (Enter the ID of the virtual machine or bind this parameter with the output parameter from Get VM activity).
  • Wait (text box editor type) (type: string): if the parameter is set to 'true', the activity waits for the task execution to complete before moving to the next activity.




 

VM Revert to Current Snapshot

...

 

As mentioned above, the values for all the required parameters can be provided by IN arguments or variables. Below is an example of predefined arguments, ready to be used by the VM Revert to Current Snapshot activity:



 

VM Set Display Resolution

...

  • Height (text box editor type) (type: string): the Screen Height.For example: 1080.
  • Virtual Machine ID (text box editor type) (type: string): the virtual machine you want to set screen resolution (Enter the ID of the virtual machine or bind this parameter with the output parameter from Get VM activity).
  • Wait (text box editor type) (type: string): if the parameter is set to 'true', the activity waits for the task execution to complete before moving to the next activity.
  • Width (text box editor type) (type: string): the Screen Width. For example: 1920.

 



 

VM Shut Down Guest

This activity shuts down the Guest Operating System of the specified virtual machine.

...

  • Virtual Machine ID (text box editor type) (type: string): the virtual machine you want to shut down guest OS (Enter the ID of the virtual machine or bind this parameter with the output parameter from Get VM activity).
  • Wait (text box editor type) (type: string): if the parameter is set to 'true', the activity waits for the task execution to complete before moving to the next activity.




 

VM Standby Guest

This activity stands By Guest of the specified virtual machine.

...

  • Virtual Machine ID (text box editor type) (type: string): the virtual machine you want to standby guest OS (Enter the ID of the virtual machine or bind this parameter with the output parameter from Get VM activity).
  • Wait (text box editor type) (type: string): if the parameter is set to 'true', the activity waits for the task execution to complete before moving to the next activity.


 

 

VM Suspend

This activity suspends the specified virtual machine.

...

  • Virtual Machine ID (text box editor type) (type: string): the virtual machine you want to suspend (Enter the ID of the virtual machine or bind this parameter with the output parameter from Get VM activity).
  • Wait (text box editor type) (type: string): if the parameter is set to 'true', the activity waits for the task execution to complete before moving to the next activity.




 

VM Take Snapshot

This activity takes a snapshot of the specified virtual machine.

...

 

As mentioned above, the values for all the required parameters can be provided by IN arguments or variables. Below is an example of predefined arguments, ready to be used by the VM Take Snapshot activity:

 

 

VM Unmount Tools Installer

...

  • Virtual Machine ID (text box editor type) (type: string): the virtual machine you want to unmount Tools installer (Enter the ID of the virtual machine or bind this parameter with the output parameter from Get VM activity).
  • Wait (text box editor type) (type: string): if the parameter is set to 'true', the activity waits for the task execution to complete before moving to the next activity.


 

 

VM Unregister

This activity unregisters the specified virtual machine.

...

  • Virtual Machine ID (text box editor type) (type: string): the virtual machine you want to unregister (Enter the ID of the virtual machine or bind this parameter with the output parameter from Get VM activity).
  • Wait (text box editor type) (type: string): if the parameter is set to 'true', the activity waits for the task execution to complete before moving to the next activity.




 

VM Upgrade Tools

This activity upgrades Tools for the specified virtual machine.

...

  • Installer Options (text box editor type) (type: string): the Installer Options that you want to upgrade.
  • Virtual Machine ID (text box editor type) (type: string): the virtual machine you want to upgrade Tools (Enter the ID of the virtual machine or bind this parameter with the output parameter from Get VM activity).
  • Wait (text box editor type) (type: string): if the parameter is set to 'true', the activity waits for the task execution to complete before moving to the next activity.



 

VM Upgrade Version

This activity upgrades Version of the specified virtual machine.

...