Add-hyperv, Preconditions, Syntax – HP 3PAR Application Software Suite for Microsoft Hyper-V User Manual
Page 73: Success paths, Failure paths
B HP 3PAR Recovery Manager for Microsoft Hyper-V
Powershell Commands
This section provides additional information about custom Powershell Commandlets for users
performing administrative tasks.
Add-HyperV
Add-HyperV
adds Hyper-V credentials for users. The command is used with each Microsoft
Hyper-V (cluster or standalone host) credentials and managed by the application.
Preconditions
•
User must first log on with Login-Rmh.
•
Hyper-V name (or synonym) does not already exist.
Syntax
Any optional parameters require square brackets [ ] around them.
Add-HyperV -RmhServerName
-HypervUsername
Table 37 Add-HyperV parameters
Description
Optional/Required
Parameter
Host name of the RMH Server. This is
FQDN or IP address.
Required
-RmhServerName
Hyper-V host or cluster name. This is
FQDN or IP address. Synonyms are
checked. The localhost is not supported.
Required
-HypervName
Hyper-V username. If cluster, ensure all
controller nodes in the cluster have the
Required
-HypervUsername
same username. If not specified, a
dialog box will be presented to enter
credentials.
Hyper-V password. If cluster, ensure all
controller nodes in the cluster have the
Required
-HypervPassword
same password. If not specified, a
dialog box will be presented to enter
credentials.
Displays progress messages.
Optional
-Verbose
Success Paths
•
Scenario 1: Add Hyper-V is successful.
Add Hyper-V successful for specified Hyper-V host.
Failure Paths
•
Scenario 1: Session owner is invalid.
Every session command received on RMH Server is validated to originate from the same IP
address that initiated the session. If IP does not match, the command fails.
•
Scenario 2: Cannot communicate with host.
RMH Server cannot communicate with a specified Hyper-V host.
Add-HyperV
73