Get-SCVMHostCluster

Applies To: System Center 2012 - Virtual Machine Manager

Get-SCVMHostCluster

Gets a host cluster object.

Syntax

Parameter Set: Connection
Get-SCVMHostCluster [[-Name] <String> ] [-VMMServer <ServerConnection> ] [ <CommonParameters>]

Parameter Set: VMHostGroup
Get-SCVMHostCluster [[-Name] <String> ] -VMHostGroup <HostGroup> [ <CommonParameters>]

Detailed Description

The Get-SCVMHostCluster cmdlet gets one or more host cluster objects from the System Center Virtual Machine Manager (VMM) database.

For more information about Get-SCVMHostCluster, type: "Get-Help Get-SCVMHostCluster -online".

Parameters

-Name<String>

Specifies the name of a VMM object.

Aliases

none

Required?

false

Position?

1

Default Value

none

Accept Pipeline Input?

false

Accept Wildcard Characters?

false

-VMHostGroup<HostGroup>

Specifies a virtual machine host group object.

Aliases

none

Required?

true

Position?

named

Default Value

none

Accept Pipeline Input?

true (ByValue)

Accept Wildcard Characters?

false

-VMMServer<ServerConnection>

Specifies a VMM server object.

Aliases

none

Required?

false

Position?

named

Default Value

none

Accept Pipeline Input?

true (ByValue)

Accept Wildcard Characters?

false

<CommonParameters>

This cmdlet supports the common parameters: -Verbose, -Debug, -ErrorAction, -ErrorVariable, -OutBuffer, and -OutVariable. For more information, see about_CommonParameters.

Inputs

The input type is the type of the objects that you can pipe to the cmdlet.

Outputs

The output type is the type of the objects that the cmdlet emits.

  • VMHostCluster

Examples

1: Get all host clusters managed by a VMM server.

This command gets all host cluster objects on VMMServer01 and displays information about each host cluster to the user.

PS C:\> Get-SCVMHostCluster -VMMServer "VMMServer01.Contoso.com"

2: Get all host clusters managed by a VMM server and display the host cluster name and virtualization platform for each cluster.

This command gets all host cluster objects on VMMServer01 and passes each object to the select-object cmdlet which displays the name and virtualization platform for each host cluster.

PS C:\> Get-SCVMHostCluster -VMMServer "VMMServer01.Contoso.com" | select -Property Name, VirtualizationPlatform

3: Get a host cluster by name.

This command gets the host cluster object named VMHostCluster03 and displays information about the cluster to the user.

PS C:\> Get-SCVMHostCluster -Name "VMHostCluster03.Contoso.com"

4: Display the object type, methods, and properties for a host cluster managed by VMM.

This command gets the host cluster objects on VMMServer01 and then passes a host cluster object to the Get-Member cmdlet, which displays the .NET type for a host cluster object and the list of events, methods, and properties associated with a host cluster object.

PS C:\> Get-SCVMHostCluster -VMMServer "VMMServer01.Contoso.com" | Get-Member

Add-SCVMHostCluster

Find-SCCluster

Install-SCVMHostCluster

Move-SCVMHostCluster

Read-SCVMHostCluster

Remove-SCVMHostCluster

Set-SCVMHostCluster

Test-SCVMHostCluster

Uninstall-SCVMHostCluster