This cmdlet imports a local OS image or device driver into the OS-images repository.

Note: You cannot pipe objects to this cmdlet.


Import-LXCAOSImage [-Connection LXCAConnection] 
                    -ImagePath String 
                   [-ChecksumType String]
                   [-ChecksumValue String]
                   [-WaitForJob String]

Import-LXCAOSImage [-Connection LXCAConnection] 
                    -ImagePath String
                    -OSImageName String
                   [-WaitForJob String]


-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.
-ImagePath String
Specifies the file path and file name to be imported.
-ChecksumType String
Specifies the checksum type. You can specify one of the following values:
  • MD5
  • SHA1
  • SHA256

If you specify the checksum types, you must also specify the -ChecksumValue parameter.

-ChecksumValue String
Specifies the checksum value to be used to check the integrity and security of the uploaded file.
If specified, indicates that the import file is a device driver.
-OSImageName String
Specifies the name of the OS image to which you want to add the device driver (for example, redhat7.0).
Note: The OS image must exist in the OS images repository.
When specified, the cmdlet runs as background job and returns a Job object immediately.
-WaitForJob String
When specified with the -AsJob parameter, PowerShell waits for this background job in 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 only one job runs at a time.

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

If -AsJob is not specified, this parameter is ignored.

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.


This cmdlets imports the image into the image repository. If you specify the -AsJob parameter, this cmdlets returns a Job object.


Related links