Skip to content

Get-OVInterconnect

Syntax

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

Description

Interconnects enable communication between the server hardware in the enclosure and the data center networks. Interconnects that are managed are put in a Configured state when the Synergy frame is configured by creating a logical enclosure. An unmanaged interconnect remains in the Monitored state when the Synergy frame is configured by creating a logical enclosure. Retrieves a list of all Interconnects (Ethernet, FC, Converged Network, and/or SAS) or just specific ones via a query if the name parameter is provided. The output can be sent to a file using the Export parameter.

Info

Minimum required privileges: Read-only

Examples

Example 1

Get-OVInterconnect

Returns all Interconnects managed by all connected appliances to standard output.

Example 2

Get-OVInterconnect -Name "Encl1, Interconnect 1"

Returns just the Encl1, Interconnect 1 Interconnect object to standard output.

Example 3

Get-OVInterconnect -exportFile "c:\myApplianceConfig\ICs.json"

Returns the Get-OVInterconnect query results to the file c:\myApplianceConfig\ICs.json

Parameters

-Name <String>

The name of the 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-OVInterconnect.

Aliases x, exportFile
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

Single Interconnect object.

Single SAS Interconnect object.

Multiple Interconnect objects.