VMware: Power On VM powers on a powered-off or suspended virtual machine.
No.
Field Name
Description
1
Step Name
Name of the step. This name has to be unique in a single workflow.
Configuration:
1
vCenter Server Base URL
Specify the vCenter Server Base URL to connect to vCenter.
(e.g.: https://vmware.example.com)Note: If vCenter IP is given instead of vCenter server name, it throws certificate error, because the certificate contains entry of vCenter server in FQDN (Fully Qualified Domain Name) format.
2
Port
Specify the vCenter server port. (Default port is 443).
This field should be an integer and value should be less than 65536.
3
Username
Specify a Username to authenticate vCenter server.
Password:
The password to authenticate vCenter server.
4
Accept value as variable/static
Leave checkbox unchecked to accept Password value from a field in the previous steps of the stream using a drop down list.
Else enable checkbox for Password field to appear as Text box.
5
Password
Password is entered using a widget. The widget handles both Text (static value or environment variable) and Combo (drop down containing values from previous steps). This field is mandatory.
If checkbox above is enabled Password field appears as Text box and accepts static or variable values. Else if checkbox above is disabled Password field appears as a drop down to select fields from previous steps. Please note that Field values can only be accessed when workflow is in running state.
6
Button: Test Connection
Verifies whether the connection is available or not.
For the purpose of verification fields coming from previous steps are not allowed since field values can only be accessed when workflow is in running state. Static values and environment variables are allowed.
Input Tab:
No.
Field Name
Description
Input Fields:
1
Virtual Machine Name/UUID
Specify the Name/UUID of the virtual machine to Power On.
This field data type is String. This field is mandatory.
Notes:
- Refer Get VM UUID in the VMWare Plugin introduction for steps to fetch the VM UUID.
- If two or more virtual machines with the same name appear in the vCenter Server inventory, then you may provide the UUID which is unique to each VM.
- If VM name contains ‘%’ special character then to execute the plugin step, provide VM name by replacing ‘%’ character with ‘%25’.
2
Button: Get
On click of this button, if the connection is successfully established it populates the list of Virtual Machine Names on the vCenter server.
Note: If VM name contains ‘%’ special character then on click of ‘Get’ button, the VM name is returned by replacing ‘%’ character with ‘%25’. You may leave it like that.
Common Buttons:
No.
Field Name
Description
Buttons:
1
OK
Click this button to check and save the field values. If any required field values are missing then it will display a validation error message else if all the required field values are provided then it will save the field values.
2
Cancel
Click this button, to cancel the window and does not save any values.
VMware: Rename Snapshot plugin step is designed to rename snapshot associated with VM on specified vCenter server.
No.
Field Name
Description
1
Step Name
Name of the step. This name has to be unique in a single workflow.
Configuration:
1
vCenter Server Base URL
Specify the vCenter Server Base URL to connect to vCenter.
(e.g.: https://vmware.example.com)Note: If vCenter IP is given instead of vCenter server name, it throws certificate error if the vCenter IP entry is not present in the Subject Alternative Name field of the certificate, because the certificate mostly contains entry of vCenter server in FQDN (Fully Qualified Domain Name) format.
2
Port
Specify the vCenter server port. (Default port is 443).
This field should be an integer and value should be less than 65536.
3
Username
Specify a Username to authenticate vCenter server.
Password:
The password to authenticate vCenter server.
4
Accept value as variable/static
Leave checkbox unchecked to accept Password value from a field in the previous steps of the stream using a drop down list.
Else enable checkbox for Password field to appear as Text box.
5
Password
Password is entered using a widget. The widget handles both Text (static value or environment variable) and Combo (drop down containing values from previous steps). This field is mandatory.
If checkbox above is enabled Password field appears as Text box and accepts static or variable values. Else if checkbox above is disabled Password field appears as a drop down to select fields from previous steps. Please note that Field values can only be accessed when workflow is in running state.
6
Button: Test Connection
Verifies whether the connection is available or not.
For the purpose of verification fields coming from previous steps are not allowed since field values can only be accessed when workflow is in running state. Static values and environment variables are allowed.
Input Tab:
No.
Field Name
Description
Input Fields:
1
Virtual Machine Name/UUID
Specify the Name/UUID of the virtual machine to which the snapshot to be deleted is associated.
The data type is String. This field is mandatory.
Notes:
- Refer Get VM UUID in the VMWare Plugin introduction for steps to fetch the VM UUID.
- If two or more virtual machines with the same name appear in the vCenter Server inventory, then you may provide the UUID which is unique to each VM.
- If VM name contains ‘%’ special character then to execute the plugin step, provide VM name by replacing ‘%’ character with ‘%25’.
2
Button: Get
On click of this button, if the connection is successfully established it populates the list of Virtual Machine Names on the vCenter server.
3
Optional Input Fields:
i
Snapshot Created Date
Specify the Snapshot Created Date of a snapshot that is to be deleted in specified date format. Date Format: EEEE, MMMM dd, yyyy h:mm:ss a
Date Example: Tuesday, November 26, 2019, 12:01:36 PMThe data type is String. This field is optional.
Note:
Provide value in Snapshot Created Date or Snapshot Name but not both.
ii
Button: Get
On click of this button, if the connection is successfully established it populates the list of Snapshot Created Dates on the vCenter server.
iii
Snapshot Name
Specify the Snapshot Name to be deleted.
The data type is String. This field is optional.
Note:
Provide value in Snapshot Created Date or Snapshot Name but not both.
iv
Button: Get
On click of this button, if the connection is successfully established it populates the list of Snapshot Names on the vCenter server.
8
New Snapshot Name
Specify the new name for the specified Snapshot.
The Snapshot Name must be unique.
The data type is String. This field is mandatory.
9
Snapshot Description
Provide a short Description for Snapshot Rename.
The data type is String. This field is optional.
Note:
Allowed combinations of values for the input fields viz., ‘Snapshot Created Date’ and ‘Snapshot Name’:
No. | Snapshot Created Date | Snapshot Name |
1 | <Valid DateTime> | |
2 | <Valid SnapshotName> |
Common Buttons:
No.
Field Name
Description
Buttons:
1
OK
Click this button to check and save the field values. If any required field values are missing then it will display a validation error message else if all the required field values are provided then it will save the field values.
2
Cancel
Click this button, to cancel the window and does not save any values.
VMware: Revert To Snapshot plugin step reverts a Virtual Machine to a specified snapshot of a virtual machine or to the latest (current) snapshot.
No.
Field Name
Description
1
Step Name
Name of the step. This name has to be unique in a single workflow.
Configuration:
1
vCenter Server Base URL
Specify the vCenter Server Base URL to connect to vCenter.
(e.g.: https://vmware.example.com)Note:
- If vCenter IP is given instead of vCenter server name, it may throw certificate error, because the certificate mostly contains entry of vCenter server in FQDN (Fully Qualified Domain Name) format. In such a case vCenter IP entry must be present in the Subject Alternative Name field of the certificate.
- Two or more virtual machines with the same name appear in the vCenter Server inventory. In this scenario, at the run time, the correct virtual machine object may not be used among duplicate virtual machine names. To resolve this issue, rename the duplicate virtual machine to a unique name for each entity.
2
Port
Specify the vCenter server port. (Default port is 443).
This field should be an integer and value should be less than 65536.
3
Username
Specify a Username to authenticate vCenter server.
Password:
The password to authenticate vCenter server.
4
Accept value as variable/static
Leave checkbox unchecked to accept Password value from a field in the previous steps of the stream using a drop down list.
Else enable checkbox for Password field to appear as Text box.
5
Password
Password is entered using a widget. The widget handles both Text (static value or environment variable) and Combo (drop down containing values from previous steps). This field is mandatory.
If checkbox above is enabled Password field appears as Text box and accepts static or variable values. Else if checkbox above is disabled Password field appears as a drop down to select fields from previous steps. Please note that Field values can only be accessed when workflow is in running state.
6
Button: Test Connection
Verifies whether the connection is available or not.
For the purpose of verification fields coming from previous steps are not allowed since field values can only be accessed when workflow is in running state. Static values and environment variables are allowed.
Input Tab:
No.
Field Name
Description
Input Fields:
1
Virtual Machine Name/UUID
Specify the Name/UUID of the virtual machine to revert to a snapshot.
The data type is string. This field is mandatory.
Notes:
- Refer Get VM UUID in the VMWare Plugin introduction for steps to fetch the VM UUID.
- If two or more virtual machines with the same name appear in the vCenter Server inventory, then you may provide the UUID which is unique to each VM.
- If VM name contains ‘%’ special character then to execute the plugin step, provide VM name by replacing ‘%’ character with ‘%25’.
2
Button: Get
On click of this button, if the connection is successfully established it populates the list of Virtual Machine Names on the vCenter server.
Note: If VM name contains ‘%’ special character then on click of ‘Get’ button, the VM name is returned by replacing ‘%’ character with ‘%25’. You may leave it like that.
Optional Input Fields:
Provide any one of the following.
3
Snapshot Created Date
Snapshot Created Date of a snapshot to revert. Date Format: EEEE, MMMM dd, yyyy h:mm:ss a
Date Example: Tuesday, November 26, 2019, 12:01:36 PMThe data type is string. This field is optional.
4
Button: Get
On click of this button, if the connection is successfully established it populates the list of Snapshot Created Dates on the vCenter server.
5
Snapshot Name
Specify Snapshot Name to revert VM to.
‘Snapshot Name’ must be unique.
The data type is string. This field is optional.
6
Button: Get
On click of this button, if the connection is successfully established it populates the list of Snapshot Names on the vCenter server.
7
Revert VM To Latest (Current) Snapshot
Allowed Value: ‘Yes’.
If given “Yes” then a virtual machine will be reverted to the latest (current) snapshot state.
If the field is blank, then ‘No’ is considered.
The data type is string. This field is optional.
Note: Allowed combinations of values for the input fields viz., ‘Revert VM To Snapshot Created Date’, ‘Revert VM To Snapshot Name’ and ‘Revert VM To Latest (Current) Snapshot as depicted below.
As seen below only one of the following values can be provided.
No. | Revert VM To Snapshot Created Date | Revert VM To Snapshot Name | Revert VM To Latest (Current) Snapshot |
1 | <Valid DateTime> | ||
2 | <Valid Name> | ||
3 | <Yes> |
Common Buttons:
No.
Field Name
Description
Buttons:
1
OK
Click this button to check and save the field values. If any required field values are missing then it will display a validation error message else if all the required field values are provided then it will save the field values.
2
Cancel
Click this button, to cancel the window and does not save any values.
VMware: Shutdown VM plugin step shuts down a virtual machine.
No.
Field Name
Description
1
Step Name
Name of the step. This name has to be unique in a single workflow.
Configuration:
1
vCenter Server Base URL
Specify the vCenter Server Base URL to connect to vCenter.
(e.g.: https://vmware.example.com)Note: If vCenter IP is given instead of vCenter server name, it throws certificate error, because the certificate contains entry of vCenter server in FQDN (Fully Qualified Domain Name) format.
2
Port
Specify the vCenter server port. (Default port is 443).
This field should be an integer and value should be less than 65536.
3
Username
Specify a Username to authenticate vCenter server.
Password:
The password to authenticate vCenter server.
4
Accept value as variable/static
Leave checkbox unchecked to accept Password value from a field in the previous steps of the stream using a drop down list.
Else enable checkbox for Password field to appear as Text box.
5
Password
Password is entered using a widget. The widget handles both Text (static value or environment variable) and Combo (drop down containing values from previous steps). This field is mandatory.
If checkbox above is enabled Password field appears as Text box and accepts static or variable values. Else if checkbox above is disabled Password field appears as a drop down to select fields from previous steps. Please note that Field values can only be accessed when workflow is in running state.
6
Button: Test Connection
Verifies whether the connection is available or not.
For the purpose of verification fields coming from previous steps are not allowed since field values can only be accessed when workflow is in running state. Static values and environment variables are allowed.
Input Tab:
No.
Field Name
Description
Input Fields:
1
Virtual Machine Name/UUID
Specify the Name/UUID of the virtual machine to shutdown.
This field data type is String. This field is mandatory.
Notes:
- Refer Get VM UUID in the VMWare Plugin introduction for steps to fetch the VM UUID.
- If two or more virtual machines with the same name appear in the vCenter Server inventory, then you may provide the UUID which is unique to each VM.
- If VM name contains ‘%’ special character then to execute the plugin step, provide VM name by replacing ‘%’ character with ‘%25’.
2
Button: Get
On click of this button, if the connection is successfully established it populates the list of Virtual Machine Names on the vCenter server.
Note: If VM name contains ‘%’ special character then on click of ‘Get’ button, the VM name is returned by replacing ‘%’ character with ‘%25’. You may leave it like that.
Common Buttons:
No.
Field Name
Description
Buttons:
1
OK
Click this button to check and save the field values. If any required field values are missing then it will display a validation error message else if all the required field values are provided then it will save the field values.
2
Cancel
Click this button, to cancel the window and does not save any values.
VMware: Suspend VM plugin step suspends a virtual machine.
No.
Field Name
Description
1
Step Name
Name of the step. This name has to be unique in a single workflow.
Configuration:
1
vCenter Server Base URL
Specify the vCenter Server Base URL to connect to vCenter.
(e.g.: https://vmware.example.com)Note: If vCenter IP is given instead of vCenter server name, it throws certificate error, because the certificate contains entry of vCenter server in FQDN (Fully Qualified Domain Name) format.
2
Port
Specify the vCenter server port. (Default port is 443).
This field should be an integer and value should be less than 65536.
3
Username
Specify a Username to authenticate vCenter server.
Password:
The password to authenticate vCenter server.
4
Accept value as variable/static
Leave checkbox unchecked to accept Password value from a field in the previous steps of the stream using a drop down list.
Else enable checkbox for Password field to appear as Text box.
5
Password
Password is entered using a widget. The widget handles both Text (static value or environment variable) and Combo (drop down containing values from previous steps). This field is mandatory.
If checkbox above is enabled Password field appears as Text box and accepts static or variable values. Else if checkbox above is disabled Password field appears as a drop down to select fields from previous steps. Please note that Field values can only be accessed when workflow is in running state.
6
Button: Test Connection
Verifies whether the connection is available or not.
For the purpose of verification fields coming from previous steps are not allowed since field values can only be accessed when workflow is in running state. Static values and environment variables are allowed.
Input Tab:
No.
Field Name
Description
Input Fields:
1
Virtual Machine Name/UUID
Specify the Name/UUID of the virtual machine to suspend.
This field data type is String. This field is mandatory.
Notes:
- Refer Get VM UUID in the VMWare Plugin introduction for steps to fetch the VM UUID.
- If two or more virtual machines with the same name appear in the vCenter Server inventory, then you may provide the UUID which is unique to each VM.
- If VM name contains ‘%’ special character then to execute the plugin step, provide VM name by replacing ‘%’ character with ‘%25’.
2
Button: Get
On click of this button, if the connection is successfully established it populates the list of Virtual Machine Names on the vCenter server.
Note: If VM name contains ‘%’ special character then on click of ‘Get’ button, the VM name is returned by replacing ‘%’ character with ‘%25’. You may leave it like that.
Common Buttons:
No.
Field Name
Description
Buttons:
1
OK
Click this button to check and save the field values. If any required field values are missing then it will display a validation error message else if all the required field values are provided then it will save the field values.
2
Cancel
Click this button, to cancel the window and does not save any values.
VMware: Take VM Snapshot plugin step takes a snapshot of a virtual machine’s state.
No.
Field Name
Description
1
Step Name
Name of the step. This name has to be unique in a single workflow.
Configuration:
1
vCenter Server Base URL
Specify the vCenter Server Base URL to connect to vCenter.
(e.g.: https://vmware.example.com)Note: If vCenter IP is given instead of vCenter server name, it throws certificate error if the vCenter IP entry is not present in the Subject Alternative Name field of the certificate, because the certificate mostly contains entry of vCenter server in FQDN (Fully Qualified Domain Name) format.
2
Port
Specify the vCenter server port. (Default port is 443).
This field should be an integer and value should be less than 65536.
3
Username
Specify a Username to authenticate vCenter server.
Password:
The password to authenticate vCenter server.
4
Accept value as variable/static
Leave checkbox unchecked to accept Password value from a field in the previous steps of the stream using a drop down list.
Else enable checkbox for Password field to appear as Text box.
5
Password
Specify the password. Password is entered using a widget. The widget handles both Text (static value or environment variable) and Combo (drop down containing values from previous steps). This field is mandatory.
If checkbox above is enabled Password field appears as Text box and accepts static or variable values. Else if checkbox above is disabled Password field appears as a drop down to select fields from previous steps. Please note that Field values can only be accessed when workflow is in running state.
6
Button: Test Connection
Verifies whether the connection is available or not.
For the purpose of verification fields coming from previous steps are not allowed since field values can only be accessed when workflow is in running state. Static values and environment variables are allowed.
Input Tab:
No.
Field Name
Description
Input Fields:
1
Virtual Machine Name/UUID
Specify the Name/UUID of the virtual machine to take a snapshot.
The data type is string. This field is mandatory.
Notes:
- Refer Get VM UUIDError! Reference source not found. in the VMWare Plugin introduction for steps to fetch the VM UUID.
- If two or more virtual machines with the same name appear in the vCenter Server inventory, then you may provide the UUID which is unique to each VM.
- If VM name contains ‘%’ special character then to execute the plugin step, provide VM name by replacing ‘%’ character with ‘%25’
2
Button: Get
On click of this button, if the connection is successfully established it populates the list of Virtual Machine Names on the vCenter server.
3
New Snapshot Name
Specify the name of the New snapshot to be created.
If no value is provided, a New snapshot is generated with the current date-time.
Example: VM Snapshot 25/11/2019 03:35:09 PM4
Snapshot Description
Provide a description for the snapshot.
5
Snapshot The Virtual Machine’s Memory
6
Quiesce Guest File System
Allowed values: ‘Yes’ or ‘No’.
If the specified value is “Yes” then writing to the memory of Virtual Machine is stopped while creating the Snapshot.
Also, refer Note above.
Common Buttons:
No.
Field Name
Description
Buttons:
1
OK
Click this button to check and save the field values. If any required field values are missing then it will display a validation error message else if all the required field values are provided then it will save the field values.
2
Cancel
Click this button, to cancel the window and does not save any values.