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

Retrieves one or more server hardware resources from an HPE OneView appliance.

​
Syntax

Get-OVServer
    [-Name <String>]
    [-SerialNumber <String>]
    [-ServerName <String>]
    [-Status <String[]>]
    [-NoProfile]
    [-InputObject <Object>]
    [-MaintenanceMode <Bool>]
    [-Label <String>]
    [-Count <Int>]
    [-Scope <Object>]
    [-ApplianceConnection <Object>]
    [<CommonParameters>]

​
Description

Get-OVServer returns server hardware objects from the connected HPE OneView appliance. You can filter results by server name, serial number, OS hostname reported by the iLO, health status, label, profile assignment, or hardware type. When called without parameters, all server hardware resources visible within the caller’s active scopes are returned. The cmdlet accepts server hardware type objects or server profile template objects via the pipeline to return only servers that match that hardware type or template.

​
Parameters

​
Name
String
Filter servers by the name assigned in HPE OneView. Supports wildcard patterns (e.g., "Encl1*").
​
SerialNumber
String
Filter servers by physical serial number.
​
ServerName
String
Filter servers by the OS hostname or server name as reported by the iLO.
​
Status
String[]
Filter servers by health status. Valid values: Critical, Warning, OK, Unknown, Disabled. Accepts multiple values.
​
NoProfile
Switch
Return only servers that do not have a server profile assigned.
​
InputObject
Object
A server hardware type or server profile template object (accepted from the pipeline via the ServerHardwareType or ServerProfileTemplate aliases). Returns only servers matching that type or template.
​
MaintenanceMode
Bool
Filter servers by maintenance mode state. Use $true to return only servers currently in maintenance mode.
​
Label
String
Filter servers by an assigned resource label.
​
Count
Int
Limit the number of results returned.
​
Scope
Object
Limit results to resources in the specified scope. Defaults to AllResourcesInScope, which respects the active session permissions.
​
ApplianceConnection
Object
The appliance connection object or name. Defaults to the default connected session (${Global:ConnectedSessions}).

​
Examples

​
Get all server hardware

Get-OVServer
Returns all server hardware resources visible within the current session’s active scopes.

​
Get a server by name

Get-OVServer -Name "Encl1, bay 1"
Returns the server hardware resource with the exact name Encl1, bay 1.

​
Filter by name using a wildcard

Get-OVServer -Name "Encl1*"
Returns all servers whose names begin with Encl1.

​
Get unassigned servers only

Get-OVServer -NoProfile
Returns only servers that do not currently have a server profile assigned. Useful when selecting targets for new profile deployments.

​
Filter by health status

Get-OVServer -Status Critical, Warning
Returns all servers that are in a Critical or Warning health state.

​
Get servers matching a hardware type

$sht = Get-OVServerHardwareType -Name "SY 480 Gen10 1"
Get-OVServer -InputObject $sht
Returns all servers of the SY 480 Gen10 1 hardware type.

​
Output

HPEOneView.ServerHardware Each returned object includes properties such as name, serialNumber, serverName, powerState, status, model, processorType, memoryMb, serverProfileUri, and ApplianceConnection.

Build docs developers (and LLMs) love

Get started for freeTalk to us