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

Name	Description	Required?	Pipeline Input
Server	Specifies 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.	false	false
Entity	Specifies VMHost, Cluster, and Datacenter objects for which you want to stage patches.	true	true (ByValue)
Baseline	Specifies patch baselines you want to stage.	false	true (ByValue)
ExcludePatch	Specifies the patches you want to exclude from staging.	false	true (ByValue)
RunAsync	Indicates 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.	false	false
WhatIf	Indicates that the cmdlet is run only to display the changes that would be made and actually no objects are modified.	false	false
Confirm	Indicates that the cmdlet asks for confirmation before running.	false	false

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.