Start-HcsUpdate

Start-HcsUpdate

Installs updates.

Syntax

Parameter Set: Default
Start-HcsUpdate [-Force] [-UpdateId <String> ] [-Confirm] [-WhatIf] [ <CommonParameters>]

Detailed Description

The Start-HcsUpdate cmdlet installs updates on a device. If the device is in maintenance mode, the cmdlet installs only disruptive updates. If the device is not in maintenance mode, the cmdlet installs only normal updates.

For updates that do not require maintenance mode, this cmdlet installs the update on both controllers.

For all updates that require maintenance mode, run this cmdlet on each controller. If you do not to run this cmdlet on each controller, data may become corrupted.

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

-UpdateId<String>

Specifies an update ID. The cmdlet installs the particular update specified by the ID.

Aliases

none

Required?

false

Position?

named

Default Value

none

Accept Pipeline Input?

false

Accept Wildcard Characters?

false

-Confirm

Prompts you for confirmation before running the cmdlet.

Required?

false

Position?

named

Default Value

false

Accept Pipeline Input?

false

Accept Wildcard Characters?

false

-WhatIf

Shows what would happen if the cmdlet runs. The cmdlet is not run.

Required?

false

Position?

named

Default Value

false

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.

  • Boolean

    This cmdlet generates a value of $True if it starts installing an update or a value of $False if there are no updates available.

Examples

Example 1: Install updates

This command installs available updates.

PS C:\> Start-HcsUpdate

Get-HcsUpdateAvailability

Get-HcsUpdateStatus

Start-HcsHotfix