New HPOVUplinkSet

Library Version 3.00

Library Version 2.00

Library Version 1.20

### HPE OneView 3.00 Library

New-HPOVUplinkSet

Create a new Uplink Set in a Logical Interconnect Group.

SYNTAX

New-HPOVUplinkSet [-InputObject] <Object> [-Name] <String> [-Type] <String> [-Networks] <Array> [-NativeEthNetwork] <Object> [-UplinkPorts] <Array> [-EthMode] <String> [-LacpTimer] <String> [-PrimaryPort] <String>[ [-Async] <SwitchParameter>] [-ApplianceConnection] <Object> [<CommonParameters>]

New-HPOVUplinkSet [-InputObject] <Object> [-Name] <String> [-Type] <String> [-Networks] <Array> [-UplinkPorts] <Array> [-fcUplinkSpeed] <String>[ [-Async] <SwitchParameter>] [-ApplianceConnection] <Object> [<CommonParameters>]

Detailed Description

Create a new Uplink Set in a Logical Interconnect Group. The Logical Interconnect Group must already exist. Multiple networks and multiple uplink ports can be assigned to the uplink set during creation.

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?	true
Position?	named
Default value	(${Global:ConnectedSessions} | ? Default)
Accept pipeline input?	true (ByPropertyName)
Accept wildcard characters?	False

-Async <SwitchParameter>

Immediately return asyncronous task object to monitor.

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

-EthMode <String>

Aliases [-usEthMode] Sets the LACP mode on the uplink ports. Valid for ETHERNET Uplinks only. Accepted Values:

• Auto (Default)
• Failover

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

-InputObject <Object>

Aliases [-li, -lig] Either a Logical Interconnect Group (Get-HPOVLogicalInterconnectGroup) or Logical Interconnect (Get-HPOVLogicalInterconnect) resource object.

Aliases	li, lig, Resource
Required?	true
Position?	named
Default value
Accept pipeline input?	true (ByValue)
Accept wildcard characters?	False

-LacpTimer <String>

Set the LACP Timer value, which sets the lacpdu frequecy to the LACP peer. Accepted values:

• Long
• Short (Default)

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

-Name <String>

Aliases [-usName] Logical Uplink set Name

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

-NativeEthNetwork <Object>

Aliases [-usNativeEthNetwork, -Native, -PVID] The valid name of the Native Ethernet Network that is a member of the usNetworks parameter.

Aliases	usNativeEthNetwork, Native, PVID
Required?	true
Position?	named
Default value
Accept pipeline input?	false
Accept wildcard characters?	False

-Networks <Array>

Aliases [-usNetworks] Array of Ethernet Network Names

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

-PrimaryPort <String>

Specify the Primary Uplink Port when EthMode is set to Failover. Parameter is not valid when EthMode parameter is set to Auto.

Example: 'Bay1:X1'

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

-Type <String>

Aliases [-usType] Uplink set Type. Accepted values are

• Ethernet (Default)
• FibreChannel
• Tunnel
• Untagged
• ImageStreamer

ImageStreamer is only supported with Synergy infrastructure. When assigning an Ethernet Network to an ImageStreamer Uplink Set, the network resource must be a Tagged Ethernet Network.

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

-UplinkPorts <Array>

Aliases [-usUplinkPorts] Array of uplink ports with "BAYID:FacePlatePortID". When configuring a Synergy infrastructure, the Uplink Port format needs to be "EnclosureID:BayID:FacePlatePortID".

FlexFabric e.g. @("BAY1:X1","BAY1:X2") or "BAY1:X5","BAY2:X5" VC Fibre Channel e.g. @("BAY3:1","BAY3:2") or "BAY3:1","BAY3:2" Synergy VC e.g. "Enclosure1:Bay3:Q1","Enclosure1:Bay3:Q2","Enclosure2:Bay6:Q1","Enclosure2:Bay6:Q2" Synergy VC Sub-Interface e.g. "Enclosure1:Bay3:Q1.1","Enclosure1:Bay3:Q2.1","Enclosure2:Bay6:Q1.2","Enclosure2:Bay6:Q2.2"

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

-fcUplinkSpeed <String>

Specify the Fibre Channel Uplink Port speed. Accepted values:

• Auto (Default)
• 2
• 4
• 8

Aliases	None
Required?	true
Position?	named
Default value	Auto
Accept pipeline input?	false
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.LogicalInterconnect [System.Management.Automation.PSCustomObject] Logical Interconnect Resource from Get-HPOVLogicalInterconnect

HPOneView.Networking.LogicalInterconnectGroup [System.Management.Automation.PSCustomObject] Logical Interconnect Group Resource from Get-HPOVLogicalInterconnectGroup

Return Values

HPOneView.Appliance.TaskResource {System.Management.Automation.PSCustomObject}

Async Task Resource object

Examples

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

PS C:\> Get-HPOVLogicalInterconnectGroup -Name 'LIG Prod' | New-HPOVUplinkSet -Name "Uplink Set 1" -Type Ethernet -Networks "RED","BLUE","GREEN" -NativeEthNetwork "RED" -UplinkPorts "BAY1:X5","BAY1:X6","BAY2:X5","BAY2:X6" -EthMode "Auto"

To Create an Ethernet Uplink Template

 -------------------------- EXAMPLE 2 --------------------------

PS C:\> $ethNets = 'Net1','Net2','Net3' | Get-HPOVNetwork -Type Ethernet
PS C:\> Get-HPOVLogicalInterconnectGroup -Name 'LIG Prod' | New-HPOVUplinkSet -Name "Uplink Set 1" -Type Ethernet -Networks $ethNets -NativeEthNetwork $ethNets[0] -UplinkPorts "BAY1:X5","BAY1:X6","BAY2:X5","BAY2:X6" -EthMode "Auto"

Get the network resource objects, and define a new Uplink Set template that will be assigned to the Logical Interconnect Group resource.

 -------------------------- EXAMPLE 3 --------------------------

PS C:\> $LIGProd = Get-HPOVLogicalInterconnectGroup -Name 'LIG Prod'
PS C:\> New-HPOVUplinkSet -Resource $LIGProd -Name "Fabric A" -Type FibreChannel -Networks "FABRIC_A" -UplinkPorts "BAY1:X1","BAY1:X2"

To Create a Fibre Channel Uplink Template for VC FlexFabric modules.

 -------------------------- EXAMPLE 4 --------------------------

PS C:\> Get-HPOVLogicalInterconnect -Name 'Encl1 LIG Prod' | New-HPOVUplinkSet -Name "New Uplink Set" -Type Ethernet -Networks "RED","BLUE","GREEN" -NativeEthNetwork "RED" -UplinkPorts "BAY1:X5","BAY1:X6","BAY2:X5","BAY2:X6" -EthMode "Auto"

Add a new Uplink Set to an existing Logical Interconnect resource.

 -------------------------- EXAMPLE 5 --------------------------

PS C:\> $MlagNetworks = Get-HPOVNetwork -Type Ethernet -Name 'My MLAG Network*'
PS C:\> Get-HPOVLogicalInterconnectGroup -Name 'My Synergy Prod LIG' | New-HPOVUplinkSet -Name "MLAG UplinkSet" -Type Ethernet -Networks $MlagNetworks -NativeEthNetwork ($MlagNetworks | ? vlanid -eq 144) -UplinkPorts "Enclosure1:BAY3:Q1","Enclosure1:BAY3:Q2","Enclosure2:BAY6:Q1","Enclosure2:BAY6:Q2" -EthMode "Auto"

Create a Synergy MLAG Uplink Set using 40Gb capable ports.

 -------------------------- EXAMPLE 6 --------------------------

PS C:\> $MlagNetworks = Get-HPOVNetwork -Type Ethernet -Name 'My MLAG Network*'
PS C:\> Get-HPOVLogicalInterconnectGroup -Name 'My Synergy Prod LIG' | New-HPOVUplinkSet -Name "MLAG UplinkSet" -Type Ethernet -Networks $MlagNetworks -NativeEthNetwork ($MlagNetworks | ? vlanid -eq 144) -UplinkPorts "Enclosure1:BAY3:Q1.1","Enclosure1:BAY3:Q2.1","Enclosure2:BAY6:Q1.1","Enclosure2:BAY6:Q2.1" -EthMode "Auto"

Create a Synergy MLAG Uplink Set using 10Gb subports of QSFP transceiver slots.

Related Links

• [New-HPOVLogicalInterconnectGroup] (/~https://github.com/HewlettPackard/POSH-HPOneView/wiki/New-HPOVLogicalInterconnectGroup)
• [Get-HPOVLogicalInterconnectGroup] (/~https://github.com/HewlettPackard/POSH-HPOneView/wiki/Get-HPOVLogicalInterconnectGroup)
• [Get-HPOVLogicalInterconnect] (/~https://github.com/HewlettPackard/POSH-HPOneView/wiki/Get-HPOVLogicalInterconnect)
• [Get-HPOVUplinkSet] (/~https://github.com/HewlettPackard/POSH-HPOneView/wiki/Get-HPOVUplinkSet)

---

Top

### HPE OneView 2.00 Library

New-HPOVUplinkSet

Create a new Uplink Set in a Logical Interconnect Group.

SYNTAX

New-HPOVUplinkSet [-Resource] <Object> [-Name] <String> [-Type] <String> [-Networks] <Array> [-NativeEthNetwork] <Object> [-UplinkPorts] <Array> [-EthMode] <String> [-LacpTimer] <String> [-PrimaryPort] <String> [-ApplianceConnection] <Object> [<CommonParameters>]

New-HPOVUplinkSet [-Resource] <Object> [-Name] <String> [-Type] <String> [-Networks] <Array> [-UplinkPorts] <Array> [-fcUplinkSpeed] <String> [-ApplianceConnection] <Object> [<CommonParameters>]

Detailed Description

Create a new Uplink Set in a Logical Interconnect Group. The Logical Interconnect Group must already exist. Multiple networks and multiple uplink ports can be assigned to the uplink set during creation.

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?	true
Position?	named
Default value	(${Global:ConnectedSessions} | ? Default)
Accept pipeline input?	true (ByPropertyName)
Accept wildcard characters?	False

-EthMode <String>

Aliases [-usEthMode] Sets the LACP mode on the uplink ports. Valid for ETHERNET Uplinks only. Accepted Values:

• Auto (Default)
• Failover

Aliases	usEthMode
Required?	true
Position?	6
Default value	Auto
Accept pipeline input?	false
Accept wildcard characters?	False

-LacpTimer <String>

Set the LACP Timer value, which sets the lacpdu frequecy to the LACP peer. Accepted values:

• Long (Default)
• Short

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

-Name <String>

Aliases [-usName] Logical Uplink set Name

Aliases	usName
Required?	true
Position?	1
Default value
Accept pipeline input?	false
Accept wildcard characters?	False

-NativeEthNetwork <Object>

Aliases [-usNativeEthNetwork, -Native, -PVID] The valid name of the Native Ethernet Network that is a member of the usNetworks parameter.

Aliases	usNativeEthNetwork, Native, PVID
Required?	true
Position?	4
Default value
Accept pipeline input?	false
Accept wildcard characters?	False

-Networks <Array>

Aliases [-usNetworks] Array of Ethernet Network Names

Aliases	usNetworks
Required?	true
Position?	3
Default value	@()
Accept pipeline input?	false
Accept wildcard characters?	False

-PrimaryPort <String>

Specify the Primary Uplink Port when EthMode is set to Failover. Parameter is not valid when EthMode parameter is set to Auto.

Example: 'Bay1:X1'

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

-Resource <Object>

Aliases [-li, -lig] Either a Logical Interconnect Group (Get-HPOVLogicalInterconnectGroup) or Logical Interconnect (Get-HPOVLogicalInterconnect) resource object.

Aliases	li, lig
Required?	true
Position?	0
Default value
Accept pipeline input?	true (ByValue)
Accept wildcard characters?	False

-Type <String>

Aliases [-usType] Uplink set Type. Accepted values are

• Ethernet (Default)
• FibreChannel
• Tunnel
• Untagged

Aliases	usType
Required?	true
Position?	2
Default value
Accept pipeline input?	false
Accept wildcard characters?	False

-UplinkPorts <Array>

Aliases [-usUplinkPorts] Array of uplink ports with "BAYID:FacePlatePortID".

FlexFabric e.g. @("BAY1:X1","BAY1:X2") or "BAY1:X5","BAY2:X5" VC Fibre Channel e.g. @("BAY3:1","BAY3:2") or "BAY3:1","BAY3:2"

Aliases	usUplinkPorts
Required?	true
Position?	5
Default value	@()
Accept pipeline input?	false
Accept wildcard characters?	False

-fcUplinkSpeed <String>

Specify the Fibre Channel Uplink Port speed. Accepted values:

• Auto (Default)
• 2
• 4
• 8

Aliases	None
Required?	true
Position?	9
Default value	Auto
Accept pipeline input?	false
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.LogicalInterconnect [System.Management.Automation.PSCustomObject] Logical Interconnect Resource from Get-HPOVLogicalInterconnect

HPOneView.Networking.LogicalInterconnectGroup [System.Management.Automation.PSCustomObject] Logical Interconnect Group Resource from Get-HPOVLogicalInterconnectGroup

Return Values

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

Async Task Resource object.

Examples

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

PS C:\> Get-HPOVLogicalInterconnectGroup 'LIG Prod' | New-HPOVUplinkSet -Name "Uplink Set 1" -Type Ethernet -Networks "RED","BLUE","GREEN" -NativeEthNetwork "RED" -UplinkPorts "BAY1:X5","BAY1:X6","BAY2:X5","BAY2:X6" -EthMode "Auto"

To Create an Ethernet Uplink Template

 -------------------------- EXAMPLE 2 --------------------------

PS C:\> $ethNets = 'Net1','Net2','Net3' | Get-HPOVNetwork -Type Ethernet
PS C:\> Get-HPOVLogicalInterconnectGroup 'LIG Prod' | New-HPOVUplinkSet -Name "Uplink Set 1" -Type Ethernet -Networks $ethNets -NativeEthNetwork $ethNets[0] -UplinkPorts "BAY1:X5","BAY1:X6","BAY2:X5","BAY2:X6" -EthMode "Auto"

Get the network resource objects, and define a new Uplink Set template that will be assigned to the Logical Interconnect Group resource.

 -------------------------- EXAMPLE 3 --------------------------

PS C:\> $LIGProd = Get-HPOVLogicalInterconnectGroup 'LIG Prod'
PS C:\> New-HPOVUplinkSet -Resource $LIGProd -Name "Fabric A" -Type FibreChannel -Networks "FABRIC_A" -UplinkPorts "BAY1:X1","BAY1:X2"

To Create a Fibre Channel Uplink Template for VC FlexFabric modules.

 -------------------------- EXAMPLE 4 --------------------------

PS C:\> Get-HPOVLogicalInterconnect 'Encl1 LIG Prod' | New-HPOVUplinkSet -Name "New Uplink Set" -Type Ethernet -Networks "RED","BLUE","GREEN" -NativeEthNetwork "RED" -UplinkPorts "BAY1:X5","BAY1:X6","BAY2:X5","BAY2:X6" -EthMode "Auto"

Add a new Uplink Set to an existing Logical Interconnect resource.

 -------------------------- EXAMPLE 5 --------------------------

PS C:\> $LI = Get-HPOVLogicalInterconnect 'Encl1 LIG Prod'

PS C:> New-HPOVUplinkSet -Resource $LI -Name "Fabric A" -Type FibreChannel -Networks FABRIC_A -UplinkPorts "BAY1:X1","BAY1:X2"

Related Links

• [New-HPOVLogicalInterconnectGroup] (/~https://github.com/HewlettPackard/POSH-HPOneView/wiki/New-HPOVLogicalInterconnectGroup)
• [Get-HPOVLogicalInterconnectGroup] (/~https://github.com/HewlettPackard/POSH-HPOneView/wiki/Get-HPOVLogicalInterconnectGroup)
• [Get-HPOVLogicalInterconnect] (/~https://github.com/HewlettPackard/POSH-HPOneView/wiki/Get-HPOVLogicalInterconnect)
• [Get-HPOVUplinkSet] (/~https://github.com/HewlettPackard/POSH-HPOneView/wiki/Get-HPOVUplinkSet)

---

Top

### HPE OneView 1.20 Library

New-HPOVUplinkSet

Create a new Uplink Set in a Logical Interconnect Group.

SYNTAX

New-HPOVUplinkSet [-ligName] <ligName> [-Name] <Name> [-Type] <Type>[ [-Networks] <Networks>][ [-nativeEthNetwork] <nativeEthNetwork>][ [-UplinkPorts] <UplinkPorts>][ [-EthMode] <EthMode>][ [-lacpTimer] <lacpTimer>][ [-fcUplinkSpeed] <fcUplinkSpeed>] [<CommonParameters>]

Detailed Description

Create a new Uplink Set in a Logical Interconnect Group. The Logical Interconnect Group must already exist. Multiple networks and multiple uplink ports can be assigned to the uplink set during creation.

Parameters

-ligName <ligName>

Logical Interconnect Group Name to create the Uplink set for.

Aliases	None.
Required?	true
Position?	1
Default value
Accept pipeline input?	false
Accept wildcard characters?	false

-Name <Name>

Aliases [-usName] Logical Uplink set Name

Aliases	None.
Required?	true
Position?	2
Default value
Accept pipeline input?	false
Accept wildcard characters?	false

-Type <Type>

Aliases [-usType] Uplink set Type. Accepted values are

• Ethernet (Default)
• FibreChannel
• Tunnel
• Untagged

Aliases	None.
Required?	true
Position?	3
Default value
Accept pipeline input?	false
Accept wildcard characters?	false

-Networks <Networks>

Aliases [-usNetworks] Array of Ethernet Network Names

Aliases	None.
Required?	false
Position?	4
Default value	@()
Accept pipeline input?	false
Accept wildcard characters?	false

-nativeEthNetwork <nativeEthNetwork>

Aliases [-usNativeEthNetwork, -Native, -PVID] The valid name of the Native Ethernet Network that is a member of the usNetworks parameter.

Aliases	None.
Required?	false
Position?	5
Default value
Accept pipeline input?	false
Accept wildcard characters?	false

-UplinkPorts <UplinkPorts>

Aliases [-usUplinkPorts] Array of uplink ports with "BAYID:FacePlatePortID".

FlexFabric e.g. @("BAY1:X1","BAY1:X2") or "BAY1:X5","BAY2:X5" VC Fibre Channel e.g. @("BAY3:1","BAY3:2") or "BAY3:1","BAY3:2"

Aliases	None.
Required?	false
Position?	6
Default value	@()
Accept pipeline input?	false
Accept wildcard characters?	false

-EthMode <EthMode>

Aliases [-usEthMode] Sets the LACP mode on the uplink ports. Valid for ETHERNET Uplinks only. Acceopted Values:

• Auto (Default)
• Failover

Aliases	None.
Required?	false
Position?	7
Default value	Auto
Accept pipeline input?	false
Accept wildcard characters?	false

-lacpTimer <lacpTimer>

Set the LACP Timer value, which sets the lacpdu frequecy to the LACP peer. Accepted values:

• Long (Default)
• Short

Aliases	None.
Required?	false
Position?	8
Default value	Long
Accept pipeline input?	false
Accept wildcard characters?	false

-fcUplinkSpeed <fcUplinkSpeed>

Specify the Fibre Channel Uplink Port speed. Accepted values:

• Auto (Default)
• 2
• 4
• 8

Aliases	None.
Required?	false
Position?	9
Default value	Auto
Accept pipeline input?	false
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

None. You cannot pipe objects to this cmdlet.

Return Values

System.Management.Automation.PSCustomObject

Async Task Resource object.

Examples

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

PS C:\> New-HPOVUplinkSet -ligName "LIG Prod" -Name "US1" -Type "Ethernet" -Networks "RED","BLUE","GREEN" -NativeEthNetwork "RED" -UplinkPorts "BAY1:X5","BAY1:X6","BAY2:X5","BAY2:X6" -EthMode "Auto"

To Create an Ethernet Uplink Template

 -------------------------- EXAMPLE 2 --------------------------

PS C:\> New-HPOVUplinkSet -ligName "LIG Prod" -Name "Fabric A" -Type "FibreChannel" -Networks "FABRIC_A" -UplinkPorts "BAY1:X1","BAY1:X2"

To Create a Fibre Channel Uplink Template for VC FlexFabric modules.

 -------------------------- EXAMPLE 3 --------------------------

PS C:\> New-HPOVUplinkSet -ligName "LIG Prod" -Name "VCFC Fabric A" -Type "FibreChannel" -Networks "VCFC FABRIC A" -UplinkPorts "BAY3:1","BAY3:2"

To Create a Fibre Channel Uplink Template for VC Fibre Channel modules.

Related Links

• [New-HPOVLogicalInterconnectGroup] (/~https://github.com/HewlettPackard/POSH-HPOneView/wiki/New-HPOVLogicalInterconnectGroup)
• [Get-HPOVLogicalInterconnectGroup] (/~https://github.com/HewlettPackard/POSH-HPOneView/wiki/Get-HPOVLogicalInterconnectGroup)
• [Get-HPOVLogicalInterconnect] (/~https://github.com/HewlettPackard/POSH-HPOneView/wiki/Get-HPOVLogicalInterconnect)
• [Get-HPOVUplinkSet] (/~https://github.com/HewlettPackard/POSH-HPOneView/wiki/Get-HPOVUplinkSet)

---

Top