VMware

vCenter Update Manager PowerCLI Release Notes

Released 02-March-2010

Build 233997 is version 4.0 Update 1 of vCenter Update Manager PowerCLI.

vCenter Update Manager PowerCLI 4.0 Update 1 Release Notes

vCenter Update Manager PowerCLI provides an easy-to-use Windows Powershell interface to VMware vCenter Update Manager. vCenter Update Manager PowerCLI includes numerous cmdlets and sample scripts.

This document contains the following information:

About vCenter Update Manager PowerCLI

vCenter Update Manager PowerCLI is a command-line and scripting tool built on Windows PowerShell, and provides a set of cmdlets for managing and automating VMware vCenter Update Manager.

Requirements

To use vCenter Update Manager PowerCLI 4.0 Update 1, you need to have installed the following software:

  • .NET 2.0 Service Pack 1
  • VMware vSphere PowerCLI 4.0 Update 1

Update Manager PowerCLI 4.0 Update 1 works only with Update Manager 4.0 Update 1.

Supported Platforms

vCenter Update Manager PowerCLI 4.0 Update 1 works on the 32-bit and 64-bit versions of the following operating systems:

  • Windows Server 2008
  • Windows Vista
  • Windows XP Service Pack 2
  • Windows Server 2003 Service Pack 2

What's New in This Release?

This release of vSphere PowerCLI 4.0 Update 1 introduces the following new cmdlets:

Cmdlet Name Description
Stage-Patch Initializes staging of patches. Staging allows you to download patches from the Update Manager server to the ESX/ESXi hosts, without applying the patches immediately. This functionality is supported only for VMHost, Cluster, and Datacenter objects.

The following cmdlets have been renamed in this release:

New Cmdlet Name Old Cmdlet Name
Download-Patch Download-Update
Get-Patch Get-Update
Get-PatchBaseline Get-Baseline
New-PatchBaseline New-Baseline
Set-PatchBaseline Set-Baseline

The following parameters have been added to existing cmdlets in this release:

Cmdlet Name Parameter Name Description
New-PatchBaseline Extension Specify if the new patch baseline is Extension type. Do not use this parameter if the Dynamic parameter is set. Extension baselines can be only static (fixed) and are used to perform installation of extensions. An extension is any additional software that can be installed on the host or patched if the additional software already exists on the host.
Get-Compliance Server Specify the vSphere servers on which you want to run the cmdlet. If no value is given to this parameter, the command runs on the default servers.
ComplianceStatus Specify the compliance status you want to retrieve. The valid values are Compliant, NotCompliant, Unknown, and Incompatible.
Baseline Specify the baseline for which you want to retrieve the compliance status.
Detailed Specify that you want to retrieve detailed information about the compliance. For patch baselines, the patches with different statuses are listed. For VMware Tools upgrade baselines, the detailed information contains the VMware Tools status. For VM Hardware upgrade baseline, the recommended VM Hardware version and the current VM Hardware version are displayed.
Remediate-Inventory Server Specify the vSphere servers on which you want to run the cmdlet. If no value is given to this parameter, the command runs on the default servers.
Scan-Inventory Server Specify the vSphere servers on which you want to run the cmdlet. If no value is given to this parameter, the command runs on the default servers.
UpdateType Specify the type of the patches and upgrades you want to scan. The valid values are HostPatch, HostUpgrade, HostDVSUpgrade, VmPatch, VmHardwareUpgrade, VmToolsUpgrade, and VaUpgrade.
Detach-Baseline Server Specify the vSphere servers on which you want to run the cmdlet. If no value is given to this parameter, the command runs on the default servers.
Attach-Baseline Server Specify the vSphere servers on which you want to run the cmdlet. If no value is given to this parameter, the command runs on the default servers.
Get-Baseline TargetType Specify the target type of the baselines you want to retrieve. The valid values are VM, Host, and VA.
BaselineType Specify the type of the baselines you want to retrieve. The valid values are Patch (patch baselines) and Upgrade (upgrade baselines).
BaselineContentType Specify the content type of the baselines you want to retrieve. The valid values are Dynamic, Static, and Both.
Get-PatchBaseline TargetType Specify the target type of the patch baselines you want to retrieve. The valid values are VM, Host, and VA.
BaselineContentType Specify the content type of the patch baselines you want to retrieve. The valid values are Dynamic, Static, and Both.
Extension Specify that you want to retrieve only Extension patch baselines.

The following parameters have been renamed in this release:

Cmdlet Name New Parameter Name Old Parameter Name
Remediate-Inventory ExlcludePatch ExcludeUpdate
Set-PatchBaseline IncludePatch IncludeUpdate
ExcludePatch ExcludeUpdate
SearchPatchPhrase SearchUpdatePhrase
SearchPatchStartDate SearchUpdateStartDate
SearchPatchEndDate SearchUpdateEndDate
SearchPatchProduct SearchUpdateProduct
SearchPatchVendor SearchUpdateVendor
SearchPatchSeverity SearchUpdateSeverity
Get-PatchBaseline Patch Update

The following cmdlets have been modified in this release:

Cmdlet Change
Get-Baseline

Get-Baseline now returns all types of baselines:

  • Virtual machine and host patch baselines
  • Virtual machine, virtual appliance, and host upgrade baselines
  • Host extension baselines
Get-Patch The Server parameter of Get-Patch now accepts multiple VIServer objects.

New Dedicated VMTN Community Forum

vCenter Update Manager PowerCLI now has its own VMTN forum. To find additional resources and exchange ideas with other users, visit http://www.vmware.com/go/powercliupdate.

Obtaining the Software

You can obtain vCenter Update Manager PowerCLI 4.0 Update 1 at http://www.vmware.com/go/powercliupdate

Installing vCenter Update Manager PowerCLI

VMware provides a single installer for vCenter Update Manager PowerCLI.

To install vCenter Update Manager PowerCLI

  1. Download and install vSphere PowerCLI 4.0 Update 1 from the VMware vSphere PowerCLI home page.
  2. Download vCenter Update Manager PowerCLI 4.0 Update 1 from the vCenter Update Manager PowerCLI home page.
  3. Launch the vCenter Update Manager PowerCLI installer by double-clicking the executable file.
  4. In the Welcome page, click Next.
  5. Click Install to proceed with the installation.
  6. Click Finish to complete the installation process.

Known Issues

vCenter Update Manager PowerCLI 4.0 Update 1 is known to have the following issue:

Attach-Baseline

    When Attach-Baseline is run for baselines that are located on different servers, the baselines are attached only to the first entity found on each server.
    Workaround: First retrieve the baselines for each server individually and then attach them to the appropriate entities.

Set-PatchBaseline
  • For dynamic baselines created through the Update Manager PowerCLI, modifying the baseline with Set-PatchBaseline might result in adding patches that do not correspond to the baseline's target type (VM and Host).
    Workaround 1 (suggested by VMware): Edit dynamic patch baselines through vSphere Update Manager Client.
    Workaround 2 : Delete the patch baseline and create it again. In this case, you must restore all attachments manually.
  • Passing more than one baselines to Set-PatchBaseline results in an error and might cause unwanted baseline modifications.
    Workaround: Run Set-PatchBaseline separately for each baseline you want to modify.

Last updated 26-Feb-2010 11:30 am [PDT]