About VMware vSphere PowerCLI for Tenants

VMware vSphere PowerCLI for Tenants is a command-line and scripting tool built on Windows PowerShell. It provides more than 50 cmdlets for managing and automating vCloud Tenant tasks. The VMware vSphere PowerCLI for Tenants snap-in was designed specifically with the work of vCloud Tenants in mind. It enables the reporting and automation features of PowerCLI while limiting activities and tasks to those of a vCloud Tenant.

Components and Versioning

vSphere PowerCLI common snap-in for providing common PowerCLI configuration and usage based tasks, these cmdlets are part of the VMware.VimAutomation.Common snap-in.

vCloud Director PowerCLI snap-in for providing tenant-based reporting and automation, these cmdlets are part of the VMware.VimAutomation.Cloud snap-in and can be used with vCloud Director 1.5.1, 5.1, and 5.5 Tenant tasks.

What's New in This Release

New Features

Known Issues

VMware vSphere PowerCLI 5.5 Release 2 for Tenants is known to have the following issues:

Get-CIVApp

Get-CIVApp returns all virtual appliance objects in the inventory including expired ones.

Get-CIVAppTemplate

Get-CIVAppTemplate returns all virtual appliance templates in the inventory including expired ones.

New-CIVAppNetwork

You can create a vApp network by specifying inconsistent network settings. While the settings of the newly created vApp Network are inconsistent, you can only modify them to restore their consistency. To configure the vApp network, run Set-CIVAppNetwork.

Set-Org

To ensure backward compatibility, PowerCLI provides limited support for this cmdlet on vCloud Director 5.1 environments. When you develop new tenant scripts for vCloud Director 5.1 environments, do not use this cmdlet.

Other

When running in 64-bit mode, vSphere PowerCLI for Tenants cannot detect the registry key HKEY_LOCAL_MACHINE\SOFTWARE\VMware, Inc.\VMware vSphere PowerCLI\, which is used for determining the PowerCLI installation folder. Instead, you can use the following key: HKEY_LOCAL_MACHINE\SOFTWARE\Wow6432Node\VMware, Inc.\VMware vSphere PowerCLI.

Resolved Issues

The following issues have been resolved in VMware vSphere PowerCLI 5.5 Release 2 Patch 1 for Tenants:

OpenSSL security fix

The OpenSSL library is updated to version openssl-0.9.8za to address CVE-2014-0224, CVE-2014-0198, CVE-2010-5298, and CVE-2014-3470.

Installing VMware vSphere PowerCLI for Tenants

VMware provides a single installer for VMware vSphere PowerCLI for Tenants.

Before installing VMware vSphere PowerCLI for Tenants, verify that you have uninstalled VMware vSphere PowerCLI from your system, if installed.

To install VMware vSphere PowerCLI for Tenants

Download VMware vSphere PowerCLI 5.5 Release 2 for Tenants.

Navigate to the local folder that contains the PowerCLI for Tenants installer file you downloaded and double-click the executable file.

On the Welcome page, click Next.

Accept the license agreement terms and click Next.

On the Destination Folder page, select the location to install vSphere PowerCLI for Tenants and click Next.

On the Ready to Install the Program page, click Install to proceed with the installation.