Skip to content

Stop-OVServer

Syntax

Stop-OVServer
    [-InputObject] <Object>
    [-Async]
    [-ApplianceConnection] <Object>
    [<CommonParameters>]

Stop-OVServer
    [-InputObject] <Object>
    [-Force]
    [-Async]
    [-ApplianceConnection] <Object>
    [<CommonParameters>]

Description

Stop the power state of the server using the virtual power button. By default, the Cmdlet will request a "Momentary Press" request to initiate a server to shutdown.

Examples

Example 1

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

Power off the specific server device by passing the Server Object via pipeline.

Example 2

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

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

Example 3

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

Power off the specific server device by passing the Server Object via pipeline, and forcably power off.

Parameters

-InputObject <Object>

A Server hardware or Server Profile resource object.

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

-Force <SwitchParameter>

Use this parameter to request the "Press and Hold" virtual power button method, which will forcable power off a server without a graceful shutdown.

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