General

New Release: VMware PowerCLI 6.5.2

The past couple releases have introduced some new and exciting modernizations for PowerCLI. We’ve moved from Snapins to Modules, leaving behind registry settings and the need for an installer and making packaging much easier. We then introduced you to PowerCLI installation through the Microsoft PowerShell Gallery, making installation and updates a single command.

All of these lead up to us delivering more frequent releases and more timely features and bugfixes. Only three months ago, we introduced PowerCLI 6.5.1, and today we’re delivering 6.5.2, cutting our release time in half from the past. We still have a lot of work to do on our processes, but we look forward to delivering frequent, high quality releases of the best automation library for VMware!

PowerCLI 6.5.2 has some great improvements. They come in three main areas:

  • Addition of the ‘InventoryLocation’ parameter to the following cmdlets: Move-VM, Import-VApp, New-VApp
  • Ability to mount a Content Library sourced ISO with the New-CDDrive cmdlet
  • Updated Support Around Experimental Features

Let’s take a closer look at each of these.

New Parameter: InventoryLocation

The main purpose of the ‘InventoryLocation’ parameter is to specify a folder the VM or vApp should be placed during their related actions. The expected input for this parameter is a type of ‘FolderContainer’. Previously, the only option was ‘Destination’ and it accepted a folder, ESXi host, cluster, or resource pool. The issue was only one item could be specified at a time. Therefore, this addition is nice because it reduces the total number of steps needed to either move a VM between vCenter Servers or when deploying a new VM/vApp.

First example, moving a VM between vCenter Servers. By default, the VM would be moved to the root of the Datacenter in the ‘VMs and Templates’ view. Technically, it would be moved to the ‘vm’ folder but that’s hidden from the GUI view. This new parameter allows us to skip the follow-up ‘Move-VM’ command and place the VM in the proper folder at time of the migration.

Cross vCenter vMotion Example using Inventory Location Parameter

Second example, creating a new VM by importing a vApp. As with the previous example, this cuts down the steps in deploying this VM and streamlines the process.

Import-VApp example while using the Inventory Location parameter

Using Content Library Sourced ISOs

The ‘New-CDDrive’ cmdlet has a new parameter by the name of ‘ContentLibraryIso’. This allows us to mount an ISO which has been presented through vSphere’s Content Library. Here’s an example:

Example usage of the New-CDDrive cmdlet and Content Library ISOs

vSphere’s Content Library is a great resource and I’m really happy to be able to take better advantage of it through PowerCLI!

Experimental Feature Updates

If you’ve had the chance to read through our documentation, perhaps you’ve noticed a couple of the features or parameters which were marked as experimental. Several of these have been tested and we have been able to remove the functionality’s ‘experimental’ messaging.

Some Examples:

  • Set-HardDisk -ZeroOut: This parameter can be used to zero out a disk when the PowerCLI session is connected directly to the ESXi host.
  • New-HardDisk -AdvancedSetting: The experimental part of this parameter was centered around the Storage Distributed Resource Scheduler (SDRS) rule association.
  • New-VM -AdvancedSetting: The experimental part of this parameter was centered around the SDRS (SDRS) rule association.
  • Install-VMHostPatch: The whole cmdlet was experimental and has been approved for supported usage.

Summary

PowerCLI 6.5.2 is the first of our change to having more frequent releases. While these iterative releases may not be as packed full of new features as all the prior releases, we are able to provide new functionality and resolve any issues faster than prior versions. Some proof of that is the addition of the ‘InventoryLocation’ parameter to several cmdlets, the ‘ContentLibraryIso’ parameter to the New-CDDrive cmdlet, and taking several features and cmdlets from experimental to supported!

Don’t wait, Update-Module today!

Update Module Example

For information on the Microsoft PowerShell Gallery update process, see the following blog: Update PowerCLI From the PowerShell Gallery

For more information on changes made in VMware PowerCLI 6.5.2, including improvements, security enhancements, and deprecated features, see the VMware PowerCLI Change Log. For more information on specific cmdlets, see the VMware PowerCLI 6.5.2 Cmdlet Reference.

Kyle Ruddy

Kyle Ruddy is a Senior Technical Marketing Engineer working for VMware R&D in the Cloud Platform Business Unit. Kyle currently focuses on vSphere automation and the associated automation frameworks including all…

Related Articles

Comments

38 comments have been added so far

  1. Pingback: Updating PowerCLI through the PowerShell Gallery - VMware PowerCLI Blog - VMware Blogs

  2. great update 🙂
    Is there a reason for not having the -InventoryLocation on New-VM? ex. when importing a vm to the repository with the -VMFilePath param.

    Reply

    1. Have you tried using the ‘Location’ parameter? That should be the where you want to specify the folder while using the New-VM cmdlet.

      For consistency’s sake, I agree there should be a InventoryLocation parameter added and I will be making a feature request to get that added. I just want to make sure we’re not missing anything functionality wise as it is.

      Thanks!

      Reply

      1. Hi Kyle,
        thanks for the reply. I’m not sure why I didn’t use the -location.. I have considered it as param as -Destination is for Move-VM, so thanks for the heads up 🙂
        Still.. I’m looking forward to have the -InventoryLocation for consistency 🙂
        Great work with the posts.

        regards
        Kenneth

        Reply
  3. Pingback: Updating PowerCLI through the PowerShell Gallery – VMpro.at
  4. Pingback: New Release: VMware PowerCLI 6.5.2 – VMpro.at
  5. Pingback: VMware PowerCLI 6.5.2 released | Virtual Allan

  6. Hi Kyle!

    Thanks for the update and nice article.
    I have a question about SDRS rules. Currently I have to create them by creating some custom objects, but really want to have standard cpmmand like New-SDRSRule or something like this. Is there any chance to have this implemented?

    Best regards,
    Sergey Sypalo

    Reply

  8. Norton, one of the largest security products providers, has made it quite easy to protect your computer system from the malicious online activities, viruses, Trojan horses, scams and other threats. By installing a Norton setup to your device, you can be sure of the privacy of your important files as well as confidential information. Be it a business or consumer, Norton offers a special security software to suit the needs of everyone. You can choose anyone from the following:

    Reply

  9. Hey Kyle,

    Thanks for all this information. I am attempting to do a Get-ViEvent in this release and it returns an error: “Error in deserializing body of reply message for operation on ‘ReadPreviousEvents'”

    Any ideas with this? I tested on 6.5 Release 1 and this is working.

    Regards,
    Paddy.

    Reply

  10. Receiving below error message when tried to access older vievents

    et-VIEvent : 12/29/2017 3:06:16 PM Get-VIEvent Error in deserializing body of reply message for operation ‘RetrieveProperties’.
    + CategoryInfo : NotSpecified: (:) [Get-VIEvent], VimException
    + FullyQualifiedErrorId : Core_BaseCmdlet_UnknownError,VMware.VimAutomation.ViCore.Cmdlets.Commands.GetEvent

    Reply

  11. in powercli 6.5.4.7

    Get-VIEvent : 1/9/2018 4:32:17 PM Get-VIEvent Error in deserializing body of reply message for operation ‘ReadPreviousEvents’.
    At D:\InitialNewHost.ps1:1703 char:19
    + … hostevents = Get-VIEvent -start 01/08/2018 -finish 01/09/2018 | where …
    + ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
    + CategoryInfo : NotSpecified: (:) [Get-VIEvent], VimException
    + FullyQualifiedErrorId : Core_BaseCmdlet_UnknownError,VMware.VimAutomation.ViCore.Cmdlets.Commands.GetEvent

    Reply

  12. contact microsoft support Microsoft and its suite of products are known to be quality-based in every aspect, and more often than not businesses revolve around Microsoft Office suite. To the healthy running of not only big businesses but also small businesses and home users, it is essential that all systems work in an efficient manner. At times you could experience inconveniences or mishaps with any of its products or services rendered by this company, and at the same time, you could rely on Microsoft Tech Support Service to get your issue resolved in an efficient manner.

    Reply

  17. Garmin.com/express – Garmin Express is an application which provides the ability to access, control and manage all other Garmin devices from one place. Furthermore, using Garmin.com/express you can manage your device downloads and updates. In addition, you can sync all your fitness data or other information and ensure accurate navigation even on streets.

    Reply

  19. PowerCLI D:\> foreach ($i in 1..9){Start-vm -vm z1-00$i }
    Start-vm : 2018/8/31 20:58:35 Start-VM 调用的目标发生了异常。
    所在位置 行:1 字符: 22
    + foreach ($i in 1..9){Start-vm -vm z1-00$i }
    + ~~~~~~~~~~~~~~~~~~~~
    + CategoryInfo : NotSpecified: (:) [Start-VM], VimException
    + FullyQualifiedErrorId : Core_BaseCmdlet_UnknownError,VMware.VimAutomation.ViCore.Cmdlets.Commands.StartVM
    怎么解决？谢谢

    Reply

  25. Quality, Durability, Affordability; that’s our promise. The Unique Builds, LLC team is family owned, operated and always striving for perfection. We are committed to building quality storage and providing great customer service.

    Reply

  28. This is an excellent post. Thanks for sharing it with us. I loved the way you introduced it. I enjoyed reading this article. I got a lot out of it. Thank you!

    Reply

Leave a Reply

Your email address will not be published.