For every command, you specify the source and target locators. OVF Tool Definitions of Source and Target Locators defines each locator type.
OVF Tool Command-Line Options shows all the command-line options.
Options perform actions only between certain source and target types. OVF Tool Command-Line Options shows which source and target types each option works with. If you specify an option using an irrelevant source or target type, the command does nothing.
All options can be set using the form --option=value.
Binary options can be enabled or disabled explicitly. For example: --option=true, --option=false.
Accepts all end-user licenses agreements (EULAs) without being prompted. Binary option. |
||||
Lets you specify the extra config options that can be converted to .vmx format. These options are a security risk as they control low-level and potential unsafe options on the VM. Each option must be specified using a series of key value pairs (sometimes referred to as a white list). |
||||
Converts all extra config options to .vmx format. Flags must be explicitly specified on ESXi hosts, but with vCenter Server --exportflags=extraconfig produces vmw:ExtraConfig. |
||||
Adds annotation to vi, vmx, vapprun, vCloud, OVF, and OVA source locators. |
||||
Overrides default VMware authd port (902) when using a host as source. |
||||
Overrides the default VMware authd port (902) when using a host as target. |
||||
Specifies the chunk size to use for files in a generated OVF or OVA package. The default is not to chunk. If you don’t specify a unit for the chunk size, the chunk size is assumed to be in megabytes (mb). Accepted units are b, kb, mb, gb. Example: 2gb or 100kb. When using this option, all output files (except the OVF descriptor, manifest and certificate files) are sliced into the specified chunk size. This is useful if you need to transport an OVF package on a series of 800MB CD-ROMs, or are only able to create files up to 2GB on FAT32 file systems. When you use chunking with the OVA package option, the result is similar to OVF because all the files are chunked, but the OVA package is still be a single file. |
||||
Compresses the disk when given an OVF or OVA target locator. The value must be between 1 and 9. Use 9 for the slowest processing time, but best compression. Use 1 for the fastest processing time, but least compression. |
||||
Sets the computer name in the guest for a VM using the syntax --computerName:<VM ID>=<value>. |
||||
Specifies the distribution of the total number of CPUs over a number of virtual sockets using the syntax --coresPerSocket:<VM ID>=<value>. Only applies to vCloud targets of version 5.5 or newer. |
||||
Enables Base64 decoding for values in the OVFTool command line. |
||||
The storage profile for all VMs in the OVF package. The value should be an SPBM profile ID. Only applies to VI targets of version 5.5 or newer. |
||||
The storage profile for all VMs in the OVF package. The value should be a raw SPBM profile. The value overwrites that in --defaultStorageProfile. Only applies to VI targets of version 5.5 or newer |
||||
Deployment options for a deployed OVF package (if the source OVF package supports multiple options.) An OVF package can contain several deployment configurations. This option allows you to select which configuration to use when deploying to the vSphere target. |
||||
Skips validation of signature and certificate. Binary option. |
||||
Select target disk format. Supported formats are: monolithicSparse, monolithicFlat, twoGbMaxExtentSparse, twoGbMaxExtentFlat, seSparse (vSphere target), eagerZeroedThick (vSphere target), thin (vSphere target), thick (vSphere target), sparse, and flat. |
||||
Sets the size of a VM disk in megabytes using the syntax --diskSize:<VM ID>,<disk instance ID>=<value>. Only applies to vCloud targets of version 5.5 or newer. |
||||
Inserts the EULA in the first virtual system or virtual system collection in the OVF. If the EULA is in a file, use the format: |
||||
Specifies the source of an export. The supported values for vSphere source are: mac, uuid, and extraconfig. |
||||
Sets an ExtraConfig element for all VirtualHardwareSections. The syntax is --:extraConfig:<key>=<value> This option applies to vi, vmx, vapprun, vCloud, ovf, and ova source locators |
||||
If a parent network exists on a vCloud target, this option specifies the connectivity to the parent. Possible values are bridged, isolated, allowIn, allowInOut, allowOut. |
||||
Prints the VMware OVF Tool help message that lists the - help options. |
||||
Does not include the EULA in the OVF probe output. Binary option. |
||||
Integration option. Interpret arguments for networks, datastores, and folders as VIM Managed Object Reference identifiers (type:id) for vSphere source and destination locators. |
||||
Integration option. Specifies the session ticket used for authenticating the vSphere source locator. |
||||
Integration option. Specifies the session ticket used for authenticating the vSphere target locator. |
||||
IP allocation policy for a deployed OVF package. Supported values are: dhcpPolicy, transientPolicy, fixedPolicy, or fixedAllocatedPolicy. In OVF descriptors, you can specify a VMware specific IP assignment policy that guides the deployment process by expressing which of the policies the OVF package supports. Only values listed in the OVF descriptor are supported when the OVF or OVA package is deployed. |
||||
Specifies which IP protocol to use. For example, IPv4, IPv6. As with the ipAllocationPolicy option, you can specify which IP version this OVF package uses when it is deployed. Use only the values listed in the OVF descriptor. |
||||
Relax OVF specification conformance and virtual hardware compliance checks. (For advanced users only.) |
||||
Outputs OVF Tool messages in a machine readable format. Binary option. |
||||
Use delta disk compression to create an OVF package from a disk source. Binary option. |
||||
Sets the memory size in megabytes of a VM using the syntax --memorySize:<VM ID>=<value>. Example: --memorySize:vm1=1024. Applies to VI and vCloud targets of version 5.5 or newer. |
||||
Sets a network assignment in the deployed OVF package. For example, --net:<OVF name>=<target name>. OVF packages contain symbolic names for network names which are assigned with this option. For multiple network mappings, repeat the option, separating them with a space for example, --net:s1=t1 --net:s2=t2 --net:s3=t3. If the target is vCloud 5.5 or newer, a fence mode can also be specified using the syntax --net:<OVF name>=<target name>,<fence mode>. Possible fence mode values are: bridged, isolated, and natRouted. |
||||
Target network for a vSphere deployment. Use this option in place of the --net option when only one network exists in the OVF package. This option maps the symbolic OVF name to the specified network name. |
||||
Specifies NIC configuration in a VM using the syntax --nic:<VM ID>,<index>=<OVF net name>,<isPrimary>,<ipAddressingMode>,<ipAddress>. Possible values for ipAddressingMode are: DHCP, POOL, MANUAL, and NONE. ipAddress is optional and should only be used when ipAddressingMode is set to MANUAL. |
||||
Creates and uploads the virtual machine or vApps but does not upload any disk files. Disks are created empty. (Disables disk conversion.) |
||||
Creates and uploads the virtual machine or vApps but does not upload ISO files to a CD-ROM. (Does not include image files in destination. |
||||
Sets the number of CPUs for a VM using the syntax --numberOfCpus:<VM ID>=<value>. Applies to VI and vCloud targets of version 5.5 or newer. |
||||
Ensures that a virtual machine or vApp is powered off before importing from a vSphere source. Binary option. |
||||
Ensures that a virtual machine or vApp is powered off before overwriting a vSphere target. Binary option. |
||||
Powers on a virtual machine or vApp deployed on a vSphere target. Binary option. |
||||
Signs the OVF package with the given private key (.pem file). The file must contain a private key and a certificate. |
||||
Password for the private key. Used in conjunction with --privateKey if the private key requires password authentication. If required but not specified, the tool prompts for the password. |
||||
Sets a property in the deployed OVF package. For example, --prop:<key>=<value>. Use probe mode to learn which properties an OVF package can set. For multiple property mappings, repeat the option, separating them with a blank, for example --prop:p1=v1 --prop:p2=v2 --prop:p3=v3. |
||||
Specifies the proxy used for HTTP, HTTPS, FTP, vSphere and vCloud access. The proxy is expressed as the URL to the proxy. For example, for proxy.example.com, the option value is: OVF Tool supports proxies that require authentication. If you do not provide credentials in the URL, the OVF Tool prompts you for them. You can also use the --X:viUseProxy option for vsphere and the --X:vCloudUseProxy option for vcloud but only if you use them together. |
||||
Enables support for the NTLM authentication and security protocol. NT Lan Manager is the authentication protocol used on networks that include systems running the Windows operating system and on stand-alone systems. |
||||
Prints only errors. No other output is sent to the screen. Binary option. |
||||
Validates OVF descriptor against the OVF schema. Binary option. |
||||
Use this option to condense with Secure Hash Algorithm (SHA) for manifest validation, digital signing, and OVF package creation. Either sha1 (SHA-1), sha256 (SHA-256), or sha512 (SHA-512). |
||||
Skips validation of the OVF package manifest. Binary option. |
||||
Skips generation of the OVF package manifest. Binary option. |
||||
File path to a Privacy Enhanced Mail (.pem) file used to verify vSphere connections. |
||||
SSL thumbprint of the source. OVF Tool verifies the SSL thumbprint that it receives from the source, if this value is set. |
||||
Explicitly expresses that the source is OVF, OVA, VMX, VMX, vSphere, vCloud, ISO, FLP, or vApprun. |
||||
Allows override of the default cipher list. Diffie-Hellman is disabled by default. |
||||
Either TLSv1_0, TLSv1_1, or TLSv1_2. The TLSv1_0 protocol is disabled by default. |
||||
Sets the storage profile for a VM using the syntax --storageProfile:<VM ID>=<value>. Applies only to vCloud targets of version 5.5 or newer. |
||||
File path to a Privacy Enhanced Mail (.pem) file used to verify vSphere connections. |
||||
SSL thumbprint of the target. OVF Tool verifies the SSL thumbprint that it receives from the target, if this value is set. |
||||
Explicitly express that the target is OVF, OVA, VMX, VMX, vSphere, vCloud, ISO, FLP, or vApprun. |
||||
Set a dependency on a vService provider in the OVF package, using the following syntax: --vService:<dependencyId>=<providerId> |
||||
Do not upload the source; just verify it. This only applies to vSphere 4. |
||||
Specify the CPU resource settings for VI locator targets. The syntax is --viCpuResource=<shares>:<reservation>:<limit> |
||||
Specify the memory resource settings for vSphere locator targets. The syntax is --viMemoryResource=<shares>:<reservation>:<limit> |
||||
The target virtual machine folder in vSphere inventory (for a datacenter). |