Enter-HcsMaintenanceMode

Enter-HcsMaintenanceMode

Puts a device into maintenance mode.

Syntax

Parameter Set: Default
Enter-HcsMaintenanceMode [-Force] [ <CommonParameters>]

Detailed Description

The Enter-HcsMaintenanceMode cmdlet puts a device into maintenance mode. Putting a device in maintenance mode disrupts its I/Os and severs its connection to the Management Portal. Maintenance mode is primarily for installing updates that require you to disable I/O. Updates to disk firmware require you to disable I/O.

Parameters

-Force

Forces the command to run without asking for user confirmation.

Aliases

none

Required?

false

Position?

named

Default Value

none

Accept Pipeline Input?

false

Accept Wildcard Characters?

false

<CommonParameters>

This cmdlet supports the common parameters: -Verbose, -Debug, -ErrorAction, -ErrorVariable, -OutBuffer, and -OutVariable. For more information, see    about_CommonParameters (https://go.microsoft.com/fwlink/p/?LinkID=113216).

Inputs

The input type is the type of the objects that you can pipe to the cmdlet.

Outputs

The output type is the type of the objects that the cmdlet emits.

  • This cmdlet does not generate any output.

Examples

Example 1: Enter device maintenance mode

This command enters device maintenance mode.

To reconnect, you must start a new Windows PowerShell® session. When you reconnect, maintenance mode information is displayed.

PS C:\> Enter-HcsMaintenanceMode

Exit-HcsMaintenanceMode

Get-HcsFirmwareVersion

Start-HcsFirmwareCheck