VMware

VMware vSphere PowerCLI 5.1 Release 1 for Tenants Release Notes

Released 10 September 2012

Build 793510 is VMware vSphere PowerCLI 5.1 Release 1 for Tenants

VMware vSphere PowerCLI 5.1 Release 1 for Tenants Release Notes

VMware vSphere PowerCLI for Tenants provides a Windows PowerShell interface for the tenants of vCloud Director 1.5.1 environments. VMware vSphere PowerCLI for Tenants includes numerous cmdlets, sample scripts, and documentation.

This document contains the following information:

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 snapin 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.1 Release 1 for Tenants consists of two components:

  • vSphere PowerCLI common snapin for providing common PowerCLI configuration and usage based tasks, these cmdlets are part of the VMware.VimAutomation.Common snapin.
  • vCloud Director PowerCLI snapin for providing tenant-based reporting and automation, these cmdlets are part of the VMware.VimAutomation.Cloud snapin and can be used with vCloud Director 1.5.1 Tenant tasks.

Features

VMware vSphere PowerCLI 5.1 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.

Requirements

To use VMware vSphere PowerCLI for Tenants, you need to have installed the following software:

  • Windows PowerShell 2.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

Supported Platforms

VMware vSphere PowerCLI 5.1 Release 1 for Tenants works on the following operating systems:

  • Windows 7 Service Pack 1 (32-bit and 64-bit)
  • Windows Server 2008 R2 Service Pack 1
  • Windows Server 2008 Service Pack 1 (32-bit)
  • Windows XP Service Pack 3 (32-bit)
  • Windows XP Service Pack 2 (32-bit and 64-bit)
  • Windows Server 2003 R2 (32-bit and 64-bit)

VMware vSphere PowerCLI 5.1 Release 1 for Tenants is compatible with VMware vCloud Director 1.5.1.

Known Issues

VMware vSphere PowerCLI 5.1 Release 1 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.

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.

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

  1. Download VMware vSphere PowerCLI 5.1 Release 1 for Tenants.
  2. Navigate to the local folder that contains the PowerCLI for Tenants installer file you downloaded and double-click the executable file.
  3. On the Welcome page, click Next.
  4. On the VMware Patents page click Next.
  5. Accept the license agreement terms and click Next.
  6. On the Destination Folder page, select the location to install vSphere PowerCLI for Tenants and click Next.
  7. On the Ready to Install the Program page, click Install to proceed with the installation.
  8. Click Finish to complete the installation process.

For more information about installing PowerCLI 5.1 Release 1 for Tenants, see the VMware vSphere PowerCLI 5.1 for Tenants User's Guide.