## 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 | Default Value
--- | --- | --- | --- | ---
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.

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