NAME

Set-HPOVServerPower

SYNOPSIS

Set the power state of a server.

SYNTAX

Set-HPOVServerPower [-serverUri] <String> [[-powerState] <String>] [[-powerControl] <String>] [<CommonParameters>]

DESCRIPTION

Set the power state of the server using the virtual power button.

PARAMETERS

-serverUri <String>
The ID for the server.
Aliases none  
Required? True
Position? 2
Default value <none>            
Accept pipeline input? false
Accept wildcard characters?     false
-powerState <String>
Optional power state.  Default is ON, other option is OFF.
Aliases none                
Required? false
Position? 2
Default value On                
Accept pipeline input? false
Accept wildcard characters?     false
-powerControl <String>

Optional setting to control the virtual power button. Default is PressAndHold, other options are MomentaryPress, ColdBoot and Reset

Current State powerState powerControl Result
On On MomentaryPress Exception: cannot achieve desired power state via the specified power control
On On PressAndHold Exception: cannot achieve desired power state via the specified power control
On On ColdBoot OK
On On Reset OK
On Off MomentaryPress OK (just have to assume that there’s an OS on the server and it will power off the server someday…)
On Off PressAndHold OK
On Off ColdBoot Exception: cannot achieve desired power state via the specified power control
On Off Reset Exception: cannot achieve desired power state via the specified power control
Off On MomentaryPress OK
Off On PressAndHold Exception: cannot achieve desired power state via the specified power control
Off On ColdBoot Exception: cannot achieve desired power state via the specified power control
Off On Reset Exception: cannot achieve desired power state via the specified power control
Off Off MomentaryPress Exception: cannot achieve desired power state via the specified power control
Off Off PressAndHold Exception: cannot achieve desired power state via the specified power control
Off Off ColdBoot Exception: cannot achieve desired power state via the specified power control
Off Off Reset Exception: cannot achieve desired power state via the specified power control

Aliases none  
Required? false
Position? 2
Default value PressAndHold   
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).

INPUTS

None.

OUTPUTS

System.Management.Automation.PSCustomObject

Task that tracks the power state change.

RELATED LINKS


EXAMPLES

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

PS C:\> Set-HPOVServerPower -serverUri $pro.configuration.assignedToServerUri -powerState ON -powerControl MomentaryPress
Power on the specific server hardware by using the Server Profiles assignedToServerUri property.

Last edited Feb 26, 2014 at 10:00 PM by ChrisLynchHP, version 2