Restart HPOVServer - HewlettPackard/POSH-HPEOneView GitHub Wiki

HPE OneView 4.10 Library

Restart-HPOVServer

Restart Server Resource.

SYNTAX

Restart-HPOVServer [-Server] <Object>[ [-Async] <SwitchParameter>] [-ApplianceConnection] <Object>[ [-WhatIf] <SwitchParameter>][ [-Confirm] <SwitchParameter>] [<CommonParameters>]

Restart-HPOVServer [-Server] <Object>[ [-ColdBoot] <SwitchParameter>][ [-Async] <SwitchParameter>] [-ApplianceConnection] <Object>[ [-WhatIf] <SwitchParameter>][ [-Confirm] <SwitchParameter>] [<CommonParameters>]

Detailed 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.

Parameters

-ApplianceConnection <Object>

Aliases [-Appliance]

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

Default Value: ${Global:ConnectedSessions} | ? Default

Aliases	Appliance
Required?	true
Position?	named
Default value	(${Global:ConnectedSessions} \| ? Default)
Accept pipeline input?	true (ByPropertyName)
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

-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

-Confirm <SwitchParameter>

Aliases	cf
Required?	false
Position?	named
Default value
Accept pipeline input?	false
Accept wildcard characters?	False

-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

-WhatIf <SwitchParameter>

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

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

HPOneView.ServerHardware [System.Management.Automation.PSCustomObject]

Server Hardware Resource

HPOneView.ServerProfile [System.Management.Automation.PSCustomObject]

Server Profile Resource

Return Values

HPOneView.Appliance.TaskResource [System.Management.Automation.PSCustomObject]

Async task that tracks the power state change

System.Collections.ArrayList <HPOneView.Appliance.TaskResource>

Multiple Async tasks

Examples

-------------------------- EXAMPLE 1 --------------------------

Get-HPOVServer "Encl1, Bay 1" | Restart-HPOVServer | Wait-HPOVTaskComplete

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

-------------------------- EXAMPLE 2 --------------------------

Get-HPOVServerProfile "MyWebServer 1" | Restart-HPOVServer | Wait-HPOVTaskComplete

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

-------------------------- EXAMPLE 3 --------------------------

Get-HPOVServer "Encl1, Bay 1" | Restart-HPOVServer -ColdBoot | Wait-HPOVTaskComplete

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

HPE OneView 4.00 Library