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

Applies a firmware baseline to a Gen10 or newer server hardware resource or server profile, updating installed components to match the specified SPP.

​
Syntax

Update-OVServerFirmware
    -InputObject <Object>
    -Baseline <Object>
    [-PatchLevel <Version>]
    [-FirmwareInstallationPolicy <String>]
    [-FirmwareInstallMode <String>]
    [-ReinstallFirmware]
    [-PreviewOnly]
    [-Async]
    [-ApplianceConnection <Object>]
    [<CommonParameters>]

​
Description

Update-OVServerFirmware deploys a firmware baseline to a target server hardware or server profile resource. It generates a compliance preview first to determine which components need to be updated, then initiates the firmware deployment. Platform requirements:
  • Server hardware must be Gen10 or newer.
  • When targeting server hardware directly, the server must not have a server profile assigned and must have an iLO Advanced license (or HPE OneView Advanced/Standard + iLO Advanced).
  • When targeting a server profile, the profile’s firmware management settings are updated to reference the specified baseline.
The -FirmwareInstallMode parameter controls the scope of the update:
ModeBehavior
FirmwareAndSoftware (default)Updates firmware and OS drivers
FirmwareOnlyUpdates firmware only (offline, server must be powered off)
FirmwareOfflineOffline firmware update
FirmwareAndOSDriversUpdates firmware and OS-level drivers
FirmwareOnlyOfflineModeOffline firmware-only mode
The -FirmwareInstallationPolicy parameter controls when components are updated:
PolicyBehavior
LowerThanBaseline (default)Only updates components older than the baseline
NotEqualToBaselineUpdates components that differ from the baseline (including downgrades)

​
Parameters

​
InputObject
Object
required
The server hardware or server profile resource to update. Accepts objects from Get-OVServer or Get-OVServerProfile, or pipeline input.Aliases: Server, ServerHardware, ServerProfile
​
Baseline
Object
required
The firmware baseline (SPP) to deploy. Accepts an HPEOneView.Appliance.Baseline object from Get-OVBaseline.
​
PatchLevel
Version
An optional specific patch-level version within the baseline to target. The patch level must exist in the servicePackData.supplements collection of the baseline object.
​
FirmwareInstallationPolicy
String
Controls which components are updated.
  • LowerThanBaseline (default) — only update components with versions older than the baseline.
  • NotEqualToBaseline — update any component whose version does not exactly match the baseline, including downgrading components that are newer.
​
FirmwareInstallMode
String
The installation mode for the firmware update. Defaults to FirmwareAndSoftware.Valid values: FirmwareOnly, FirmwareAndSoftware, FirmwareOffline, FirmwareAndOSDrivers, FirmwareOnlyOfflineMode.Aliases: FirmwareMode
​
ReinstallFirmware
SwitchParameter
Force re-installation of firmware components even if the installed version already matches the baseline. Corresponds to the forceApplyFirmware property in the API.
​
PreviewOnly
SwitchParameter
Generate and return the compliance preview without applying any firmware changes. Useful for reviewing what would be updated before committing.
​
Async
SwitchParameter
Return the background task object immediately without waiting for the firmware update to complete. Use Wait-OVTaskComplete to block on the returned task.
​
ApplianceConnection
Object
Specify one or more appliance connection objects or hostnames. Defaults to the default connected appliance ($ConnectedSessions | Where-Object Default).Aliases: Appliance

​
Examples

​
Update a single server

$baseline = Get-OVBaseline -SppName "HPE Service Pack for ProLiant" -Version "2023.11.01"
$server = Get-OVServer -Name "Encl1, bay 1"
Update-OVServerFirmware -InputObject $server -Baseline $baseline
Updates all firmware components on the server that are older than the specified SPP baseline.

​
Update and wait for completion

$baseline = Get-OVBaseline -SppName "HPE Service Pack for ProLiant" -Version "2023.11.01"
$task = Get-OVServer -Name "Encl1, bay 1" | Update-OVServerFirmware -Baseline $baseline -Async
$task | Wait-OVTaskComplete
Initiates a firmware update asynchronously and waits for it to complete.

​
Bulk update all servers

$baseline = Get-OVBaseline -SppName "HPE Service Pack for ProLiant" -Version "2023.11.01"
$tasks = Get-OVServer | Update-OVServerFirmware -Baseline $baseline -Async
$tasks | Wait-OVTaskComplete
Submits firmware update tasks for all managed servers simultaneously, then waits for all tasks to complete.

​
Preview what would be updated

$baseline = Get-OVBaseline -SppName "HPE Service Pack for ProLiant" -Version "2023.11.01"
Get-OVServer -Name "Encl1, bay 1" | Update-OVServerFirmware -Baseline $baseline -PreviewOnly
Displays the compliance preview (which components would be updated and to what version) without applying any changes.

​
Update using NotEqualToBaseline policy

$baseline = Get-OVBaseline -SppName "HPE Service Pack for ProLiant" -Version "2023.11.01"
$server = Get-OVServer -Name "Encl1, bay 1"
Update-OVServerFirmware -InputObject $server -Baseline $baseline -FirmwareInstallationPolicy NotEqualToBaseline
Updates or downgrades components so that every component version exactly matches the baseline.

​
Update a server profile’s firmware baseline

$baseline = Get-OVBaseline -SppName "HPE Service Pack for ProLiant" -Version "2023.11.01"
$profile = Get-OVServerProfile -Name "Web-Server-01"
Update-OVServerFirmware -InputObject $profile -Baseline $baseline -FirmwareInstallMode FirmwareAndSoftware -Async | Wait-OVTaskComplete
Updates the firmware baseline reference in a server profile and triggers the firmware update.

​
Output

HPEOneView.Appliance.TaskResource A task resource is returned representing the firmware update operation. When -Async is not specified, the cmdlet blocks until the task completes. Component-level compliance details returned before the update:
PropertyDescription
componentNameName of the firmware component
installedVersionCurrently installed version
baselineVersionVersion in the specified baseline
operationUpdate, Downgrade, or NoUpdate

Build docs developers (and LLMs) love

Get started for freeTalk to us