You can add one or more VIBs to an image profile if that image profile is not set to ReadOnly. If the new VIB depends on other VIBs or conflicts with other VIBs in the profile, a message is displayed at the PowerShell prompt and the VIB is not added.

You can add VIBs from VMware or from VMware partners to an image profile. If you add VMware VIBs, the Image Builder PowerCLI performs validation. If you add VIBs from two or more OEM partners, no errors are reported but the resulting image profile might not work. Install VIBs from only one OEM vendor at a time.

Note

You might be able to add VIBs even if the resulting image profile is invalid.

Administrators performing this task must have some experience with PowerCLI or Microsoft PowerShell.

Install the VMware PowerCLI and all prerequisite software. See Install Image Builder PowerCLI and Prerequisite Software.

If you encounter problems running PowerCLI cmdlets, consider changing the execution policy. See Using Image Builder Cmdlets.

1

Run Add-EsxSoftwareDepot for each depot you want to work with.

Depot Type

Cmdlet

Remote depot

Run Add-EsxSoftwareDepot -DepotUrl depot_url.

ZIP file

a

Download the ZIP file to a local file path.

b

Run Add-EsxSoftwareDepot -DepotUrl C:\file_path\offline-bundle.zip

The cmdlet returns one or more SoftwareDepot objects.

2

Run Get-EsxImageProfile to list all image profiles in all currently visible depots.

Get-EsxImageProfile

The cmdlet returns all available profiles. You can narrow your search by using the optional arguments to filter the output.

3

Clone the profile and make changes to the clone if the image profile is read only.

New-EsxImageProfile -CloneProfile My_Profile -Name "Test Profile 42"

Image profiles published by VMware and its partners are read only.

4

Run Add-EsxSoftwarePackage to add a new package to one of the image profile.

Add-EsxSoftwarePackage -ImageProfile My_Profile -SoftwarePackage partner-package

The cmdlet runs the standard validation tests on the image profile. If validation succeeds, the cmdlet returns a modified, validated image profile. If the VIB that you want to add depends on a different VIB, the cmdlet displays that information and includes the VIB that would resolve the dependency. If the acceptance level of the VIB that you want to add is lower than the image profile acceptance level, an error results. Change the acceptance level of the image profile to add the VIB.

5

(Optional)Change the acceptance level of the image profile if an error about acceptance level problems displays.

VIB acceptance levels are set during VIB creation and cannot be changed.

The image profile includes the new VIB.