< Back
Update-iBMCInbandFirmware
Post
NAME Update-iBMCInbandFirmware
SYNOPSIS
Updata iBMC Inband firmware.
SYNTAX
Update-iBMCInbandFirmware [-Session] <RedfishSession[]> -Type <String[]> -FileUri <String[]> [-SignalFileUri
<String[]>] [-UpgradeMode {Auto | Full | Recover | APP | Driver}] [<CommonParameters>]
DESCRIPTION
Updata iBMC Inband firmware. This function transfers firmware to SP service.
Those transfered firmwares takes effect upon next system restart when SP Service start is enabled
(Set-iBMCSPService function is provided for this).
Tips: Only V5 servers used with BIOS version later than 0.39 support this function.
PARAMETERS
-Session <RedfishSession[]>
iBMC redfish session object which is created by Connect-iBMC cmdlet.
A session object identifies an iBMC server to which this cmdlet will be executed.
Required? true
Position? 1
Default value
Accept pipeline input? true (ByValue, ByPropertyName)
Accept wildcard characters? false
-Type <String[]>
Indicates the firmware type to be updated.
Support value set: "Firmware", "SP".
- Firmware: NIC, Raid
- SP: Smart Provisioning Service
Required? true
Position? named
Default value
Accept pipeline input? true (ByValue, ByPropertyName)
Accept wildcard characters? false
-FileUri <String[]>
Indicates the file uri of firmware update image file.
- When "Type" is Firmware:
The firmware upgrade file is in .zip format.
It supports HTTPS, SFTP, NFS, CIFS, SCP file transfer protocols.
The URI cannot contain the following special characters: ||, ;, &&, $, |, >>, >, <
For examples:
- remote path: protocol://username:password@hostname/directory/Firmware.zip
- When "Type" is SP:
The firmware upgrade file is in .ISO format. support only the CIFS and NFS protocols.
The URI cannot contain the following special characters: ||, ;, &&, $, |, >>, >, <
For examples:
- remote path: nfs://username:password@hostname/directory/Firmware.ISO
Required? true
Position? named
Default value
Accept pipeline input? true (ByValue, ByPropertyName)
Accept wildcard characters? false
-SignalFileUri <String[]>
Indicates the file path of the certificate file of the upgrade file.
It is mandatory when upgrade Firmware while it is redundant when upgrade SP.
- Signal file should be in .asc format
- it supports HTTPS, SFTP, NFS, CIFS, SCP file transfer protocols.
- The URI cannot contain the following special characters: ||, ;, &&, $, |, >>, >, <
For examples:
- remote path: protocol://username:password@hostname/directory/Firmware.zip.asc
Required? false
Position? named
Default value
Accept pipeline input? true (ByValue, ByPropertyName)
Accept wildcard characters? false
-UpgradeMode
Required? false
Position? named
Default value Recover
Accept pipeline input? true (ByValue, ByPropertyName)
Accept wildcard characters? false
<CommonParameters>
This cmdlet supports the common parameters: Verbose, Debug,
ErrorAction, ErrorVariable, WarningAction, WarningVariable,
OutBuffer, PipelineVariable, and OutVariable. For more information, see
about_CommonParameters (https:/go.microsoft.com/fwlink/?LinkID=113216).
INPUTS
OUTPUTS
Null
Returns Null if cmdlet executes successfully.
In case of an error or warning, exception will be returned.
-------------------------- EXAMPLE 1 --------------------------
PS C:\\>$credential = Get-Credential
PS C:\\> $session = Connect-iBMC -Address 10.1.1.2 -Credential $credential -TrustCert
PS C:\\> Update-iBMCInbandFirmware -Session $session -Type Firmware `
-FileUri "nfs://10.10.10.2/data/nfs/NIC(X722)-Electrical-05022FTM-FW(3.33).zip" `
-SignalFileUri "nfs://10.10.10.2/data/nfs/NIC(X722)-Electrical-05022FTM-FW(3.33).zip.asc" `
-UpgradeMode Recover
PS C:\\> Set-iBMCSPService -Session $session -StartEnabled $true -SysRestartDelaySeconds 60
PS C:\\> Set-iBMCServerPower -Session $session -ResetType ForceRestart
This example shows how to update inband firmware with remote file, enabled SP service and restart server
-------------------------- EXAMPLE 2 --------------------------
PS C:\\>$credential = Get-Credential
PS C:\\> $session = Connect-iBMC -Address 10.1.1.2 -Credential $credential -TrustCert
PS C:\\> Update-iBMCInbandFirmware -Session $session -Type SP `
-FileUri "nfs://10.10.10.2/data/nfs/Firmware.ISO" `
-UpgradeMode Recover
This example shows how to update SP with remote file.
RELATED LINKS
https://github.com/Huawei/Huawei-iBMC-Cmdlets
Get-iBMCInbandFirmware
Get-iBMCOutbandFirmware
Update-iBMCOutbandFirmware
Invoke-iBMCFileUpload
Get-iBMCSPTaskResult
Set-iBMCSPService
Connect-iBMC
Disconnect-iBMC
SYNOPSIS
Updata iBMC Inband firmware.
SYNTAX
Update-iBMCInbandFirmware [-Session] <RedfishSession[]> -Type <String[]> -FileUri <String[]> [-SignalFileUri
<String[]>] [-UpgradeMode {Auto | Full | Recover | APP | Driver}] [<CommonParameters>]
DESCRIPTION
Updata iBMC Inband firmware. This function transfers firmware to SP service.
Those transfered firmwares takes effect upon next system restart when SP Service start is enabled
(Set-iBMCSPService function is provided for this).
Tips: Only V5 servers used with BIOS version later than 0.39 support this function.
PARAMETERS
-Session <RedfishSession[]>
iBMC redfish session object which is created by Connect-iBMC cmdlet.
A session object identifies an iBMC server to which this cmdlet will be executed.
Required? true
Position? 1
Default value
Accept pipeline input? true (ByValue, ByPropertyName)
Accept wildcard characters? false
-Type <String[]>
Indicates the firmware type to be updated.
Support value set: "Firmware", "SP".
- Firmware: NIC, Raid
- SP: Smart Provisioning Service
Required? true
Position? named
Default value
Accept pipeline input? true (ByValue, ByPropertyName)
Accept wildcard characters? false
-FileUri <String[]>
Indicates the file uri of firmware update image file.
- When "Type" is Firmware:
The firmware upgrade file is in .zip format.
It supports HTTPS, SFTP, NFS, CIFS, SCP file transfer protocols.
The URI cannot contain the following special characters: ||, ;, &&, $, |, >>, >, <
For examples:
- remote path: protocol://username:password@hostname/directory/Firmware.zip
- When "Type" is SP:
The firmware upgrade file is in .ISO format. support only the CIFS and NFS protocols.
The URI cannot contain the following special characters: ||, ;, &&, $, |, >>, >, <
For examples:
- remote path: nfs://username:password@hostname/directory/Firmware.ISO
Required? true
Position? named
Default value
Accept pipeline input? true (ByValue, ByPropertyName)
Accept wildcard characters? false
-SignalFileUri <String[]>
Indicates the file path of the certificate file of the upgrade file.
It is mandatory when upgrade Firmware while it is redundant when upgrade SP.
- Signal file should be in .asc format
- it supports HTTPS, SFTP, NFS, CIFS, SCP file transfer protocols.
- The URI cannot contain the following special characters: ||, ;, &&, $, |, >>, >, <
For examples:
- remote path: protocol://username:password@hostname/directory/Firmware.zip.asc
Required? false
Position? named
Default value
Accept pipeline input? true (ByValue, ByPropertyName)
Accept wildcard characters? false
-UpgradeMode
Required? false
Position? named
Default value Recover
Accept pipeline input? true (ByValue, ByPropertyName)
Accept wildcard characters? false
<CommonParameters>
This cmdlet supports the common parameters: Verbose, Debug,
ErrorAction, ErrorVariable, WarningAction, WarningVariable,
OutBuffer, PipelineVariable, and OutVariable. For more information, see
about_CommonParameters (https:/go.microsoft.com/fwlink/?LinkID=113216).
INPUTS
OUTPUTS
Null
Returns Null if cmdlet executes successfully.
In case of an error or warning, exception will be returned.
-------------------------- EXAMPLE 1 --------------------------
PS C:\\>$credential = Get-Credential
PS C:\\> $session = Connect-iBMC -Address 10.1.1.2 -Credential $credential -TrustCert
PS C:\\> Update-iBMCInbandFirmware -Session $session -Type Firmware `
-FileUri "nfs://10.10.10.2/data/nfs/NIC(X722)-Electrical-05022FTM-FW(3.33).zip" `
-SignalFileUri "nfs://10.10.10.2/data/nfs/NIC(X722)-Electrical-05022FTM-FW(3.33).zip.asc" `
-UpgradeMode Recover
PS C:\\> Set-iBMCSPService -Session $session -StartEnabled $true -SysRestartDelaySeconds 60
PS C:\\> Set-iBMCServerPower -Session $session -ResetType ForceRestart
This example shows how to update inband firmware with remote file, enabled SP service and restart server
-------------------------- EXAMPLE 2 --------------------------
PS C:\\>$credential = Get-Credential
PS C:\\> $session = Connect-iBMC -Address 10.1.1.2 -Credential $credential -TrustCert
PS C:\\> Update-iBMCInbandFirmware -Session $session -Type SP `
-FileUri "nfs://10.10.10.2/data/nfs/Firmware.ISO" `
-UpgradeMode Recover
This example shows how to update SP with remote file.
RELATED LINKS
https://github.com/Huawei/Huawei-iBMC-Cmdlets
Get-iBMCInbandFirmware
Get-iBMCOutbandFirmware
Update-iBMCOutbandFirmware
Invoke-iBMCFileUpload
Get-iBMCSPTaskResult
Set-iBMCSPService
Connect-iBMC
Disconnect-iBMC