Update-Storage Firmware

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.

Required Parameters

-FriendlyName
Type: String
Position: 0
Default value: None
Accept pipeline input: True (ByValue)
Accept wildcard characters: False
-InputObject

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

Type: CimInstance[]
Position: Named
Default value: None
Accept pipeline input: True (ByValue)
Accept wildcard characters: False
-UniqueId

Specifies an array of IDs, as strings.

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

Optional 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
Accept pipeline input: False
Accept wildcard characters: False
-CimSession
Type: CimSession
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-ImagePath
Type: String
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-SlotNumber
Type: UInt16
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-ThrottleLimit
Type: Int32
Position: Named
Default value: None
Accept pipeline input: False
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.