Start-HcsFirmwareCheck

Start-HcsFirmwareCheck

Checks whether a device needs a firmware update.

Syntax

Parameter Set: Default
Start-HcsFirmwareCheck [-ClearUSMUpgradeCheck] [-Force] [-Confirm] [-WhatIf] [ <CommonParameters>]

Detailed Description

The Start-HcsFirmwareCheck cmdlet checks whether a device needs a firmware update. The cmdlet automatically updates any firmware that it can update to the latest known firmware. This cmdlet lists all firmware that it cannot update. Contact Microsoft Customer Service and Support about any firmware that this cmdlet cannot update.

This cmdlet runs automatically as a scheduled task on the active controller once a day, but you can also run the cmdlet on an as-needed basis.

Parameters

-ClearUSMUpgradeCheck

-Force

Forces the command to run without asking for user confirmation.

-Confirm

Prompts you for confirmation before running the cmdlet.

-WhatIf

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

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

• Microsoft.HCS.Management.Patching.HcsFirmwareCheckResult

  The HcsFirmwareCheckResult object has the following properties:

  -- FirmwareStaus FirmwareStatus
  -- IEnumerable<String> MismatchComponents

  The FirmwareStaus enumeration has the following values:

  -- UpToDate
  -- SupportRequired
  -- MaintenanceModeUpdateRequired
  -- UpdateStarted
  -- UpdateRequired

Examples

Example 1: Start a firmware check

This command checks the firmware version of a device. The firmware on this device is up to date.

PS C:\> Start-HcsFirmwareCheck

Example 2: Update firmware

This command checks the firmware version of a device. The firmware on this device is not up to date. This command does not specify the Force parameter, and, therefore, the cmdlet prompts you for confirmation before it updates the firmware.

PS C:\> Start-HcsFirmwareCheck

Example 3: Check for firmware updates that require support

This command checks the firmware version of a device. The firmware on this device is not up to date. The cmdlet cannot update some firmware for this device. Contact Customer Service and Support in order to update this item.

PS C:\> Start-HcsFirmwareCheck

Related topics

Get-HcsFirmwareVersion