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

Restarts a server hardware resource managed by HPE OneView.

​
Syntax

Graceful restart (default) 
Restart-OVServer
    [-Server] <Object>
    [-Async]
    [-ApplianceConnection <Object>]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]
Cold boot 
Restart-OVServer
    [-Server] <Object>
    -ColdBoot
    [-Async]
    [-ApplianceConnection <Object>]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

​
Description

Restart-OVServer initiates a restart of the specified server hardware. By default, it sends a graceful reset signal via the iLO (equivalent to pressing the reset button). Use -ColdBoot to perform a full power cycle: the server is powered off and then back on. The server must be powered on to restart. If the server is already off, use Start-OVServer instead. The cmdlet accepts server hardware objects or server profile objects from the pipeline.
Using -ColdBoot immediately cuts power to the server without a graceful OS shutdown. This can result in data loss or file system corruption if the operating system is running.

​
Parameters

​
Server
Object
required
The server hardware or server profile object to restart. Accepts pipeline input.
​
ColdBoot
Switch
Perform a cold boot (full power cycle) instead of a graceful reset. This parameter is mandatory for the ColdBoot parameter set.
​
Async
Switch
Return the async task object immediately without waiting for the operation to complete.
​
ApplianceConnection
Object
The appliance connection object or name. Defaults to the default connected session. Accepted from the pipeline by property name.
​
Confirm
Switch
Prompts for confirmation before restarting the server.

​
Examples

​
Graceful restart

$server = Get-OVServer -Name "Encl1, bay 3"
Restart-OVServer -Server $server
Sends a graceful reset to Encl1, bay 3 and waits for the task to complete.

​
Restart using the pipeline

Get-OVServer -Name "Encl1, bay 3" | Restart-OVServer
Pipes the server object directly to Restart-OVServer.

​
Cold boot a server

$server = Get-OVServer -Name "Encl1, bay 3"
Restart-OVServer -Server $server -ColdBoot
Performs a full power cycle. Power is cut immediately and then restored.

​
Asynchronous restart

$task = Get-OVServer -Name "Encl1, bay 3" | Restart-OVServer -Async
$task | Wait-OVTaskComplete
Submits the restart as an async task and then waits for it to complete.

​
Output

HPEOneView.Appliance.TaskResource Returns an async task resource for the restart operation.