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
- Download and install vSphere PowerCLI 4.0 Update 1 from the VMware vSphere PowerCLI home page.
- Download vCenter Update Manager PowerCLI 4.0 Update 1 from the vCenter Update Manager PowerCLI home page.
- Launch the vCenter 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
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]
|