PowerCLI Reference

vSphere Imagebuilder Reference

Export-EsxImageProfile

Synopsis

Syntax

Export-EsxImageProfile [-ImageProfile] <ImageProfile> [-FilePath] <String> -ExportToIso [-Force] [-NoSignatureCheck] [-RunAsync] [-WarningAction <ActionPreference>] [-WarningVariable <String>] [<CommonParameters>]
Export-EsxImageProfile [-ImageProfile] <ImageProfile> [-FilePath] <String> -ExportToBundle [-Force] [-NoSignatureCheck] [-RunAsync] [-WarningAction <ActionPreference>] [-WarningVariable <String>] [<CommonParameters>]

Related Commands

Detailed Description

Exports an Image Profile object as either an ESXi ISO image that can be booted up and used as an ESXi installer, or an offline depot ZIP file that contains metadata plus the VIB packages. In both cases, downloads the VIB binaries and validates the VIB signatures.

You can perform the following tasks with the offline depot ZIP file:

*Import the ZIP into VMware Update Manager for patch remediation
*Download the ZIP to an ESXi host and used with esxcli for installation
*Re-import the ZIP into ImageBuilder itself using Add-EsxSoftwareDepot

You can specify either -ExportToIso or -ExportToBundle but not both.

Parameters

Name	Type	Description	Required?	Pipeline Input
ImageProfile	ImageProfile	(pipeline input, prompt) Specifies the image profile to export. 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	true	true (ByValue, ByPropertyName)
FilePath	String	Required; specifies the destination for the ISO or the ZIP file path. Include the extension, either .iso or .zip. Offline depots must be named with .zip at the end. If the file already exists, it will not be overwritten unless -Force is specified.	true	false
ExportToBundle	SwitchParameter		true	false
ExportToIso	SwitchParameter		true	false
Force	SwitchParameter	Optional. If specified, the cmdlet overwrites an existing destination file with the same name.	false	false
NoSignatureCheck	SwitchParameter	Optional. If specified, disables VIB signature validation. The use of this option may lead to debilitating security vulnerabilities.	false	false
RunAsync	SwitchParameter		false	false
WarningAction	ActionPreference		false	false
WarningVariable	String		false	false

Return Type

Notes

Examples

---------- Example 1 ----------

Export-EsxImageProfile -ImageProfile "Evan's Profile" -ExportToIso -FilePath c:\isos\evans-iso.iso

Export an ISO image

---------- Example 2 ----------

New-EsxImageProfile -CloneProfile "ESXi-5.0.0-234567-standard" -Name "Evan's Profile"
Add-EsxSoftwarePackage -ImageProfile "Evan's Profile" -SoftwarePackage cisco-vem-v140
Export-EsxImageProfile -ImageProfile "Evan's Profile" -ExportToBundle -FilePath c:\isos\base-plus-vem.zip

Clone an image profile, add a software package, then export to offline bundle.