VMware

VMware vSphere PowerCLI 5.8 Release 1 for Tenants Release Notes

Released 09 September 2014

Build 2057893 is VMware vSphere PowerCLI 5.8 Release 1 for Tenants

VMware vSphere PowerCLI 5.8 Release 1 for Tenants Release Notes

VMware vSphere PowerCLI for Tenants provides a Windows PowerShell interface for the tenants of vCloud Director 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
  • What's New in This Release
  • Known Issues
  • Installing VMware vSphere PowerCLI 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.8 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 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 Tenant tasks.

    Features

    VMware vSphere PowerCLI 5.8 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

    For a list of software that you need if you want to work with VMware vSphere PowerCLI 5.8 Release 1 for Tenants, see Compatibility Matrixes for vSphere PowerCLI 5.8 Release 1.

    Supported Platforms

    For a list of VMware vSphere PowerCLI 5.8 Release 1 for Tenants supported operating systems and PowerShell versions, see Compatibility Matrixes for vSphere PowerCLI 5.8 Release 1.

    For a list of VMware vCloud Director versions with which VMware vSphere PowerCLI 5.8 Release 1 for Tenants is compatible, see VMware Product Interoperability Matrixes.

    What's New in This Release

    New Features

    vSphere PowerCLI 5.8 Release 1 for Tenants introduces the following new features and improvements:

    • You can now work with vCloud Director and vCloud Air with support for version 5.6.3 of the vCloud Director APIs.
    • VMware vSphere PowerCLI for Tenants has been extended to include the New-CIVM and Get-CIVMTemplate cmdlets.
    • The New-CIVapp cmdlet has been extended with a new parameter set, which allows you to create an empty vApp.
    • Other bug fixes and general performance enhancements have been made to various PowerCLI cmdlets.

    Known Issues

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

    • If you are logged in to vCloud Director 5.6.3 as a regular user or an organization administrator, you might not be able to retrieve CIView by ID for some of the cloud objects.
      Workaround: Pass the object to the Get-CIView 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

    1. Download VMware vSphere PowerCLI 5.8 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. Accept the license agreement terms and click Next.
    5. On the Destination Folder page, select the location to install vSphere PowerCLI for Tenants and click Next.
    6. On the Ready to Install the Program page, click Install to proceed with the installation.
    7. Click Finish to complete the installation process.

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