5.4.10 Add a disk to the virtual server
Function
This component adds a disk to the virtual server in the Hyper-V environment.
Although a virtual disk (adjustable size or fixed size) can be added to the virtual server, a virtual disk (differential) and pass-through (physical) disk cannot be added.
A virtual disk file is newly created.
The virtual disk can be added to the SCSI controller, but it cannot be added to the IDE controller.
The following servers are required for this component:
- Hyper-V server (Execution target server)
This is the server where Hyper-V is installed.
- Virtual server
This is a virtual server managed by Hyper-V.
Use situation
This component can be used to add a data disk to a virtual server: for example, when building a new virtual server or expanding a disk.
Prerequisites
For the latest support information about [Required product in the System]/[Required products on the execution target server]/[Prerequisite product OS running in the execution target server], see the release notes.
[Required product in the System]
JP1/Automatic Operation 11-00 or later
[Required products on the execution target server]
(1)Prerequisite product of Hyper-V Server
- Windows Server 2008 R2 Hyper-V
(2)Prerequisite OS running in the virtual servers
- Windows Server 2008 R2 Standard/Enterprise/Datacenter
This does not apply to Server Core installation environments.
[Prerequisite product OS running in the execution target server]
- Windows Server 2008 R2 Standard/Enterprise/Datacenter
This does not apply to Server Core installation environments.
[Usage conditions for required products on the execution target server]
(1) The virtual server name must be unique within the Hyper-V server.
(2) The virtual server must be in a completely stopped state.
(3) A SCSI controller must be in the virtual server.
Cautions
(1) The virtual disk added to the virtual server is not initialized. If necessary, log into the OS of the virtual server and perform initialization of the disk.
(2) Virtual disk files that were already created in the Hyper-V server cannot be added.
Version
02.00.00
Plug-in tags
Modify VM,Hyper-V 2008
Plug-in name displayed in the task log
hypervAddVDisk
Return code
0: Normal
12: Error (Mistake by user) A property is invalid.
23: Error (Invalid environment) The environment requirements are not met.
27: Error (Check the task log for error details.)
41: Error (An error was detected in the component.) A property was not entered. (An error was detected in the component script.)
Property list
The following table lists the properties:
Property key |
Property name |
Description |
Default value |
I/O type |
Required |
---|---|---|---|---|---|
plugin.destinationHost |
Host name of the execution target server |
Specify the host name or IP address of the server on which this plugin will be executed. IPv6 addresses are not supported. |
-- |
Input |
R |
hyperv.vmName |
Virtual server name |
Specifies the name of the virtual server. (This is the name of the virtual server as it is displayed in Hyper-V. This is not the host name in the OS.) |
-- |
Input |
R |
hyperv.vHardDiskType |
Virtual disk type |
Specifies the virtual disk type. Specify one of the following: dynamic (an adjustable-size virtual disk is created) or fixed (a fixed-size virtual disk is created). |
-- |
Input |
R |
hyperv.scsiControllerNumber |
SCSI controller number |
Specifies the SCSI controller number of the virtual server that adds the virtual disk. Specify the SCSI controller number as an integer from 0 in the order that the SCSI controllers were added to the virtual server (displayed in the Hyper-V Manager). |
-- |
Input |
R |
hyperv.scsiLocationNumber |
SCSI controller location number |
Specifies the location number of the SCSI controller of the virtual server that adds the virtual disk. Specify the SCSI controller location number as an integer for the unused locations of SCSI controllers that were added to the virtual server. |
-- |
Input |
R |
hyperv.vhdPath |
Virtual disk file path |
Specifies, as a full path, the path of the virtual disk file to be created. Specify vhd as the extension of the virtual disk file. Virtual disk files that have already been created cannot be specified. |
-- |
Input |
R |
hyperv.vHardDiskCapacity |
Virtual disk size |
Specifies the size of the virtual disk to be created, in gigabytes (GB). |
-- |
Input |
R |
hyperv.checkJobNewVhdCount |
Monitor count (CreateDynamic/FixedVirtualHardDisk) |
This property adjusts the job monitoring count for monitoring requests to Hyper-V for processing (CreateDynamicVirtualHardDisk/CreateFixedVirtualHardDisk method). You do not need to change the value of this property. |
57600 |
Input |
R |
hyperv.checkJobNewVhdInterval |
Monitor interval (CreateDynamic/FixedVirtualHardDisk) |
This property adjusts the job monitoring interval for monitoring requests to Hyper-V for processing (CreateDynamicVirtualHardDisk/CreateFixedVirtualHardDisk method). You do not need to change the value of this property. |
3 |
Input |
R |
hyperv.checkJobAssignSCSICount |
Monitor count (AddVirtualSystemResources method, Add hard drive) |
This property adjusts the job monitoring count for monitoring requests to Hyper-V for processing (AddVirtualSystemResources method, Add hard drive). You do not need to change the value of this property. |
1200 |
Input |
R |
hyperv.checkJobAssignSCSIInterval |
Monitor interval (AddVirtualSystemResources, Add hard drive) |
This property adjusts the job monitoring interval for monitoring requests to Hyper-V for processing (AddVirtualSystemResources method, Add hard drive). You do not need to change the value of this property. |
3 |
Input |
R |
hyperv.checkJobJoinCount |
Monitor count (AddVirtualSystemResources, Connect to disk) |
This property adjusts the job monitoring count for monitoring requests to Hyper-V for processing (AddVirtualSystemResources method, Connect to disk). You do not need to change the value of this property. |
1200 |
Input |
R |
hyperv.checkJobJoinInterval |
Monitor interval (AddVirtualSystemResources, Connect to disk) |
This property adjusts the job monitoring interval for monitoring requests to Hyper-V for processing (AddVirtualSystemResources method, Connect to disk). You do not need to change the value of this property. |
3 |
Input |
R |
common.returnValue |
Return value for the plugin |
The return value of this plugin stored. |
-- |
Output |
O |