Prerequisites
• The name of each virtual server must be unique within a single Hyper-V server.
• The OS Shutdown service of the Hyper-V Integration Service on the target virtual server must be
enabled.
• If the network connection check is enabled, you must specify the address of the connection destination
for agentless monitoring. Make sure to specify a loopback address that can be resolved from the name
"localhost".
• If the network connection check is enabled, the firewall for the target virtual server must permit ICMP
(ECHO) replies.
• The virtual server must be running.
Usage guidelines
• This service forcibly shuts down the OS of the specified virtual server. When this service is run, data in
files that are being edited on the virtual server are not saved.
• If the network connectivity check is enabled, depending on the system environment, the task might not
be able to obtain all IP addresses immediately after the virtual servers are started. As a result, even if
the virtual server is running, the plug-in osSendIcmp might not be able to confirm network connection
for all IP addresses (IPv4) set on the virtual servers. To ensure that all IP addresses can be obtained,
adjust the value (in seconds) of the property hyperv.waitTime, which specifies the amount of time to
wait between starting a virtual server to obtaining an IP address.
• If the network connectivity check is enabled, make sure that the total length of the IP addresses (IPv4)
set for all NICs on a virtual server does not exceed 1,024 characters (The maximum length of one IP
address (IPv4) including the comma used as an address separator is 16 characters.). If the total length
exceeds 1,024 characters, an error might occur in the plug-in osSendIcmp, causing the task to end
abnormally.
• If the network connection check is enabled, adjust the value of the property
common.icmpEchoTimeout based on your environment.
Service Definition Properties
The following table lists the properties shown in the
Service Definition
window.
Property key
Property name
Description
Required or optional
hyperv.targetHost
Hyper-V server host
name
Specifies the host name
or IP address of the
Hyper-V server. IPv6
addresses are not
supported.
R
hyperv.waitTime
Wait time before starting
to obtain IP address
When performing a
network connectivity
check, specifies the
amount of time, in
seconds, after the virtual
server starts to wait
before starting to obtain
the IP address.
R
Table Continued
Additional service templates
355