Skip to main content

Import-LXCOFirmwarePackage

Use this cmdlet to import one or more update packages. For ThinkSystem V3 servers, you can import only one update package at a time.

When you manually import updates, you must import the required files base on the resource type.

  • For ThinkSystem V3 servers, import the single update package (*.zip). This zip file contains the payload, metadata files (several *.json files), change log file (*.chg) and readme file (*.txt).

  • For ThinkEdge Client devices, import the payload (Windows .exe). The readme (.txt) is optional. Note that only the BIOS flash utility package for Windows update is currently supported.

  • For XClarity Management Hub, andXClarity Management Hub 2.0, import the single update-package file (.tgz). This file contains the payload, metadata, change history, and readme files.

  • For all other resources (including XClarity Administrator, ThinkEdge servers, ThinkSystem V1 and V2, and legacy devices), import the payload (.zip, .uxz, .tar.gz, .tar, .bin), metadata (.xml), change log (.chg) and readme (.txt).

Note
You cannot pipe objects to this cmdlet.

Syntax​

Import-LXCOFirmwarePackage [-Connection LXCOConnection]
                            -Files String[]
                           [CommonParameter]

Import-LXCOFirmwarePackage [-Connection LXCOConnection]
                            -PayloadFiles String[]
                            [CommonParameter]

Import-LXCOFirmwarePackage [-Connection LXCOConnection]
                            -FixIDs String[]
                            -Folder String
                            [CommonParameter]

Parameters​

-Connection LXCOConnection
Specifies the connection to the Lenovo XClarity Orchestrator server. If no connection is specified, the result from the last Connect-LXCO cmdlet is used.
-Files String[]
Specifies a list of files that represents one or more firmware-update packages to upload.

Use this parameter to import update packages for ThinkSystem V1, V2, ThinkEdge servers and some legacy devices, repository packs, and XClarity Administrator.

For each update package, you must specify the four required files: payload (.zip, .uxz, .tar.gz, .tar, .bin, .tgz), metadata (.xml), change log (.chg) and readme (.txt).

-PayloadFiles String[]
Specifies a list of single update-package file.

Use this parameter for ThinkSystem V1 servers (*.zip), ThinkEdge client devices (.exe), XClarity Management Hub, andXClarity Management Hub 2.0,

Note
For ThinkSystem V3 servers, specify only one file. If multiple files are specified, only the first file is imported.
-FixIDs String[]
Specifies a list of patterns to match update packages that are stored in folder.
Note
All types of packages can be specified - single update-package type and 4 file package type, with following limitations.

  • If 4 files package files are used, single update package is not accepted

  • If single update package is used, only one is accepted and 4 files packages should not be present.

-Folder String
Specifies the location where the update packages are to be stored.
CommonParameters
This cmdlet supports the following common parameters: -Verbose, -Debug, -ErrorAction, -ErrorVariable, -WarningAction, -WarningVariable, -OutBuffer, -PipelineVariable, -OutVariable. For detailed information about each common parameter, see the Microsoft PowerShell Common Parameters webpage.

Results​

Examples​

The following example uploads a firmware package using a list of files.
$cred = Get-Credential
Connect-LXCO -HostUri 192.0.2.0 -Credential $cred -SkipCertificateCheck

$files = @(
   "D:\FirmwareRepository\oem_fw_dsa_dsaoa6s-10.1_anyos_32-64.txt",
   "D:\FirmwareRepository\oem_fw_dsa_dsaoa6s-10.1_anyos_32-64.uxz",
   "D:\FirmwareRepository\oem_fw_dsa_dsaoa6s-10.1_anyos_32-64.xml1",
   "D:\FirmwareRepository\oem_fw_dsa_dsaoa6s-10.1_anyos_anycpu.chg"
)

$result = Import-LXCOFirmwarePackage -Files $files
$result

Disconnect-LXCO
The following example uploads two firmware packages from a folder.
$cred = Get-Credential
Connect-LXCO -HostUri 192.0.2.0 -Credential $cred -SkipCertificateCheck

$fixIDs_two = @(
   "lnvgy_fw_xcc_tei3c4m-5.00_anyos_noarch",
   "lnvgy_utl_uxsp_elsp17p-1.00_windows_32-64"
)

$result = Import-LXCOFirmwarePackage -Folder D:\FirmwareRepository\ -FixIDs $fixIDs
$result

Disconnect-LXCO
The following example attempts to upload multiple ThinkSystem V3 firmware packages. Because only one firmware package can be updated at a time, only the first specified file is imported. The remaining two are reported as not imported.
$cred = Get-Credential
Connect-LXCO -HostUri 192.0.2.0 -Credential $cred -SkipCertificateCheck

$files = @(
           "D:\FirmwareRepository\lnvgy_fw_xcc_kax325a-2.40_anyos_comp.zip",
           "D:\FirmwareRepository\lnvgy_fw_uefi_kae117a-4.10_anyos_comp.zip",
           "D:\FirmwareRepository\lnvgy_fw_uefi_ese113v-2.10_anyos_comp.zip"
           )

$result = Import-LXCOFirmwarePackage -PayloadFiles $files

$result

Disconnect-LXCO
The following warning message is returned.
WARNING: Only one single update-package file is accepted. The following  update-packages were not imported into XClarity Orchestrator. D:\FirmwareRepository\lnvgy_fw_uefi_kae117a-4.10_anyos_comp.zip D:\FirmwareRepository\lnvgy_fw_uefi_ese113v-2.10_anyos_comp.zip