Get-StorageFirmwareInformation
Gets information about firmware on a storage object.
Syntax
Get-StorageFirmwareInformation
[-FriendlyName] <String>
[-CimSession <CimSession>]
[-ThrottleLimit <Int32>]
[-AsJob]
[<CommonParameters>] Get-StorageFirmwareInformation
-UniqueId <String>
[-CimSession <CimSession>]
[-ThrottleLimit <Int32>]
[-AsJob]
[<CommonParameters>] Get-StorageFirmwareInformation
-InputObject <CimInstance[]>
[-CimSession <CimSession>]
[-ThrottleLimit <Int32>]
[-AsJob]
[<CommonParameters>] Description
The Get-StorageFirmwareInformation cmdlet gets information about firmware on storage objects. On Non-Volatile Memory Express (NVMe) devices, it lists the number of firmware slots, the active firmware image, and slots that are writeable.
Examples
Example 1: Get firmware information for physical disks
PS C:\>Get-PhysicalDisk | Get-StorageFirmwareInformationThis command uses the Get-PhysicalDisk cmdlet to get all physical disks in the system, and uses the pipeline operator to pass them to Get-StorageFirmwareInformation to get the firmware information for each disk.
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 |
-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 |
-ThrottleLimit
| Type: | Int32 |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-UniqueId
Specifies an ID used to uniquely identify a Disk object in the system. The ID persists through restarts.
| Type: | String |
| Aliases: | Id |
| Position: | Named |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
Outputs
Boolean, UInt8, UInt8[], Boolean[], String[], String
This cmdlet returns the following firmware information for a storage object:
- SupportsUpdate. Indicates whether the device is capable of a Windows-compliant firmware update process.
- NumberOfSlots. The number of firmware slots the device has.
- ActiveSlotId. Identifies the slot id that corresponds to the slot containing the currently active firmware image.
- SlotId[] - Array listing all slot IDs.
- IsSlotWritable[]. Indicates if a firmware image can be downloaded to the slot represented by the ID in the SlotId[] array at the corresponding index.
- FirmwareVersionInSlot[]. Array showing the firmware revision in each slot.
- Extended Status. Error information from the storage provider.
Notes
- This cmdlet is currently limited to use on PhysicalDisk objects.
- When used in Failover Cluster, cmdlets from the Storage module operate on cluster level (all servers in the cluster).