VMware vSphere PowerCLI 5.5 Release 1 for Tenants Release Notes
Released 22 September 2013
Build 1295336 is VMware vSphere PowerCLI 5.5 Release 1 for Tenants
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
VMware vSphere PowerCLI 5.5 Release 1 for Tenants consists of two components:
- vSphere PowerCLI common snap-in for providing common PowerCLI configuration and usage based tasks, these cmdlets are part of the
- 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.
VMware vSphere PowerCLI 5.5 Release 1 for Tenants provides the following capabilities:
- You can list, modify, and manage organizations.
- You can list, create, and manage permissions.
- You can list and assign networking resources.
- You can list organization networks.
- You can list, create, modify, and remove vApp networks.
- You can list, create, modify, manage, and remove vApps.
- You can list and manage virtual machines and their guest operating systems within vApps.
To use VMware vSphere PowerCLI for Tenants, you need to have installed the following software:
- Windows PowerShell 2.0 or Windows PowerShell 3.0
- A supported version of .NET Framework
- .NET Framework 2.0 with Service Pack 2
- .NET Framework 3.0 or .NET Framework 3.0 with Service Pack 1, or Service Pack 2
- .NET Framework 3.5 or .NET Framework 3.5 with Service Pack 1
For a list of VMware vSphere PowerCLI 5.5 Release 1 supported operating systems, see the VMware vSphere PowerCLI 5.5 Release 1 User's Guide.
VMware vSphere PowerCLI 5.5 Release 1 for Tenants is compatible with VMware vCloud Director 1.5.1, VMware vCloud Director 5.1, and VMware vCloud Director 5.1.
What's New in This Release
With this release of vSphere PowerCLI for Tenants, you can now automate and manage vCloud Director 5.5 environments as well as vCloud Director 5.1 and vCloud Director 1.5.x environments. You can automate only vCloud Director 5.1 features against vCloud Director 5.5.
vSphere PowerCLI 5.5 Release 1 for Tenants also introduces the new
Open-VMConsoleWindow cmdlet for opening the console of a vCloud Director virtual machine.
VMware vSphere PowerCLI 5.5 Release 1 for Tenants is known to have the following issues:
Get-CIVApp returns all virtual appliance objects in the inventory including expired ones.
Get-CIVAppTemplate returns all virtual appliance templates in the inventory including expired ones.
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.
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.
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.
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 1 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.
- Click Finish to complete the installation process.
For more information about installing PowerCLI 5.5 Release 1 for Tenants, see the VMware vSphere PowerCLI 5.5 Release 1 User's Guide.