Update-StorageFirmware

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