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

NameTypeDescriptionRequired?Pipeline InputDefault Value
ImageProfileImageProfile(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
truetrue (ByValue, ByPropertyName)
FilePathStringRequired; 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.truefalse
ExportToBundleSwitchParametertruefalse
ExportToIsoSwitchParametertruefalse
ForceSwitchParameterOptional. If specified, the cmdlet overwrites an existing destination file with the same name.falsefalse
NoSignatureCheckSwitchParameterOptional. If specified, disables VIB signature validation. The use of this option may lead to debilitating security vulnerabilities.falsefalse
RunAsyncSwitchParameterfalsefalse
WarningActionActionPreferencefalsefalse
WarningVariableStringfalsefalse

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.


Copyright © 1998 - 2011 VMware, Inc. All rights reserved.