Update-OVServerFirmware
Syntax
Update-OVServerFirmware
[-InputObject] <Object>
[-Baseline] <Object>
[-PatchLevel <System.Version>]
[-FirmwareInstallationPolicy <String>]
[-FirmwareInstallMode <String>]
[-ReinstallFirmware]
[-PreviewOnly]
[-Async]
[-ApplianceConnection <Object>]
[<CommonParameters>]
Description
A firmware bundle is a comprehensive collection of firmware and system software components that enable you to update the firmware of the devices managed by the appliance. The firmware bundle includes drivers, agents, utilities, and firmware packages. Deploying a firmware bundle (SPP) to a server hardware resource is only supported with Gen10 or newer server platforms, excluding HPE Synergy and Superdome Flex partitions.
Supported servers must not have an assigned server profile, and only supports Gen10 and newer volume servers (not HPE Synergy). Installing a supported firmware bundle requires either an HPE iLO Advanced, HPE OneView Advanced or HPE OneView Advanced without iLO Advanced license.
The following installation modes are supported:
- FirmwareAndOSDrivers or FirmwareAndSoftware - Updates the firmware and OS drivers without powering down the server hardware using Smart Update Tool.
- FirmwareOnly - Updates the firmware without powering down the server hardware using Smart Update Tool.
- FirmwareOnlyOfflineMode or FirmwareOffline - Manages the firmware through HPE OneView. Selecting this option requires the server hardware to be powered down.
Info
Minimum required privileges: Infrastructure administrator or Server administrator or Server firmware operator
Examples
Example 1
Generate a report of installed components to the server and available firmware within the specified baseline.
Example 2
$Servers = Get-OVServer | ? generation -eq "Gen10"
$Baseline = Get-OVBaseline -Name "Custom Baseline 2022 11 4"
Update-OVServerFirmware -InputObject $Servers -Baseline $Baseline
Get a collection of Gen10 servers and install the specific baseline.
Example 3
# Get the latest firmware bundles from HPE
$FirmwareBundleUpdates = Get-OVFirmwareBundleUpdate -GetLatestUpdates
# Get all of the HPE ProLiant DL380 Gen11 servers from inventory
$Servers = Get-OVServer -Query "shortModel:'DL380 Gen11'"
# Use the most current
$Baseline = $FirmwareBundleUpdates | ? bundleGeneration -contains "Gen11" | Sort -Property version -Descending | Select -First 1
# If there is a patch available, use the most recent version
if ($Baseline.Supplements.Count -gt 0) {
$Servers | Update-OVServerFirmware -Baseline $Baseline -PatchLevel ($Baseline.Supplements | Sort -Descending | Select -First 1)
} else {
$Servers | Update-OVServerFirmware -Baseline $Baseline
}
Get the most current firmware bundle available for Gen11, and use the most current patch level if available.
Parameters
-ApplianceConnection <Object>
Specify one or more [HPEOneView.Appliance.Connection] object(s) or Name property value(s).
Default Value: ${Global:ConnectedSessions} | ? Default
| Aliases | Appliance |
|---|---|
| Required? | False |
| Position? | Named |
| Default value | (${Global:ConnectedSessions} | ? Default) |
| Accept pipeline input? | false |
| Accept wildcard characters? | False |
-Baseline <Object>
Baseline object from Get-OVBaseline.
Examples:
$FileName = "bp-hp-service-pack-for-proliant-oneview-2014-11-30-05.iso" $Name = "HPE Service Pack For ProLiant OneView 2014 11 13"
| Aliases | None |
|---|---|
| Required? | False |
| Position? | Named |
| Default value | |
| Accept pipeline input? | false |
| Accept wildcard characters? | False |
-FirmwareInstallationPolicy <String>
Select the installation policy for the firmware bundle. Allowed values:
- LowerThanBaseline (Default) - Updates only the components with an installed version lower than the firmware baseline version.
- NotEqualToBaseline - Updates or downgrades components whose installed version does not match the firmware baseline version.
| Aliases | None |
|---|---|
| Required? | False |
| Position? | Named |
| Default value | |
| Accept pipeline input? | false |
| Accept wildcard characters? | False |
-InputObject <Object>
Server hardware resource from Get-OVServer.
| Aliases | Server, ServerHardware |
|---|---|
| Required? | False |
| Position? | Named |
| Default value | |
| Accept pipeline input? | true (ByValue) |
| Accept wildcard characters? | False |
-ReinstallFirmware <SwitchParameter>
Option to reinstall the components that already match the firmware baseline.
| Aliases | ForceInstallFirmware |
|---|---|
| Required? | False |
| Position? | Named |
| Default value | |
| Accept pipeline input? | false |
| Accept wildcard characters? | False |
-FirmwareInstallMode <String>
Specify the Firmware Baseline Policy mode. Avialable options are:
- FirmwareOnly - Updates the system firmware without powering down the server hardware using using HPE Smart Update Tools.
- FirmwareAndSoftware - Updates the firmware and OS drivers without powering down the server hardware using HPE Smart Update Tools.
- FirmwareOffline - Manages the firmware through HPE OneView. Selecting this option requires the server hardware to be powered down.
| Aliases | FirmwareMode |
|---|---|
| Required? | False |
| Position? | Named |
| Default value | FirmwareAndSoftware |
| Accept pipeline input? | false |
| Accept wildcard characters? | False |
-Async <SwitchParameter>
Use this parameter to immediately return the async task. By default, the Cmdlet will wait for the task to complete.
| Aliases | None |
|---|---|
| Required? | False |
| Position? | Named |
| Default value | False |
| Accept pipeline input? | false |
| Accept wildcard characters? | False |
-PatchLevel <System.Version>
The patch or supplement to the Update Bundle. Within the Update Bundle contains a property called Supplements ([Array] of [System.Version]).
| Aliases | None |
|---|---|
| Required? | False |
| Position? | Named |
| Default value | |
| Accept pipeline input? | false |
| Accept wildcard characters? | False |
-PreviewOnly <SwitchParameter>
Will generate a compliance review object that contains which components are not compliant with the parent template policy.
| 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
Server hardware resource from Get-OVServer.
Return Values
A collection of server firmware installation report. Will contain identified installed components and which have available updates from the supplied baseline.
Async task resource to monitor.