Get-SCApplicableVMHostGroup

Get-SCApplicableVMHostGroup

Gets an applicable host group.

Syntax

Parameter Set: ByLogicalSwitch
Get-SCApplicableVMHostGroup -LogicalSwitch <LogicalSwitch> [-VMMServer <ServerConnection> ] [ <CommonParameters>]

Parameter Set: ByNativeUplinkPortProfile
Get-SCApplicableVMHostGroup -NativeUplinkPortProfile <NativeUplinkPortProfile> [-VMMServer <ServerConnection> ] [ <CommonParameters>]

Parameter Set: ByUplinkPortProfileSet
Get-SCApplicableVMHostGroup -UplinkPortProfileSet <UplinkPortProfileSet> [-VMMServer <ServerConnection> ] [ <CommonParameters>]

Detailed Description

The Get-SCApplicableVMHostGroup cmdlet gets the host group associated with a logical switch, a native uplink port profile, or an uplink port profile set

Parameters

-LogicalSwitch<LogicalSwitch>

Specifies a logical switch object.

Aliases

none

Required?

true

Position?

named

Default Value

none

Accept Pipeline Input?

false

Accept Wildcard Characters?

false

-NativeUplinkPortProfile<NativeUplinkPortProfile>

Specifies a native uplink port profile object.

Aliases

none

Required?

true

Position?

named

Default Value

none

Accept Pipeline Input?

false

Accept Wildcard Characters?

false

-UplinkPortProfileSet<UplinkPortProfileSet>

Specifies an uplink port profile set object.

To obtain an uplink port profile set object, use the Get-SCUplinkPortProfileSet cmdlet.

Aliases

none

Required?

true

Position?

named

Default Value

none

Accept Pipeline Input?

false

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 (https://go.microsoft.com/fwlink/p/?LinkID=113216).

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.

Examples

1: Get the applicable host group for a logical switch.

The first command gets the logical switch object named LogicalSwitch01 and stores the object in the $LogSwitch variable.

The second command gets the applicable host group for the logical switch stored in $LogSwitch.

PS C:\> $LogSwitch = Get-SCLogicalSwitch -Name "LogicalSwitch01"
PS C:\> Get-SCApplicableVMHostGroup -LogicalSwitch $LogSwitch

The first command gets the uplink port profile set object named UplinkPortProfileSet01 and stores the object in the $UplinkPortProfSet variable.

The second command gets the applicable host group for the uplink port profile set stored in $UplinkPortProfSet.

PS C:\> $UplinkPortProfSet = Get-SCUplinkPortProfileSet -Name "UplinkPortProfileSet01"
PS C:\> Get-SCApplicableVMHostGroup -UplinkPortProfileSet $UplinkPortProfSet

3: Get the applicable host group for a NativeUplinkPortProfile.

The first command gets the native uplink port profile object named NativeUplinkPortProfile01 and stores the object in the $NativeUplinkPortProf variable.

The second command gets the applicable host group for the native uplink port profile stored in $NativeUplinkPortProf.

PS C:\> $NativeUplinkPortProf = Get-SCNativeUplinkPortProfile -Name "NativeUplinkPortProfile01"
PS C:\> Get-SCApplicableVMHostGroup -NativeUplinkPortProfile $NativeUplinkPortProf

Get-SCLogicalSwitch

Get-SCNativeUplinkPortProfile

Get-SCUplinkPortProfileSet