Skip to content

Get-OVLogicalInterconnect

Syntax

Get-OVLogicalInterconnect
    [-Name <String>]
    [-NonCompliant]
    [-Scope <Object>]
    [-Label <String>]
    [-ApplianceConnection <Object>]
    [-Export <String>]
    [<CommonParameters>]

Description

A logical interconnect is a single administrative entity that consists of the configuration for a set of interconnects in a single enclosure or an HPE Synergy frame link topology, and includes:

  • The uplink sets, which connect to data center networks.
  • The mapping of networks to physical uplink ports, which is defined by the uplink sets for a logical interconnect.
  • The internal networks, which are used for server-to-server communications without traffic egressing any uplinks.
  • The downlink ports, which connect through the enclosure midplane to the servers in the enclosure.
  • The connections between interconnects, which are called stacking links.
  • Stacking links can be internal cables (through the enclosure) or external cables between the external ports of interconnects.

See the appropriate support or compatibility matrix on the Hewlett Packard Enterprise Information Library for the maximum number of networks that can be provisioned on a logical interconnect.

A logical interconnect derives its configuration from a logical interconnect group, which serves as a template to ensure that the logical interconnects being created are configured consistently.

For a server administrator, a logical interconnect represents the available networks through the interconnect uplinks and the interconnect downlink capabilities through a physical server?s interfaces. For a network administrator, a logical interconnect represents an Ethernet stacking configuration, aggregation layer connectivity, stacking topology, network reachability, statistics, and troubleshooting tools.

This Cmdlet retrieves a list of all Logical Interconnect or just specific ones via a query if the name parameter is provided. The output can be sent to a file using the exportFile parameter.

Info

Minimum required privileges: Read-only

Examples

Example 1

Get-OVLogicalInterconnect

Returns all Logical Interconnect defined on the appliance to standard output.

Example 2

Get-OVLogicalInterconnect -Name "Production"

Returns just the Production Logical Interconnect object to standard output.

Example 3

$myLogicalICs = Get-OVLogicalInterconnect -NonCompliant

Returns non-compliant logical interconnect resources.

Example 4

Get-OVLogicalInterconnect -Export "c:\myApplianceConfig\LogicalInterconnects.json"

Returns the query results to the file c:\myApplianceConfig\LogicalInterconnects.json

Parameters

-Name <String>

The name of the Logical Interconnect to retrieve.

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

-Scope <Object>

Filter resources based on provided Scope membership. By default, all resources for the accounts Active Permissions will be displayed. Allowed values:

  • AllResources
  • AllResourcesInScope
  • [HPEOneView.Appliance.ScopeCollection]
  • [HPEOneView.Appliance.ConnectionPermission]
Aliases None
Required? False
Position? Named
Default value AllResourcesInScope
Accept pipeline input? false
Accept wildcard characters? False

-Label <String>

Specify the label associated with resources.

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

-ApplianceConnection <Object>

Specify one or more [HPEOneView.Appliance.Connection] object(s) or Name property value(s).

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

-Export <String>

The full path and file name to export the contents retrieved from the call to Get-OVLogicalInterconnect.

Aliases x, ExportFile
Required? False
Position? Named
Default value
Accept pipeline input? false
Accept wildcard characters? False

-NonCompliant <SwitchParameter>

Filter resources based on their non-compliant state.

Aliases None
Required? False
Position? Named
Default value
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

Logical Interconnect resource object from Get-OVLogicalInterconnect

Multiple Logical Interconnects