Skip to main content

Get-LXCAServiceFile

This cmdlet downloads the service First Failure Data Capture (service) file for a specified device (such as a chassis, rack server, rack switch, or storage device) to the local system.

Note

  • This cmdlet downloads a service files that was previously collected. This cmdlet does not collect service data for the device.

  • You cannot pipe objects to this cmdlet.

Syntax​

Get-LXCAServiceFile [-Connection LXCAConnection] 
                     -Uuid String[]
                     -Destination String
                    [-Overwrite] 
                    [CommonParameter]

Get-LXCAServiceFile [-Connection LXCAConnection] 
                     -All
                     -Destination String
                    [-Overwrite]
                    [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.
-Uuid String[]
Specifies one or more UUIDs of managed devices.
-All
If specified, the cmdlet downloads FFDC data for all managed devices.
-Destination String
Specifies the local path where the file is to be saved.

The file is downloaded in a single .TAR.GZ archive file.

If a directory is specified, the cmdlet saves the FFDC file to a file using the file name that is retuned from the XClarity Administrator server. If a directory and a file name are specified, the cmdlet saves the FFDC file using the specified file name.

Note
The full specified path must exist.
-Overwrite
If specified, the cmdlet overwrites the local file when a file with that same name exists.
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​

This cmdlet returns the path to the FFDC file on the local system.

Examples​

  • The following example downloads the FFDC file for a specified device to the C:\LXCA\ directory on the local system. If the file of the same name exists in the specified directory, the file is overwritten.

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

    Get-LXCAFServiceFile -Uuid AAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAA -Destination C:\LXCA\ -Overwrite

    Disconnect-LXCA

  • The following example downloads the FFDC files for all managed devices in a compressed file named myFFDC.tar.gz in the C:\LXCA\ directory on the local system. If the file of the same name exists in the specified directory, the file is not overwritten.

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

    Get-LXCAServiceFile -All -Destination C:\LXCA\myFFDC.tar.gz

    Disconnect-LXCA

Get-LXCAFFDCFile