Skip to main content

Update-LXCAFirmwareRepository

This cmdlet refreshes the firmware catalog by retrieving information (metadata) about firmware updates and UpdateXpress System Packs (UXSPs) from the Lenovo Support website, or downloads specific firmware updates or UXSPs from Lenovo XClarity Support website and stores the files in the updates repository.

Note
You cannot pipe objects to this cmdlet.

Syntax​

Update-LXCAFirmwareRepository [-Connection LXCAConnection] 
                               -RefreshCatalog
                               -MachineTypes System.String[]
                              [-UXSPs]
                              [-LatestOnly]
                              [-AsJob]
                              [-WaitForJob System.String]
                              [CommonParameter]

Update-LXCAFirmwareRepository [-Connection LXCAConnection] 
                               -RefreshCatalog
                              [-UXSPs]
                              [-LatestOnly]
                              [-AsJob]
                              [-WaitForJob System.String]
                              [CommonParameter]

Update-LXCAFirmwareRepository [-Connection LXCAConnection] 
                               -AcquirePackages
                               -PackagesIDs System.String[]
                              [-AsJob]
                              [-WaitForJob System.String]
                              [CommonParameter]

Parameters​

-Connection LXCAConnection
Specifies the connection to the Lenovo XClarity Administrator server. If no connection is specified, the result from the last Connect-LXCA cmdlet is used.
-RefreshCatalog
When specified, the cmdlet updates the firmware catalog by retrieving information (metadata) about firmware updates from the Lenovo Support website.
-UXSPs
When specified, the cmdlet updates the firmware catalog by retrieving information (metadata) about UXSPs from the Lenovo Support website.
-AcquirePackages
When specified, the cmdlet downloads the specified firmware updates from Lenovo XClarity Support website and stores the files in the updates repository.
-LatestOnly
When specified, retrieves information about the most current version of all firmware updates.
-AsJob
When specified, the cmdlet runs as background job, and returns a Job object immediately. If not specified, the cmdlet runs in synchronous mode.
-WaitForJob System.String
When specified with the –AsJob parameter, PowerShell waits for this background job in Lenovo XClarity Administrator to either start or complete before running the next cmdlet in the script. This can be one of the following values.

  • ToStart. PowerShell waits until this background job starts in XClarity Administrator, so multiple jobs can run synchronously.

  • ToEnd. PowerShell waits until this background job completes in XClarity Administrator, so that one only job runs at a time.

If this parameter is omitted, this cmdlet does not wait. The next cmdlet in the script runs regardless of whether this background job starts or completes.

If -AsJob is omitted, this parameter is ignored.

-MachineTypes System.String
Specifies the machine types for the firmware updates or UXSPs information to be retrieved.
-PackagesIDs String
Specifies the firmware packages IDs (fixIDs) to be downloaded.
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 downloads specified firmware packages. The cmdlet is run as a PowerShell job.

    $cred = Get-Credential
    Connect-LXCA -Host 192.0.2.0 -Credential $cred

    $packs = @(
               "lnvgy_fw_sraidmr35_930-50.0.1-0374-1_linux_x86-64",
               "lnvgy_fw_xcc_cdi346l-3.60_anyos_noarch",
               "lnvgy_utl_uxsp_c6sp03p-1.40_platform_32-64"
               )
        
    $result = Update-LXCAFirmwareRepository -AcquirePackages -PackagesIDs $packs -AsJob -WaitForJob ToEnd
        
    # show job information.
    $job|Format-List
        
    # show general information about the downloaded packages contained in job object.
    $job.Output|Format-List
        
    # show the number of firmware packages included which were downloaded.
    $job.Output.FirmwarePackages.Count
        
    # show the details of one firmware package.
    $job.Output.FirmwarePackages[0]

    Disconnect-LXCA

  • The following example retrieves the firmware catalog for all firmware. The cmdlet is run as a PowerShell job.

    $cred = Get-Credential
    Connect-LXCA -Host 192.0.2.0 -Credential $cred

    $job = Update-LXCAFirmwareRepository -RefreshCatalog -AsJob -WaitForJob ToEnd

    # show job information.
    $job|Format-List

    # show general information about the firmware catalog contained in job object.
    $job.Output|Format-List

    #  show the number of firmware packages included in this catalog.
    $job.Output.FirmwarePackages.Count

    # show the details of one firmware package.
    $job.Output.FirmwarePackages[20]

    Disconnect-LXCA

  • The following example retrieves the firmware catalog for latest UXSPs packages.

    $cred = Get-Credential
    Connect-LXCA -Host 192.0.2.0 -Credential $cred

    $result = Update-LXCAFirmwareRepository -RefreshCatalog -UXSPs -LatestOnly

    # show general information about the UXSPs catalog.
    $result|Format-List

    # show the number of firmware packages included in this catalog.
    $result.FirmwarePackages.Count

    # show the details of one firmware package.
    $result.FirmwarePackages[20]

    Disconnect-LXCA