5.4.12 Mount a virtual disk
Function
This component mounts a virtual disk on a Hyper-V server.
The following servers are required for this component:
- Hyper-V server (Execution target server)
This is the Windows 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 mount a virtual disk on the Hyper-V server.
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.
Cautions
(1) When a virtual disk of the virtual server is mounted on the Hyper-V server, an available drive letter on the Hyper-V server is temporarily assigned. If no drive letter is available on the Hyper-V server, this component terminates with an error. Before executing this component, make sure that drive letters are available on the Hyper-V server for the number of drives used by the virtual disk that is to be mounted.
Version
02.00.00
Plug-in tags
Modify VM,Hyper-V 2008
Plug-in name displayed in the task log
hypervMountVhd
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.vhdPath |
Virtual disk file path (for first NIC) |
Specifies the path of the virtual disk file (first NIC) as a full path. |
-- |
Input |
R |
hyperv.vhdPath2 |
Virtual disk file path (for second NIC) |
Specifies the path of the virtual disk file (second NIC) as a full path. |
-- |
Input |
O |
hyperv.vhdPath3 |
Virtual disk file path (for third NIC) |
Specifies the path of the virtual disk file (third NIC) as a full path. |
-- |
Input |
O |
hyperv.vhdPath4 |
Virtual disk file path (for fourth NIC) |
Specifies the path of the virtual disk file (fourth NIC) as a full path. |
-- |
Input |
O |
hyperv.checkJobStateCountGetDriveList |
Job monitoring count (Win32_LogicalDisk method) |
This property adjusts the job monitoring count for monitoring requests to Hyper-V for processing (Win32_LogicalDisk method). You do not need to change the value of this property. |
1440 |
Input |
R |
hyperv.checkJobStateIntervalGetDriveList |
Job monitoring interval (Win32_LogicalDisk method) |
This property adjusts the job monitoring interval for monitoring requests to Hyper-V for processing (Win32_LogicalDisk method). You do not need to change the value of this property. |
5 |
Input |
R |
hyperv.returnDriveLetter |
Drive letter |
Stores the drive letter assigned to the virtual disk that was mounted by this component. |
-- |
Output |
O |
common.returnValue |
Return value for the plugin |
The return value of this plugin stored. |
-- |
Output |
O |
hyperv.returnVhdPath |
Virtual disk file path |
Stores the path of the virtual disk file as a full path. |
-- |
Output |
O |