VMware VS4-ENT-PL-A Setup Guide - Page 228

vSphere Installation and Setup Run Get-Help cmdlet_name at the PowerCLI prompt for detailed reference information. Table 7‑15. Image Builder Cmdlets Cmdlet Description Add-EsxSoftwareDepot 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. RemoveEsxSoftwareDepot Disconnects from the specified software depot. Get-EsxSoftwareDepot 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. GetEsxSoftwarePackage Returns a list of software package objects (VIBs). Use this cmdlet's options to filter the results. Get-EsxImageProfile Returns an array of ImageProfile objects from all currently added depots. New-EsxImageProfile Creates a new image profile. In most cases, creating a new profile by cloning an existing profile is recommended. See "Create an Image Profile," on page 235. Set-EsxImageProfile Modifies a local ImageProfile object and performs validation tests on the modified profile. The cmdlet returns the modified object but does not persist it. ExportEsxImageProfile Exports an image profile as either an ESXi ISO image for ESXi installation, or as a ZIP file. CompareEsxImageProfile Returns an ImageProfileDiff structure that shows whether the two profiles have the same VIB list and acceptance level. See "Acceptance Levels," on page 229. RemoveEsxImageProfile Removes the image profile from the software depot. AddEsxSoftwarePackage Adds one or more new packages (VIBs) to an existing image profile. RemoveEsxSoftwarePackage Removes one or more packages (VIBs) from an image profile. 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. n 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 Builder PowerCLI cmdlet, Image Builder checks that the VIB matches the acceptance level defined for the profile. n 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 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. n Image profiles must contain at least one base VIB and one bootable kernel module. 228 VMware, Inc.