Update-StorageFirmware

Module:

Storage

Updates the firmware on a storage device.

Syntax

Update-StorageFirmware
      [-FriendlyName] <String>
      [-ImagePath <String>]
      [-SlotNumber <UInt16>]
      [-CimSession <CimSession>]
      [-ThrottleLimit <Int32>]
      [-AsJob]
      [<CommonParameters>]

Update-StorageFirmware
      -UniqueId <String>
      [-ImagePath <String>]
      [-SlotNumber <UInt16>]
      [-CimSession <CimSession>]
      [-ThrottleLimit <Int32>]
      [-AsJob]
      [<CommonParameters>]

Update-StorageFirmware
      -InputObject <CimInstance[]>
      [-ImagePath <String>]
      [-SlotNumber <UInt16>]
      [-CimSession <CimSession>]
      [-ThrottleLimit <Int32>]
      [-AsJob]
      [<CommonParameters>]

Description

The Update-StorageFirmware cmdlet updates the firmware on a storage device with the specified firmware image.

You can also use Update-StorageFirmware to load firmware that is already on the device but in a non-active slot. The update operation consists of a download step and an activation step that are both performed by this cmdlet.

Examples

Example 1: Update a physical disk

PS C:\>Get-PhysicalDisk -FriendlyName "PhysicalDisk0" | Update-StorageFirmware -ImagePath "C:\Users\Contoso\Desktop\Image.bin" -SlotNumber 0

This command uses the Get-PhysicalDisk cmdlet to get a physical disk, and then uses the pipeline operator to pass the disk to Update-StorageFirmware, which updates the physical disk with the firmware in Image.bin.

Example 2: Activate a firmware image in a different slot

PS C:\>Get-PhysicalDisk -FriendlyName "PhysicalDisk1" | Update-StorageFirmware -SlotNumber 2

This command uses the Get-PhysicalDisk cmdlet to get a physical disk, and then uses the pipeline operator to pass the disk to Update-StorageFirmware, which activates the firmware in slot 2.

Parameters

-AsJob

Runs the cmdlet as a background job. Use this parameter to run commands that take a long time to complete.

Type:	SwitchParameter
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-CimSession

Type:	CimSession
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-FriendlyName

Type:	String
Position:	0
Default value:	None
Required:	True
Accept pipeline input:	True
Accept wildcard characters:	False

-ImagePath

Type:	String
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-InputObject

Specifies the input object that is used in a pipeline command.

Type:	CimInstance[]
Position:	Named
Default value:	None
Required:	True
Accept pipeline input:	True
Accept wildcard characters:	False

-SlotNumber

Type:	UInt16
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-ThrottleLimit

Type:	Int32
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-UniqueId

Specifies an array of IDs, as strings.

Type:	String
Aliases:	Id
Position:	Named
Default value:	None
Required:	True
Accept pipeline input:	True
Accept wildcard characters:	False

Outputs

String

This cmdlet returns extended status error information as a String from the storage provider.

Notes

• This cmdlet currently operates on physical disks only.
• When used in Failover Cluster, cmdlets from the Storage module operate on cluster level (all servers in the cluster).

Related Links

• Get-StorageFirmwareInformation