PowerCLI Reference

Get-HAPrimaryVMHost

Synopsis

On vCenter Server 5.0 and later, this cmdlet retrieves the master host of the specified HA cluster. On vCenter Server versions earlier than 5.0, this cmdlet retrieves the primary HA (High-Availability) hosts for the specified clusters.

Syntax

Get-HAPrimaryVMHost [[-Cluster] <Cluster[]>] [-Server <VIServer[]>] [<CommonParameters>]

Related Commands

Online Version

Detailed Description

On vCenter Server 5.0 and later, the cmdlet retrieves the master host of the specified HA cluster. On vCenter Server versions earlier than 5.0, the cmdlet retrieves the primary HA (High-Availability) hosts for the specified clusters.

Parameters

NameTypeDescriptionRequired?Pipeline InputDefault Value
ClusterCluster[]Specifies the clusters for which you want to retrieve the HA primary hosts.falseTrue (ByValue)
ServerVIServer[]Specifies the vCenter Server systems on which you want to run the cmdlet. If no value is passed to this parameter, the command runs on the default servers. For more information about default servers, see the description of Connect-VIServer.falseFalse

Return Type

Zero or more VMHost objects

Notes

Examples

-------------------------- Example 1 --------------------------

Get-Cluster | Get-HAPrimaryVMHost

Retrieves the HA primary hosts of the available cluster.

-------------------------- Example 2 --------------------------

Get-HAPrimaryVMHost Cluster

Retrieves the HA primary host of the cluster named Cluster.


Copyright © VMware, Inc. All rights reserved.