Cisco UCS Director Task Library Reference, Release 6.7

Bias-Free Language

The documentation set for this product strives to use bias-free language. For the purposes of this documentation set, bias-free is defined as language that does not imply discrimination based on age, disability, gender, racial identity, ethnic identity, sexual orientation, socioeconomic status, and intersectionality. Exceptions may be present in the documentation due to language that is hardcoded in the user interfaces of the product software, language used based on RFP documentation, or language that is used by a referenced third-party product. Learn more about how Cisco is using Inclusive Language.

Book Contents
Find Matches in This Book
Available Languages
Download Options

Book Title

Cisco UCS Director Task Library Reference, Release 6.7

Chapter Title

HyperV Host Tasks

Results

Updated:
January 14, 2019

Chapter: HyperV Host Tasks

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

Was this Document Helpful?

FeedbackFeedback

Contact Cisco