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

Updates server profiles to match their associated server profile template (remediation), reapplies specific categories of settings, or refreshes a profile’s state from the hardware.

​
Syntax

​
Remediate from template (Default)

Update-OVServerProfile
    [-InputObject] <Object>
    [-Stage]
    [-ApplianceConnection <Object>]
    [-Async]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

​
Refresh profile state from hardware

Update-OVServerProfile
    [-InputObject] <Object>
    -Refresh
    [-ApplianceConnection <Object>]
    [-Async]
    [<CommonParameters>]

​
Reapply specific setting categories

Update-OVServerProfile
    [-InputObject] <Object>
    -Reapply
    [-Baseline]
    [-AdapterAndBoot]
    [-Connections]
    [-LocalStorage]
    [-SANStorage]
    [-BIOS]
    [-Ilo]
    [-OSDeployment]
    [-ApplianceConnection <Object>]
    [-Async]
    [<CommonParameters>]

​
Description

Update-OVServerProfile provides three distinct operations, controlled by parameter sets: Default (remediate): Applies changes from the template to bring the profile back into compliance. Use this after modifying a server profile template to push updated settings to all derived profiles. The -Stage switch stages the update without applying it immediately. Refresh: Forces HPE OneView to re-read the server’s current hardware state and refresh the profile’s reported status. Reapply: Re-pushes specific categories of profile settings to the server without requiring the profile to be non-compliant. Useful for recovering settings that have drifted on the server itself. Select one or more category switches: -Baseline, -AdapterAndBoot, -Connections, -LocalStorage, -SANStorage, -BIOS, -Ilo, -OSDeployment.
Remediation (Default parameter set) requires the server to be powered off, or will power off the server if needed, depending on the settings being applied. Plan remediation windows accordingly.

​
Parameters

​
InputObject
object
required
The server profile object to update, as returned by Get-OVServerProfile. Accepts pipeline input. Aliases: profile, ServerProfile.
​
Refresh
switch
Refresh the profile’s state by reading current hardware configuration from the server. Mutually exclusive with -Reapply.
​
Reapply
switch
Reapply specific setting categories to the server. Must be combined with at least one category switch. Mutually exclusive with -Refresh.
​
Baseline
switch
Reapply the firmware baseline. Valid only with -Reapply.
​
AdapterAndBoot
switch
Reapply adapter and boot settings. Valid only with -Reapply.
​
Connections
switch
Reapply network connection settings. Valid only with -Reapply.
​
LocalStorage
switch
Reapply local storage settings. Valid only with -Reapply.
​
SANStorage
switch
Reapply SAN storage settings. Valid only with -Reapply.
​
BIOS
switch
Reapply BIOS settings. Valid only with -Reapply.
​
Ilo
switch
Reapply iLO settings. Valid only with -Reapply.
​
OSDeployment
switch
Reapply OS deployment settings. Valid only with -Reapply.
​
Stage
switch
Stage the template update without applying it to the server immediately. Valid only with the Default parameter set.
​
Async
switch
Return a task object immediately without waiting for the operation to complete.
​
ApplianceConnection
object
Specifies the HPE OneView appliance connection. Defaults to the default connected session. Alias: Appliance.

​
Examples

​
Find and remediate all non-compliant profiles

# Identify non-compliant profiles
$nonCompliant = Get-OVServerProfile -NonCompliant
Write-Host "$($nonCompliant.Count) non-compliant profile(s) found."

# Remediate each profile
$nonCompliant | Update-OVServerProfile -Confirm:$false | Wait-OVTaskComplete

​
Remediate a specific profile

Get-OVServerProfile -Name 'Hyp-Clus-01' | Update-OVServerProfile
Prompts for confirmation, then applies the template to bring Hyp-Clus-01 back into compliance.

​
Refresh a profile’s state from hardware

Get-OVServerProfile -Name 'Web-Node-01' | Update-OVServerProfile -Refresh | Wait-OVTaskComplete

​
Reapply firmware and BIOS settings

Get-OVServerProfile -Name 'DB-Node-01' |
    Update-OVServerProfile -Reapply -Baseline -BIOS -Confirm:$false | Wait-OVTaskComplete
Reapplies only the firmware baseline and BIOS settings to DB-Node-01, leaving all other settings unchanged.

​
Stage a template update without immediate application

Get-OVServerProfile -Name 'Hyp-Clus-01' | Update-OVServerProfile -Stage -Async
Stages the pending template changes so they can be applied during the next maintenance window.

​
Output

HPEOneView.Appliance.TaskResource — An async task object tracking the update operation.