Export-VApp

Name	Type	Description	Required?	Pipeline Input	Default Value
Destination	String	Specifies a destination path to the file system location where you want to export the vApp or the virtual machine. If the value of the Destination parameter is a folder, the vApp or the virtual machine is exported to a container folder (OVF). If the destination is a file, the vApp or the virtual machine is exported in OVA format.	false	False
VApp	VApp[]	Specifies the vApp that you want to export.	true	True (ByValue)
Confirm	SwitchParameter	If the value is $true, indicates that the cmdlet asks for confirmation before running. If the value is $false, the cmdlet runs without asking for user confirmation.	false	False
CreateSeparateFolder	SwitchParameter	Indicates that you want to create a separate folder for each vApp or virtual machine.	false	False
Description	String	Provides a description of the exported vApp or virtual machine.	false	False
Force	SwitchParameter	Indicates that the cmdlet overwrites the existing destination files and creates directories to complete the specified file path.	false	False
Format	VAppStorageFormat	Specifies the file format of the specified vApp or virtual machine. The default format is OVF. The valid values are OVF and OVA.	false	False
Name	String	Specifies a name for the exported vApp or virtual machine.	false	False
RunAsync	SwitchParameter	Indicates that the command returns immediately without waiting for the task to complete. In this mode, the output of the cmdlet is a Task object. For more information about the RunAsync parameter run "help About_RunAsync" in the VMware PowerCLI console.	false	False
Server	VIServer[]	Specifies the vCenter Server systems on which you want to run the cmdlet. If no value is passed to this parameter, the command runs on the default servers. For more information about default servers, see the description of Connect-VIServer.	false	False
VM	VirtualMachine[]	Specifies the virtual machine that you want to export.	true	True (ByValue)
WhatIf	SwitchParameter	Indicates that the cmdlet is run only to display the changes that would be made and actually no objects are modified.	false	False

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

Get-VApp -Name "MyVApp*" | Export-VApp -Destination "C:\vapps\"

Retrieves all vApps whose names start with "MyVApp" and exports them to the specified path.

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

$myVApp = Get-VApp -Name "MyVApp1" 
Export-VApp -Destination "C:\NewFolder\" -VApp $myVApp -Name "EMail_vApp" -Force

Exports the vApp in the $myVApp variable to the specified location and assigns a name to the folder.

-------------------------- Example 3 --------------------------

$myVApp = Get-VApp -Name "MyVApp1" 
Export-VApp -vApp $myVApp -Destination "C:\vapps\Vapp\" -Force -CreateSeparateFolder:$false

Exports the vApp in the $myVApp variable to the specified location without creating a separate folder for each virtual appliance.

-------------------------- Example 4 --------------------------

$myVApp = Get-VApp -Name "MyVApp1" 
Export-VApp -vApp $myVApp -Destination "C:\vapps\myVapp\" -Format Ova

Exports a vApp in OVA format.

-------------------------- Example 5 --------------------------

Get-VM -Name MyVM* | Export-VApp -Destination "C:\MyVMs\"

Retrieves all virtual machines whose names start with "MyVM" and exports them to the specified path.

-------------------------- Example 6 --------------------------

$myVM = New-VM -Name MyVM1 -VMHost MyVMHost1
Export-VApp -Destination "C:\MyVMs\" -VM $myVM -Format Ova

Creates a new virtual machine and exports it in OVA format.

-------------------------- Example 7 --------------------------

$myVM = New-VM -Name "MyVM1" -VMHost MyVMHost1
Get-VM -Name MyVM | Export-VApp -Destination "C:\MyVMs\"
Export-VApp -Destination "C:\MyVMs\" -VM $myVM -Force

Exports a virtual machine to the same path twice. The second time forces an override of the previously exported files.

PowerCLI Reference

Synopsis