In some situations, knowing the structure of ImageProfile, SoftwarePackage, and ImageProfileDiff objects helps you manage deployment and upgrade processes.

The ImageProfile object, which is accessible with the Get-EsxImageProfile PowerCLI cmdlet, has the following properties.

Name

Type

Description

AcceptanceLevel

AcceptanceLevel

Determines which VIBs you can add to the profile. Levels are VMwareCertified, VMwareAccepted, PartnerSupported, and CommunitySupported. See Acceptance Levels.

Author

System.String

Person who created the profile. 60 characters or fewer.

CreationTime

System.DateTime

Timestamp of creation time.

Description

System.String

Full text description of profile. No length limit.

GUID

System.String

Globally unique ID of the image profile.

ModifiedTime

System.DateTime

Timestamp of last modification time.

Name

System.String

Name of the image profile. 80 characters or fewer.

ReadOnly

System.Boolean

When set to true, the profile cannot be edited. Use Set-EsxImageProfile -Readonly to make your custom image profiles read only.

Rules

ImageProfileRule[]

Displays any OEM hardware requirements that the image profile might have. Auto Deploy checks this property when deploying an image profile and deploys the profile if matching hardware is available.

Vendor

System.String

Organization that publishes the profile. 40 characters or fewer.

VibList

SoftwarePackage[]

List of VIB IDs the image consists of.

When preparing an image profile, you can examine software packages to decide which packages are suitable for inclusion. The SoftwarePackage object has the following properties.

Name

Type

Description

AcceptanceLevel

AcceptanceLevel

Acceptance level of this VIB.

Conflicts

SoftwareConstraint[]

List of VIBs that cannot be installed at the same time as this VIB. Each constraint uses the following format:

package-name[<<|<=|=|>=|<< version]

Depends

SoftwareConstraint[]

List of VIBs that must be installed at the same time as this VIB. Same constraint format as Conflicts property.

Description

System.String

Long description of the VIB.

Guid

System.String

Unique ID for the VIB.

LiveInstallOk

System.Boolean

True if live installs of this VIB are supported.

LiveRemoveOk

System.Boolean

True if live removals of this VIB are supported.

MaintenanceMode

System.Boolean

True if hosts must be in maintenance mode for installation of this VIB.

Name

System.String

Name of the VIB. Usually uniquely describes the package on a running ESXi system.

ReleaseDate

System.DateTime

Date and time of VIB publication or release.

SourceUrls

System.String[]

List of source URLs from which this VIB can be downloaded.

Summary

System.String

One-line summary of the VIB.

Tag

System.String[]

An array of string tags for this package defined by the vendor or publisher. Tags can be used to identify characteristics of a package.

Vendor

System.String

VIB vendor or publisher.

Version

System.String

VIB version.

When you run the Compare-EsxImageProfile cmdlet, you pass in two parameters, first the reference profile, and then the comparison profile. The cmdlet returns an ImageProfileDiff object, which has the following properties.

Name

Type

Description

CompAcceptanceLevel

System.String

Acceptance level for the second profile that you passed to Compare-EsxImageProfile.

DowngradeFromRef

System.String[]

List of VIBs in the second profile that are downgrades from VIBs in the first profile.

Equal

System.Boolean

True if the two image profiles have identical packages and acceptance levels.

OnlyInComp

System.String

List of VIBs found only in the second profile that you passed to Compare-EsxImageProfile.

OnlyInRef

System.String[]

List of VIBs found only in the first profile that you passed to Compare-EsxImageProfile.

PackagesEqual

System.Boolean

True if the image profiles have identical sets of VIB packages.

RefAcceptanceLevel

System.String

Acceptance level for the first profile that you passed to Compare-EsxImageProfile.

UpgradeFromRef

System.String[]

List of VIBs in the second profile that are upgrades from VIBs in the first profile.