Skip to content

New HPOVLogicalSwitchGroup

Chris Lynch edited this page Dec 10, 2020 · 23 revisions

HPE OneView 4.10 Library

New-HPOVLogicalSwitchGroup

Create a new Logical Switch Group resource.

SYNTAX

New-HPOVLogicalSwitchGroup [-Name] <String>[ [-SwitchType] <SwitchParameter>][ [-NumberOfSwitches] <Int>][ [-ApplianceConnection] <Object>][ [-Async] <SwitchParameter>] [<CommonParameters>]

Detailed Description

The logical switch group is a template for creating logical switches. Logical switches are an aggregation of up to two physical top-of-rack switches. Once constructed from a logical switch group, a logical switch continues to be associated with its logical switch group. Any change in consistency between the logical switch group and its associated logical switches is monitored and made visible on the associated logical switch screen in HPE OneView. This Cmdlet will help create a Logical Switch Group resources. Only the following switch model family"s are supported: * Cisco Nexus 5000 * Cisco Nexus 5500 * Cisco Nexus 5600 * Cisco Nexus 6000 Please refer to either Get-HPOVSwitchType values, or the HPE OneView Support Matrix for which specific models are supported. Required privileges: Infrastructure administrator or Network administrator

Parameters

-ApplianceConnection <Object>

Aliases [-Appliance]

Specify one or more HPOneView.Appliance.Connection object(s) or Name property value(s). If Resource object is provided via Pipeline, the ApplianceConnection property of the object will be used.

Default Value: ${Global:ConnectedSessions} | ? Default

Aliases Appliance
Required? false
Position? named
Default value (${Global:ConnectedSessions} | ? Default)
Accept pipeline input? true (ByPropertyName)
Accept wildcard characters?    False

-Async <SwitchParameter>

Use this parameter to immediately return the async task. By default, the Cmdlet will wait for the task to complete.

Aliases None
Required? false
Position? named
Default value
Accept pipeline input? false
Accept wildcard characters?    False

-Name <String>

The Logical Switch Group resource Name.

Aliases None
Required? true
Position? named
Default value
Accept pipeline input? false
Accept wildcard characters?    False

-NumberOfSwitches <Int>

The maximum number of switches supported in the Logical Switch Group. Only 1 or 2 are allowed.

Aliases None
Required? false
Position? named
Default value 1
Accept pipeline input? false
Accept wildcard characters?    False

-SwitchType <SwitchParameter>

The Switch Type resource from Get-HPOVSwitchType.

Aliases None
Required? false
Position? named
Default value
Accept pipeline input? true (ByValue)
Accept wildcard characters?    False

<CommonParameters>

This cmdlet supports the common parameters: Verbose, Debug, ErrorAction, ErrorVariable, WarningAction, WarningVariable, OutBuffer, PipelineVariable, and OutVariable. For more information, see about_CommonParameters (http://go.microsoft.com/fwlink/?LinkID=113216)

Input Types

HPOneView.Networking.SwitchType [System.Management.Automation.PSCustomObject]

Switch Type resource from Get-HPOVSwitchType.

Return Values

HPOneView.Appliance.TaskResource [System.Management.Automation.PSCustomObject]

The async task resource object to monitor (if -Async was used) or results.

System.Collections.ArrayList <HPOneView.Appliance.TaskResource>

Collection of remove Logical Switch async task resources.

Examples

 -------------------------- EXAMPLE 1 --------------------------

Get-HPOVSwitchType -Name "Cisco Nexus 56xx" | New-HPOVLogicalSwitchGroup -Name "My Logical Switch Group Policy 1" -NumberOfSwitches 2

Create a Logical Switch Group fro the "Cisco Nexus 5600" series, specifying 2 expected switches.

Related Links


HPE OneView 4.00 Library

New-HPOVLogicalSwitchGroup

Create a new Logical Switch Group resource.

SYNTAX

New-HPOVLogicalSwitchGroup [-Name] <String>[ [-SwitchType] <SwitchParameter>][ [-NumberOfSwitches] <Int>][ [-ApplianceConnection] <Object>][ [-Async] <SwitchParameter>] [<CommonParameters>]

Detailed Description

The logical switch group is a template for creating logical switches. Logical switches are an aggregation of up to two physical top-of-rack switches. Once constructed from a logical switch group, a logical switch continues to be associated with its logical switch group. Any change in consistency between the logical switch group and its associated logical switches is monitored and made visible on the associated logical switch screen in HPE OneView. This Cmdlet will help create a Logical Switch Group resources. Only the following switch model family's are supported: * Cisco Nexus 5000 * Cisco Nexus 5500 * Cisco Nexus 5600 * Cisco Nexus 6000 Please refer to either Get-HPOVSwitchType values, or the HPE OneView Support Matrix for which specific models are supported. Required privileges: Infrastructure administrator or Network administrator

Parameters

-ApplianceConnection <Object>

Aliases [-Appliance]

Specify one or more HPOneView.Appliance.Connection object(s) or Name property value(s). If Resource object is provided via Pipeline, the ApplianceConnection property of the object will be used.

Default Value: ${Global:ConnectedSessions} | ? Default

Aliases Appliance
Required? false
Position? named
Default value (${Global:ConnectedSessions} | ? Default)
Accept pipeline input? true (ByPropertyName)
Accept wildcard characters?    False

-Async <SwitchParameter>

Use this parameter to immediately return the async task. By default, the Cmdlet will wait for the task to complete.

Aliases None
Required? false
Position? named
Default value
Accept pipeline input? false
Accept wildcard characters?    False

-Name <String>

The Logical Switch Group resource Name.

Aliases None
Required? true
Position? named
Default value
Accept pipeline input? false
Accept wildcard characters?    False

-NumberOfSwitches <Int>

The maximum number of switches supported in the Logical Switch Group. Only 1 or 2 are allowed.

Aliases None
Required? false
Position? named
Default value 1
Accept pipeline input? false
Accept wildcard characters?    False

-SwitchType <SwitchParameter>

The Switch Type resource from Get-HPOVSwitchType.

Aliases None
Required? false
Position? named
Default value
Accept pipeline input? true (ByValue)
Accept wildcard characters?    False

<CommonParameters>

This cmdlet supports the common parameters: Verbose, Debug, ErrorAction, ErrorVariable, WarningAction, WarningVariable, OutBuffer, PipelineVariable, and OutVariable. For more information, see about_CommonParameters (http://go.microsoft.com/fwlink/?LinkID=113216)

Input Types

HPOneView.Networking.SwitchType [System.Management.Automation.PSCustomObject]

Switch Type resource from Get-HPOVSwitchType.

Return Values

HPOneView.Appliance.TaskResource [System.Management.Automation.PSCustomObject]

The async task resource object to monitor (if -Async was used) or results.

System.Collections.ArrayList <HPOneView.Appliance.TaskResource>

Collection of remove Logical Switch async task resources.

Examples

 -------------------------- EXAMPLE 1 --------------------------

Get-HPOVSwitchType -Name "Cisco Nexus 56xx" | New-HPOVLogicalSwitchGroup -Name 'My Logical Switch Group Policy 1' -NumberOfSwitches 2

Create a Logical Switch Group fro the "Cisco Nexus 5600" series, specifying 2 expected switches.

Related Links


Wiki Table of Contents

Clone this wiki locally