VMware VS4-ENT-PL-A - vSphere Enterprise Plus Setup Manual page 228

vSphere Installation and Setup
Run cmdlet_name at the PowerCLI prompt for detailed reference information.
Get-Help
Table 7‑15. Image Builder Cmdlets
Cmdlet
Add-EsxSoftwareDepot
Remove-
EsxSoftwareDepot
Get-EsxSoftwareDepot
Get-
EsxSoftwarePackage
Get-EsxImageProfile
New-EsxImageProfile
Set-EsxImageProfile
Export-
EsxImageProfile
Compare-
EsxImageProfile
Remove-
EsxImageProfile
Add-
EsxSoftwarePackage
Remove-
EsxSoftwarePackage
Image Profiles
Image profiles define the set of VIBs that an ESXi installation or update process uses. Image profiles apply to
hosts provisioned with Auto Deploy and to other ESXi 5.x hosts. You define and manipulate image profiles
with the Image Builder PowerCLI.
Image Profile Requirements
You can create a custom image profile from scratch or clone an existing profile and add or remove VIBs. A
profile must meet the following requirements to be valid.
Each image profile must have a unique name and vendor combination.
n
Each image profile has an acceptance level. When you add a VIB to an image profile with an Image
n
Builder PowerCLI cmdlet, Image Builder checks that the VIB matches the acceptance level defined for
the profile.
You cannot remove VIBs that are required by other VIBs.
n
You cannot include two versions of the same VIB in an image profile. When you add a new version of a
n
VIB, the new version replaces the existing version of the VIB.
Image Profile Validation
An image profile and its VIBs must meet several criteria to be valid.
Image profiles must contain at least one base VIB and one bootable kernel module.
n
228
Description
Adds the software depot or ZIP file at the specified location to your current environment.
Downloads metadata from the depot and analyzes VIBs for dependencies.
Disconnects from the specified software depot.
Returns a list of software depots that are in the current environment. If you want to examine
and manage image profiles and VIBs, you must first add the corresponding software depot
to your environment.
Returns a list of software package objects (VIBs). Use this cmdlet's options to filter the
results.
Returns an array of ImageProfile objects from all currently added depots.
Creates a new image profile. In most cases, creating a new profile by cloning an existing
profile is recommended. See "Create an Image Profile,"
Modifies a local ImageProfile object and performs validation tests on the modified profile.
The cmdlet returns the modified object but does not persist it.
Exports an image profile as either an ESXi ISO image for ESXi installation, or as a ZIP file.
Returns an ImageProfileDiff structure that shows whether the two profiles have the
same VIB list and acceptance level. See
Removes the image profile from the software depot.
Adds one or more new packages (VIBs) to an existing image profile.
Removes one or more packages (VIBs) from an image profile.
on page 235.
"Acceptance Levels," on page 229.
VMware, Inc.