Skip to content

Restart-OVServer

Syntax

Restart-OVServer
    [-Server] <Object>
    [-Async]
    [-ApplianceConnection] <Object>
    [<CommonParameters>]

Restart-OVServer
    [-Server] <Object>
    [-ColdBoot]
    [-Async]
    [-ApplianceConnection] <Object>
    [<CommonParameters>]

Description

Restart the power state of the server using the virtual power button. By default, the Cmdlet will request a "Reset" request to initiate a server to restart. Using the ColdBoot will take away and present power back to the server resource.

Examples

Example 1

Get-OVServer -Name "Encl1, Bay 1" | Restart-OVServer | Wait-OVTaskComplete

Restart the specific server device by passing the Server Object via pipeline.

Example 2

Get-OVServerProfile -Name "MyWebServer 1" | Restart-OVServer | Wait-OVTaskComplete

Restart the specific server device by passing the Server Profile Object via pipeline.

Example 3

Get-OVServer -Name "Encl1, Bay 1" | Restart-OVServer -ColdBoot | Wait-OVTaskComplete

Restart the specific server device by passing the Server Object via pipeline, and issue a cold boot request.

Parameters

-Server <Object>

A Server hardware or Server Profile resource object.

Aliases None
Required? True
Position? Named
Default value
Accept pipeline input? true (ByValue)
Accept wildcard characters? False

-ColdBoot <SwitchParameter>

Use this parameter to request power be forcably removed then represented to the server resource.

Aliases None
Required? False
Position? Named
Default value False
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

-ApplianceConnection <Object>

Specify one [HPEOneView.Appliance.Connection] object or Name property value. If Resource object is provided via Pipeline, the ApplianceConnection property of the object will be used.

Aliases Appliance
Required? True
Position? Named
Default value (${Global:ConnectedSessions} | ? Default)
Accept pipeline input? true (ByPropertyName)
Accept wildcard characters? False

-WhatIf <SwitchParameter>

Aliases wi
Required? False
Position? Named
Default value
Accept pipeline input? false
Accept wildcard characters? False

-Confirm <SwitchParameter>

Aliases cf
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

Server Profile Resource

Return Values

Async task that tracks the power state change

Multiple Async tasks