Add-EsxSoftwarePackage
Adds new VIBs to an image profile or updates existing VIBs in an image profile. For each package, if it is newer or older than an existing package in the profile, the existing package will be replaced. Image Builder performs all image profile validation tests on the modified image profile.The output of this cmdlet may be piped into any other cmdlet taking image profiles as input.Note that the image profile object that is passed in will have its VibList modified. Please see the New-EsxImageProfile cmdlet for details about persistence of image profiles.Modification is not possible if the ReadOnly property of an ImageProfile is true.
Syntax
Parameters
| Required | Parameter Name | Type | Position | Features | Description |
|---|---|---|---|---|---|
| required |
|
SoftwarePackage[] | 1 |
|
(pipeline input, prompt) List of software packages to add to the profile.Takes one of the following forms:*Name of a VIB, as displayed in the Name column of Get-EsxSoftwarePackage, or the Name property of any SoftwarePackage object. Image Builder selects the highest available version of the named package.*" |
required |
|
ImageProfile | named |
|
(pipeline input, prompt) Image profile to edit.Takes one of the following forms:*Name of an image profile, as displayed in the Name column of Get-EsxImageProfile, or the Name property of any ImageProfile object*ImageProfile object | optional |
|
SwitchParameter | named |
|
Installs packages that break extensibility rules such as standard file path. Also bypasses dependency checks on packages. Use this option with care. Because it bypasses standard validation checks, an invalid image profile might result. |
Output
Examples
Example 1
Add a package by name to an image profile:
Example 2
Add a package of a specific name and version:
Example 3
Clone an image profile, then add a package by name, in one line using pipelining:
Related Commands
EsxImageProfile
EsxSoftwareDepot
