Add-hyperv, Preconditions, Syntax – HP 3PAR Recovery Manager Software User Manual

Page 62: Success paths, Failure paths

Advertising
background image

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 <RmhServerName> -HypervName <HypervName>
-HypervUsername <HypervUser> -HypervPassword <HypervPassword> [-Verbose]

Table 35 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.

62

HP 3PAR Recovery Manager for Microsoft Hyper-V Powershell Commands

Advertising