Skip to main content

Documentation Index

Fetch the complete documentation index at: https://mintlify.com/HewlettPackard/POSH-HPEOneView/llms.txt

Use this file to discover all available pages before exploring further.

​
Synopsis

Retrieve one or more logical enclosure objects from the HPE OneView appliance.

​
Syntax

Get-OVLogicalEnclosure
    [-Name <String>]
    [-EnclosureGroup <Object>]
    [-NonCompliant]
    [-Scope <Object>]
    [-ApplianceConnection <Object>]
    [<CommonParameters>]

​
Description

Get-OVLogicalEnclosure retrieves logical enclosure objects from HPE OneView. A logical enclosure is the software-defined representation of one or more HPE Synergy frames that are managed as a single unit under a shared enclosure group. Logical enclosure vs. physical enclosure
ConceptCmdletDescription
Physical enclosureGet-OVEnclosureThe physical chassis hardware — the frame itself.
Logical enclosureGet-OVLogicalEnclosureThe software policy layer applied to one or more frames, tied to an enclosure group.
When HPE Synergy frames are discovered by the Composer appliance, a logical enclosure is automatically created from the enclosure group configuration. Changes to the logical enclosure (such as firmware updates and configuration compliance) are managed at this layer.
Logical enclosures are a concept exclusive to HPE Synergy. HPE BladeSystem c-Class enclosures managed by OneView do not have a separate logical enclosure layer.
Use -EnclosureGroup to filter by the associated enclosure group. Use -NonCompliant to return only logical enclosures whose current state does not match their enclosure group configuration.

​
Parameters

​
Name
String
The name (or wildcard pattern) of the logical enclosure to retrieve.
​
EnclosureGroup
Object
Filters results to logical enclosures associated with the specified enclosure group. Accepts a name (string) or an enclosure group object from Get-OVEnclosureGroup. Accepts pipeline input.
​
NonCompliant
SwitchParameter
Returns only logical enclosures that are out of compliance with their enclosure group definition. Useful for identifying frames that require a configuration update.
​
Scope
Object
Filters results to resources within the specified scope. Defaults to AllResourcesInScope, which returns all resources accessible to the current user’s active permissions.
​
ApplianceConnection
Object
The HPE OneView appliance connection. Defaults to the current default session.

​
Examples

​
Example 1: List all logical enclosures

Return all logical enclosures from the connected appliance. 
Get-OVLogicalEnclosure

Name                Status  EnclosureGroupName    FrameCount  ComplianceState
----                ------  ------------------    ----------  ---------------
SYN-LogEnc-1        OK      Synergy Default EG    3           Consistent
SYN-LogEnc-Dev      Warning Synergy Dev EG        1           Inconsistent

​
Example 2: Get a specific logical enclosure

Retrieve a single logical enclosure by name. 
$LogEnc = Get-OVLogicalEnclosure -Name "SYN-LogEnc-1"

​
Example 3: Filter by enclosure group

Return all logical enclosures associated with a specific enclosure group. 
$EG = Get-OVEnclosureGroup -Name "Synergy Default EG"
$EG | Get-OVLogicalEnclosure

​
Example 4: Find non-compliant logical enclosures

Return logical enclosures that have drifted from their enclosure group definition. 
Get-OVLogicalEnclosure -NonCompliant

​
Example 5: Trigger an update on non-compliant enclosures

Find non-compliant logical enclosures and update them to bring them back into compliance. 
Get-OVLogicalEnclosure -NonCompliant | Update-OVLogicalEnclosure

​
Output

Returns one or more HPEOneView.LogicalEnclosure objects. Key properties include name, state, complianceState, enclosureGroupUri, enclosureUris, and uri. Returns an empty collection when no matching resources are found.
  • Get-OVEnclosure — Retrieve the underlying physical enclosure (frame) objects.
  • Get-OVEnclosureGroup — Retrieve enclosure group templates.
  • New-OVLogicalEnclosure — Create a logical enclosure for Synergy frames.
  • Update-OVLogicalEnclosure — Update or re-apply the enclosure group configuration.
  • Remove-OVLogicalEnclosure — Delete a logical enclosure.

Build docs developers (and LLMs) love

Get started for freeTalk to us