PowerCLI Reference

Copy-Patch

Synopsis

This cmdlet initializes staging of patches.

Syntax

Copy-Patch [-Server <VIServer[]>] [-Entity] <InventoryItem[]> [-Baseline <PatchBaseline[]>] [-ExcludePatch <Patch[]>] [-RunAsync] [-WhatIf] [-Confirm] [<CommonParameters>]

Related Commands

Online version
Get-Patch
Sync-Patch

Detailed Description

This cmdlet initializes staging of patches. Staging allows you to download patches from the Update Manager server to the ESXi hosts, without applying the patches immediately. This functionality is supported only for VMHost, Cluster, and Datacenter objects.

Parameters

NameDescriptionRequired?Pipeline InputDefault Value
ServerSpecifies 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.falsefalse
EntitySpecifies VMHost, Cluster, and Datacenter objects for which you want to stage patches.truetrue (ByValue)
BaselineSpecifies patch baselines you want to stage.falsetrue (ByValue)
ExcludePatchSpecifies the patches you want to exclude from staging.falsetrue (ByValue)
RunAsyncIndicates that the command returns immediately without waiting for the task to complete. In this mode, the output of the cmdlet is a Task object. For more information about the -RunAsync parameter run "help About_RunAsync" in the vSphere PowerCLI console.falsefalse
WhatIfIndicates that the cmdlet is run only to display the changes that would be made and actually no objects are modified.falsefalse
ConfirmIndicates that the cmdlet asks for confirmation before running.falsefalse

Return Type

VMware.VimAutomation.Types.Task

Notes

Examples

-------------- Example 1 --------------

Copy-Patch -Entity Host

Stages all patches included in baselines attached to the entity named Host.


Copyright © 1998 - 2015 VMware, Inc. All rights reserved.