Administration Guide › Using Rules and Actions › Rules and Actions › Use a Predefined Action Type › List of Predefined Action Types › Provision Machine: Microsoft Hyper-V

Provision Machine: Microsoft Hyper-V

The Provision Hyper-V VM action type creates and installs a VM. Specify the following parameters.

The Details section of the action definition contains the following fields on the first page:

SCVMM Server

Specifies the Microsoft System Center Virtual Machine Manager (SCVMM) library server. Select one from the drop-down list.

Hyper-V Server

Specifies the Hyper-V Server. Select one from the drop-down list.

Template

Specifies the template. Select one from the drop-down list.

Destination Path

Specifies the destination path of the VM that you want to create (template is stored). Select one from the drop-down list.

VM Name

Specifies the name of the VM.

Start VM

Starts the VM automatically after it is created. By default, the new VM is in powered-off state.

Require Approval

Select to specify that the ticket requires approval by a third party.

Note: CA SDM must be configured to use this option.

Auto close ticket on approval/rejection

Select to close the ticket after it is approved or rejected.

Note: CA SDM must be configured to use this option.

Ticket Types

Select a valid ticket type from the drop-down list. Depending on your configuration, valid types include:

• Default
• Incident
• Problem
• Request

Note: CA SDM must be configured to use this option.

Templates

Specifies the template to use to create a ticket. Select a template from the drop-down list. Depending on the ticket type selected, the form is populated with corresponding values.

Note: CA SDM must be configured to use this option.

The Details section contains the following fields on the second page after you click Next:

Hardware Profile

Specifies the name of the hardware profile defined by the Microsoft System Center Virtual Machine Manager (SCVMM) library server.

Virtual Processors

Specifies the number of virtual processors that you want to assign to the VM.

Default: 1

Memory

Specifies the RAM memory in megabytes (MB) for the VM that you want to create.

Default: 1024

The Details section contains the following fields on the third page after you click Next:

Guest OS Profile

(Optional) Specifies the name of the guest operating system profile defined by the Microsoft System Center Virtual Machine Manager (SCVMM) library server. This parameter overwrites the operating system configuration settings stored in the SCVMM library server. This parameter is valid when you use SCVMM integration to provision VMs.

Product Key

(Optional) Specifies the Windows product activation key for the VM. Support for this parameter requires a Windows image created using Sysprep tool. This option is invalid for asynchronous execution of command.

Full Name

Specifies the user name of the Windows image (created using sysprep tool) which is installed on the new VM.

Organization

(Optional) Specifies the organization name of the Windows image (created using sysprep tool) which is installed on the new VM. Support for this parameter requires a Windows image created using Sysprep tool. This option is invalid for asynchronous execution of command.

Admin Password

(Optional) This option is used to set the default administrator account password for the VM. Support for this parameter requires a Windows image created using Sysprep tool. This parameter is ignored in asynchronous execution.

Note: To set this option successfully, set the Windows Server administrator password which is created using Sysprep tool as empty.

Join Workgroup

Specifies the workgroup that you want to create for the VM. Domain and workgroup specifications are mutually exclusive.

Join Domain

Specifies the domain name for the VM. Domain and workgroup specifications are mutually exclusive.

Domain User

Specifies the domain user name that you want to create as a part of the default Administrators group.

Domain User Password

Specifies the password of the domain user account that you want to create as a part of the default Administrators group.

The Details section contains the following fields on the fourth page after you click Next:

Use DHCP

Specifies an option to enable DHCP for a network interface of the VM. If the template image has more than one network adapter, DHCP is turned on for the first interface. If enabled, the other network parameters are not accessible.

IP Address

Specifies the static IPv4 address that you want to assign to the VM.

Network Mask

Specifies the subnet mask that you want to assign for the VM.

Default Gateway

Specifies the default gateway for VM.

DNS Server

Specifies the DNS server that you want to set for the VM.

IP Metric

(Optional) Specifies the interface metric that you want to set for the VM. This option is used with -ip4ddr option. If an interface name is specified in the -ip4addr option, same interface name must be used in this option. Support for this parameter requires a Windows image created using Sysprep tool. This option is invalid for asynchronous execution of command.

Default: 1