VMware vSphere Update Manager PowerCLI Release Notes
Released 24 August 2011
Build 432001 is VMware vSphere Update Manager PowerCLI 5.0.
VMware vSphere Update Manager PowerCLI 5.0 Release Notes
VMware vSphere Update Manager PowerCLI provides an easy-to-use Windows Powershell interface to VMware vSphere Update Manager. Update Manager PowerCLI includes numerous cmdlets and sample scripts.
This document contains the following information:
|
About VMware vSphere Update Manager PowerCLI
VMware vSphere 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 vSphere Update Manager.
Requirements
To use Update Manager PowerCLI 5.0, you need to have installed the following software:
- .NET 2.0 Service Pack 1
- VMware vSphere PowerCLI 5.0
Update Manager PowerCLI 5.0 works only with Update Manager 5.0.
Supported Platforms
VMware vSphere Update Manager PowerCLI 5.0 works on the 32-bit and 64-bit versions of the following operating systems:
- Windows 7
- Windows Server 2008
- Windows Vista
- Windows XP Service Pack 2
- Windows Server 2003 Service Pack 2
What's New in This Release?
The following parameters have been added to existing cmdlets in this release:
| Cmdlet Name |
Parameter Name |
Description |
Remediate-Inventory |
HostPreRemediationPowerAction |
Specify an action before trying to enter the host into a maintenance mode. The valid values are PowerOffVMs, SuspendVMs, and DoNotChangeVMsPowerState. |
ClusterEnableParallelRemediation |
Indicate that you want to enable parallel remediation for the specified clusters. |
HostIgnoreThirdPartyDrivers |
Indicate that you want to ignore installed third-party software that is incompatible with the upgrade. |
HostEnablePXEbootHostPatching |
Indicate that you want to enable PXE booted ESXi hosts patching. |
Get-Patch |
Category |
Specify the categories of the patches you want to retrieve. The valid values are SecurityFix, BugFix, Enhancement, and Other. |
New-PatchBaseline |
SearchPatchCategory |
Specify the categories of the patches you want to include in the new baseline. The valid values are SecurityFix, BugFix, Enhancement, and Other. |
Set-PatchBaseline |
SearchPatchCategory |
Specify the category of the patches you want to include in the new baseline. The valid values are SecurityFix, BugFix, Enhancement, and Other. |
Obtaining the Software
You can obtain the VMware vSphere Update Manager PowerCLI 5.0 from here.
Installing VMware vSphere Update Manager PowerCLI
VMware provides a single installer for Update Manager PowerCLI.
To install Update Manager PowerCLI
- Download and install vSphere PowerCLI from .
- Download Update Manager PowerCLI.
- Launch the Update Manager PowerCLI installer by double-clicking the executable file.
- In the Welcome page, click Next.
- Click Install to proceed with the installation.
- Click Finish to complete the installation process.
Known Issues
Update Manager PowerCLI 5.0 is known to have the following issues:
Attach-Baseline
The text of the error message that appears when you try to attach a baseline to a non-existing entity is improper.
Resolved Issues
The following issues have been resolved in Update Manager PowerCLI 5.0:
Remediate-Inventory
-
When running
Remediate-Inventory without specifying a value for the HostPreRemediationPowerAction parameter, the remediation fails.
Workaround: Always provide a value for the HostPreRemediationPowerAction parameter when using Remediate-Inventory.
-
If you pass to the
Baseline parameter of Remediate-Inventory an array that contains non-existing baselines, the cmdlet skips the non-existing baselines and runs without showing an error message.
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).
-
Passing more than one baselines to
Set-PatchBaseline results in an error and might cause unwanted baseline modifications.
Set-PatchBaseline returns no error when you update a baseline with the name of an existing predefined baseline.
General
-
The 32-bit version of Update Manager PowerCLI 5.0 cannot install on Windows XP 64-bit.
-
The Update Manager PowerCLI 5.0 installer does not notify the user if the detected version of vSphere PowerCLI is not supported.
-
Update Manager PowerCLI 5.0 does not verify the server certificate when connecting to an Update Manager server.
|