...
The VM Create CDRom 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 on which you want to create the Virtual CDRom (Enter the ID of the virtual machine or bind this parameter with the output parameter from Get VM activity)..
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 CDRom activity:
- use a Get VM activity to extract the VM ID:
Properties (parameters):
- Allow Guest Control (combo box control) (type: string): allow the guest to control whether the connectable device is connected..
- Connected (combo box control) (type: string): flag indicating the device is currently connected. Valid only while the virtual machine is running.
- Controller Key (text box editor type) (type: int32): the object key that denotes the controller object for this device. You need a 'VirtualIDEController' type Key. To obtain the controller key please use the output collection named ControllerKeys from the 'VMListControllers' activity.Device Name (text box
The value can also be obtained from activity: VM List Controllers using the following steps:- use a VM List Controllers activity to extract the Controller Key:
- Iterate through the list of returned controllers and select the desired controller key using Get Element From Collection activity and desired index:
- bind the obtained Controller Key (stored in variable) to the Controller Key field from VM Create CDRom activity. The value stored in ControllerKey variable is converted to Int32:
- use a VM List Controllers activity to extract the Controller Key:
- Device Name (text box editor type) (type: string): the name of the device on the remote system.
- Exclusive Access (combo box control) (type: string): whether or not the virtual machine has exclusive access to the CD-ROM device.
- Start Connected (combo box control) (type: string): flag to specify whether or not to connect the device when the virtual machine starts.
- Use Auto Detect (combo box control) (type: string): flag to indicate whether the network should be auto detected instead of directly specified.
...
- Output (type: string): outputs message.
- Output Status (type: boolean): outputs True if the operation succeeded otherwise False.
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 CDRom activity:
VM Create Ethernet Device
...
The VM Create Ethernet Device activity parameters can be provided by manual inserted values or via IN arguments or variables:
Parameters:
- Cluster Name (text box editor type) (type: string): the name of the Cluster (only necessary if 'Host' parameter is empty).
- Datacenter (text box editor type) (type: string): the datacenter root name.
- Host (text box editor type) (type: string): the host on which you want to create the Virtual Ethernet Device.
- Port Group Key (text box editor type) (type: string): the Port Group Key ID of the network adapter which you want to set for the new virtual machine. Only needed when the network is port group type. Bind the value to the output 'PortGroupKey' from 'GetNetworkAdapterProperties' activity.
- Virtual Machine ID (text box editor type) (type: string): the virtual machine on which you want to create the Ethernet Device (Enter the ID of the virtual machine or bind this parameter with the output parameter from Get VM activity)..
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 Ethernet Device activity:
- use a Get VM activity to extract the VM ID:
- VM Network Type (combo box control) (type: string): the network adapter type for the virtual machine.
...
- Output (type: string): outputs message.
- Output Status (type: boolean): outputs True if the operation succeeded otherwise False.
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 Ethernet Device activity:
Execution: The example below is an execution where a new ethernet device is created for VM with ID vm-25:
VM Create Virtual Disk
This activity creates a new Virtual Disk on the specified virtual machine.
...
The VM Create Virtual Disk activity parameters can be provided by manual inserted values or via IN arguments or variables:
Parameters:
- Datastore Name (text box editor type) (type: string): the name of the Datastore on which you want to create the Virtual Disk or bind it to the output parameter collection 'Output' from VM List Datastores activity.
- Virtual Machine ID (text box editor type) (type: string): the virtual machine on which you want the new Virtual Disk to be created (Enter the ID of the virtual machine or bind this parameter with the output parameter from Get VM activity)..
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 Virtual Disk activity:
- use a Get VM activity to extract the VM ID:
Properties (parameters):
- Capacity in KB (text box editor type) (type: int64): the disk size in kilobytes to allocate to the virtual machine disk.
- Controller Key (text box editor type) (type: int32): the object key that denotes the controller object for this device. You need a 'VirtualLsiLogicSASController' type Key. To obtain the controller key please use the output collection named ControllerKeys from the 'VMListControllers' activity.
The value can also be obtained from activity: VM List Controllers using the following steps:- use a VM List Controllers activity to extract the Controller Key:
- Iterate through the list of returned controllers and select the desired controller key using Get Element From Collection activity and desired index:
- bind the obtained Controller Key (stored in variable) to the Controller Key field from VM Create Virtual Disk activity. The value stored in ControllerKey variable is converted to Int32:
- use a VM List Controllers activity to extract the Controller Key:
- Disk Mode (combo box control) (type: string): specify the disk persistence mode. Valid modes are: persistent->Changes are immediately and permanently written to the virtual disk, independent_nonpersistent->Same as nonpersistent, but not affected by snapshots, independent_persistent->Same as persistent, but not affected by snapshots.
- Disk Name (text box editor type) (type: string): the name of the Disk.
- Eagerly Scrub (combo box control) (type: string): specify to the underlying file system whether the virtual disk backing file should be scrubbed completely at this time.Virtual disks on some filesystems like VMFS3 are zeroed-out lazily so that disk creation time doesn't take too long. However, clustering applications and features like Fault Tolerance require that the virtual disk be completely scrubbed. This setting allows controlling the scrubbing policy on a per-disk basis.
- Split (combo box control) (type: string): the type of virtual disk file: split or monolithic. If true, the virtual disk is stored in multiple files, each 2GB.
- Thin Provisioned (combo box control) (type: string): specify to the underlying file system, whether the virtual disk backing file should be allocated lazily (using thin provisioning). This flag is only used for file systems that support configuring the provisioning policy on a per file basis, such as VMFS3.
- Write Through (combo box control) (type: string): whether writes should go directly to the file system or should be buffered.
...
- Output (type: string): outputs message.
- Output Status (type: boolean): outputs True if the operation succeeded otherwise False.
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 Virtual Disk activity:
...
VM Edit CDRom
This activity edits the specified Virtual CDRom on the 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 Edit Ethernet Device activity:
VM Edit Virtual Disk
This activity edits the specified Virtual Disk on the 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 Edit Virtual Disk activity:
VM Get Virtual CDRom
This activity returns the desired Virtual CDRom ID found on 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 Get Virtual CDRom activity:
VM Get Virtual Disk
This activity returns the desired Virtual Disk ID found on the specified Virtual Machine.
...
- Output (type: collection>collection<string>>): outputs a collection of sub-collections containing information about Controller Devices.
- Output Controller Keys (type: collection<int32>): outputs a collection of Controller Keys.
VM List Virtual CDRoms
This activity lists all the Virtual CDRoms from the specified Virtual Machine.
...
- Output (type: collection>collection<string>>): outputs a collection of sub-collections containing information about Virtual CDRom Devices.
- Output Controller Keys (type: collection<int32>): outputs a collection of Keys from the found Devices.
VM List Virtual Disks
This activity lists all the Virtual Disks from the specified Virtual Machine.
...
- Output (type: collection>collection<string>>): outputs a collection of sub-collections containing information about Virtual Disk Devices.
- Output Devices Keys (type: collection<int32>): outputs a collection of Keys from the found Devices.
VM List Virtual Ethernet Devices
...
- Output (type: collection>collection<string>>): outputs a collection of sub-collections containing information about Virtual Ethernet Devices.
- Output Devices Keys (type: collection<int32>): outputs a collection of Keys from the found Devices.
VM Remove Virtual CDRom
This activity removes the desired Virtual CDRom from the specified virtual machine.
...
- Output Status (type: boolean): outputs True if the operation succeeded otherwise False.
VM Remove Virtual Disk
This activity removes the desired Virtual Disk from the specified virtual machine.
...
- Output Status (type: boolean): outputs True if the operation succeeded otherwise False.
VM Remove Virtual Ethernet Device
...