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
Aliases |
none |
Required? |
false |
Position? |
named |
Default Value |
none |
Accept Pipeline Input? |
false |
Accept Wildcard Characters? |
false |
-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 |
-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.
Microsoft.HCS.Management.Patching.HcsFirmwareCheckResult
The HcsFirmwareCheckResult object has the following properties:
-- FirmwareStaus FirmwareStatus
-- IEnumerable<String> MismatchComponentsThe 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