Free ESXi and API/CLI support
I think there is a pretty good understanding on this topic, but questions still come up once in a while in VI Java API community and my inbox. Some people got errors while trying to manage free ESXi servers via API. The API support of free ESXi is limited to ready only according to a VMware KB article:
vCLI, PowerCLI, and vSphere SDk for Perl are limited to read-only access for the free vSphere Hypervisor edition. To enable full functionality of vCLI on a VMware ESXi host, the host must be licensed with vSphere Essentials, vSphere Essential Plus, vSphere Standard, vSphere Advanced, vSphere Enterprise, or vSphere Enterprise Plus.
Note:
- The vSphere Hypervisor mentioned is the ESXi.
- It’s not limited to vCLI, PowerCLI, and vSphere SDK for Perl, but any other like VI Java API. They all built on top of vSphere SDK for Web Services, therefore have the same limitation.
- You can find comparisons of ESX and ESXi 4.0, 3.5.
To use full vSphere API/CLI with ESXi, you got to have a license. So if you have issue with API calls or CLI scripts, don’t forget to check your ESXi server license.
As a side story, the API was once unlocked unintentionally due to a bug fix on free ESXi 3.5 U3 as covered by Mike in his blog. Check it out here.

Dear Sir,
If my comment below is not suitable here, please excuse me.
It seems that PowerCLI has limited functionality if it’s used for VM on free ESXi host.
I faced export-vapp command ended up with 0 byte exported when making .ovf/.vmdk file on ESXi 4.0. Is it due to the same reason with license ?
Furthermore, it successfully exported on ESX 4.0 host. However, it again exported 0 byte with ESX 4.0 host with evaluation license. Is this again due to the same reason with license ?
I really appreciate if I can get any feedback on this.
Hi Keigo,
Thanks for your comment! PowerCLI leverages the vSphere API underneath, so it inherits whatever limitation from API with license.
-Steve
@Steve Jin
Dear Steve,
Thank you for your feedback.
So, due to the inheritance of such limitation, the phenomenon occurred.
Thank you very much !
Algrhit alright alright that’s exactly what I needed!