HyperV Host Tasks

This chapter contains the following sections:

Bring Hyper-V Disk Online and Formatting

Summary

Bring raw disks online attached to a host by formatting and creating partitions.

Description

This task assigns the CD/DVD drive to the Z: drive and performs the following actions to the attached LUN's raw disks (from an external iSCSI-based storage), based on zero partition disk types:

1. Creates the primary partition.
2. Formats the drive to NTFS.
3. Assigns the drive to the next available drive letter.

Inputs

Input	Description	Mappable To Type	Mandatory
Select Host	Select host to unregister	hyperv​Multi​Host	Y
User Name	Enter User Name for the selected host.​	gen_​text_​input	Y
Password	Enter Password for the selected host.​	password	Y

Outputs

Output	Description	Type
OUTPUT_​HOST_​IDENTITY	Host Identity	hyperv​Host
OUTPUT_​HOST_​USER_​NAME	Username	gen_​text_​input
OUTPUT_​HOST_​VOLUME	Host volume	gen_​text_​input

Create Hyper-V VM Placement Path

Summary

Add a VM placement path on a host.

Description

This task creates a VM placement path on a HyperV host. The input is a HyperV host disk ID. This ID includes an account name, host name, and drive name.

Inputs

Input	Description	Mappable To Type	Mandatory
Select Host Drive	Select drive to add as VM placement	gen_​text_​input	Y
Path Name	Specify Path Name	gen_​text_​input

Outputs

Output	Description	Type
OUTPUT_​VM_​STORE_​PATH	VM store path	gen_​text_​input

Get UCS Service Profile vNICs associated to Hyper-v Hosts

Summary

Description

Inputs

Input	Description	Mappable To Type	Mandatory
Host Selection Scope	Choose the UCSM service profile template to disassociate	gen_​text_​input	Y
Hyper-v Cluster	Choose Hyper-v Cluster	hyperv​Cluster​Identity	Y
Hyper-V Hosts	Choose one or more Hyper-V Hosts	hyperv​Multi​Host	Y

Outputs

Output	Description	Type
UCS_​MULTI_​SERVICE_​PROFILE_​IDENTITY	UCS Multi Service Profile Identity	ucs​Multi​Service​Profile​Identity
SERVICE_​PROFILE_​MULTI_​VNIC_​IDENTITY	UCS Service Profile Multi v​NIC Identity	ucs​Service​Profile​Multiv​NICIdentity
UCS_​ACCOUNT_​IDENTITY	UCS Account Identity	ucs​Account​Identity

Manage Hyper-V Host Power Actions

Summary

Perform Hyperv power actions.

Description

This task performs power actions on a host.

Inputs

Input	Description	Mappable To Type	Mandatory
Select Host	Select the host to perform the action	hyperv​Host	Y
Select Power Action	Select the power action to be executed	gen_​text_​input	Y
Select Maintenance Mode Action	Select the action to perform when starting maintenance mode	gen_​text_​input

Outputs

Output	Description	Type
OUTPUT_​HOST_​IDENTITY	Host Identity	hyperv​Host

Mount Hyper-V iSCSI LUN

Summary

Add an external iSCSI-based storage IP to a software Microsoft iSCSI initiator.

Description

This task starts the Microsoft iSCSI service on a host and adds a persistent IP connection to an external iSCSI-based storage target device, then rescans the disks.

Inputs

Input	Description	Mappable To Type	Mandatory
v​Filer Name	Select v​Filer Name	net​App​All​VFilers​Identity	Y
i​SCSI Enable IP Address	Select a IP Address.​	gen_​text_​input	Y
Select Host	Select host to unregister	vmware​Host​Multi​Select	Y
User Name	Enter User Name for the selected host.​	gen_​text_​input	Y
Password	Enter Password for the selecte host.​	password	Y

Outputs

Output	Description	Type
OUTPUT_​HOST_​IDENTITY	Host Identity	hyperv​Host
OUTPUT_​HOST_​USER_​NAME	Username	gen_​text_​input

Move Hyper-V Host to Host Group

Summary

Move a host to a host group.

Description

This task moves a host to a host group. This task is supported for the following versions of SCVMM:

• SCVMM 2012 R2

Inputs

Input	Description	Mappable To Type	Mandatory
Select Host	Select the host to perform the action	hyperv​Host	Y
Select Host Group	Select the host group	hyperv​Host​Group​Identity	Y

Outputs

Output	Description	Type
OUTPUT_​HOST_​IDENTITY	Host Identity	hyperv​Host
OUTPUT_​HOST_​GROUP_​IDENTITY	Host Group Identity	hyperv​Host​Group​Identity

Refresh Hyper-V Host/Cluster

Summary

Refresh a host or cluster.

Description

This task refreshes a host or cluster. Inventory of the selected Host or Cluster is also performed. This task is supported for the following versions of SCVMM:

• SCVMM 2012 R2

Inputs

Input	Description	Mappable To Type	Mandatory
Host/Cluster	Host/Cluster	gen_​text_​input	Y
Select Host	Select the host to perform the action	hyperv​Host	Y
Select Cluster	Select the cluster to perform the action	hyperv​Cluster​Identity	Y

Outputs

Output	Description	Type
OUTPUT_​CLUSTER_​IDENTITY	Cluster Identity	hyperv​Cluster​Identity
OUTPUT_​HOST_​IDENTITY	Host Identity	hyperv​Host

Register Host with Hyper-V SCVMM

Summary

Register a host with SCVMM.

Description

This task registers a host with SCVMM.

Inputs

Input	Description	Mappable To Type	Mandatory
Select Host Group	Select host group	hyperv​Host​Group​Identity	Y
Register PXE Host	Select this option to register PXE Host to the cloud
PXEBoot Request ID	The PXEBoot Request ID of the Host that is to be registered with the cloud.​	gen_​text_​input	Y
Host Name	Enter Host​Name.​	gen_​text_​input	Y
User Name	Enter User Name.​	gen_​text_​input	Y
Password	Enter Password.​	gen_​text_​input	Y

Outputs

Output	Description	Type
OUTPUT_​HOST_​IDENTITY	Host Identity	hyperv​Host

Remove Hyper-V VM Placement Path

Summary

Remove a VM placement path.

Description

This task removes a VM placement path on a host.

Inputs

Input	Description	Mappable To Type	Mandatory
Select Host	Select host	hyperv​Host	Y
Select Placement Path	Select Placement Path	gen_​text_​input	Y

Outputs

No Outputs

Run Hyper-V Script Command

Summary

Run a script command on a Hyper-V host.

Description

This task runs script commands remotely on a Hyper-V host. This task is supported for the following versions of SCVMM:

• SCVMM 2012 R2

Inputs

Input	Description	Mappable To Type	Mandatory
Select Host	Select the host to perform the action	hyperv​Host	Y
Executable Program	Specify the Executable Program	gen_​text_​input	Y
Parameters	Specify the parameters	gen_​text_​input
Select Script Resource Package	Select the Script Resource Package to perform the operation	hyperv​Custom​Resource​Identity
Select Run As Account	Select the Run As Account to perform the operation	hyperv​Run​As​Account​Identity
Timeout(Seconds)	Specify the timeout in seconds		Y

Outputs

Output	Description	Type
OUTPUT_​HOST_​IDENTITY	Host Identity	hyperv​Host
OUTPUT_​CUSTOM_​RESOURCE_​IDENTITY	Custom Resource Identity	gen_​text_​input

Unregister Host from Hyper-V SCVMM

Summary

Unregister a host from SCVMM.

Description

This task unregisters a host from SCVMM.

Inputs

Input	Description	Mappable To Type	Mandatory
Select Host	Select host to unregister	hyperv​Host	Y
User Name	Enter User Name.​	gen_​text_​input	Y
Password	Enter Password.​	gen_​text_​input	Y

Outputs

No Outputs

Validate Hyper-V Cluster

Summary

Validate a cluster.

Description

This task validates a cluster. This task is supported for the following versions of SCVMM:

• SCVMM 2012 R2

Inputs

Input	Description	Mappable To Type	Mandatory
Select Cluster	Select the cluster to perform the action	hyperv​Cluster​Identity	Y

Outputs

Output	Description	Type
OUTPUT_​CLUSTER_​IDENTITY	Cluster Identity	hyperv​Cluster​Identity