This activity saves the state of a virtual machine, and then stops the virtual machine.
Icon
Design Time Prerequisites
Run Time Prerequisites
- The Virtual Machine Manager console and
Service Manager must be both installed on the same server.
- Ensure that the Service Manager Workflow
account has sufficient permissions to modify security groups in
Active Directory Domain Services.
Properties
The Save State VM activity uses the following input properties:
| Display Name | Internal Name | Type | Required | Description |
|---|---|---|---|---|
|
Continue On Error |
ContinueOnError |
Boolean |
No (default setting is True) |
Determines whether the workflow should continue running if the activity fails. |
|
Has Error |
HasError |
N/A |
Specifies if the activity has an error set. (Read-only) |
|
|
Job Variable |
JobVariable |
String |
No |
Specifies that job progress is tracked and stored in the variable named by this parameter. |
|
Management Group |
ManagementGroup |
String |
No |
Specifies the management group in which this activity will run. Set to localhost. (Read-only) |
|
PROTipID |
PROTipID |
Guid |
No |
Specifies the ID of the Performance and Resource Optimization (PRO) tip that triggered this action. Allows for future auditing of PRO tips. |
|
Run Asynchronously |
RunAsynchronously |
Boolean |
No (default setting is False) |
Specifies that the job runs asynchronously so that control returns to the command shell immediately. |
|
Script Server |
Target |
String |
Yes |
Specifies the Domain Name System (DNS) name of the server that runs the Service Manager console. Do not use localhost. |
|
Script Time Limit |
TimeoutSeconds |
Integer |
No (default setting is 300 seconds) |
Specifies the maximum number of seconds to allow for the activity to run. |
|
VM ID |
VMID |
String |
Yes |
Specifies the unique ID of the virtual machine to be saved. |
|
VMM Server |
VMMServer |
String |
Yes |
Specifies the name of the System Center Virtual Machine Manager (VMM) server that manages the virtual machines. |
The Save State VM activity generates the output described in the following table:
| Display Name | Internal Name | Type | Comments |
|---|---|---|---|
|
VM ID |
VMID |
String |
Specifies the unique ID of the virtual machine that was saved. The input VM ID and the output VM ID are equal unless the activity failed to find a virtual machine with a VM ID that matches the input VM ID. In that case, the output VM ID is set to Null. |
Errors and Exceptions
The Save State VM activity uses the custom tracking service supplied by Service Manager to log errors and exceptions when the activity runs. The activity generates errors or exceptions as appropriate if any of the script properties cannot be resolved.
Remarks
Example