Add-SCPatch

Adds information about patches and binaries to the VMM patch cache.

Description

The Add-SCPatch cmdlet adds information about patches and binaries to the System Center Virtual Machine Manager (VMM) patch cache. Patches are required for physical-to-virtual machine conversions (P2V conversions) as well as for virtual-to-virtual machine conversions (V2V conversions).

The Add-SCPatch cmdlet updates the VMM database with information about patches and extracts required binaries to the following folder (default location): C:\Program Files\Microsoft System Center 2012\Virtual Machine Manager\VMMData

To determine which patches are required for a particular conversion, run the appropriate cmdlet to gather information about the source:

- New-SCComputerConfiguration for P2V conversions
- New-SCVMXComputerConfiguration for V2V conversions

For more information about Add-SCPatch, type: "Get-Help Add-SCPatch -online".

Parameters

JobVariable

Required? false
Accept Pipeline Input? false
Position? named
Specifies that job progress is tracked and stored in the variable named by this parameter. 

PatchFilePath

Required? false
Accept Pipeline Input? false
Position? named
Specifies the path to a folder on the file system where VMM is installed or to a network share where P2V or V2V patch files are located.

PROTipID

Required? false
Accept Pipeline Input? false
Position? named
Specifies the ID of the PRO tip that triggered this action. This allows for auditing of PRO tips.

RunAsynchronously

Required? false
Accept Pipeline Input? false
Position? named
Indicates that the job runs asynchronously so that control returns to the command shell immediately. 

VMMServer

Required? false
Accept Pipeline Input? true (ByValue)
Position? named
Specifies a VMM server object.

Examples

1: Add a new patch from the default patch import directory.
PS C:\> Add-SCPatch -VMMServer "VMMServer01.Contoso.com"
Before running the commands illustrated in this example, place any patch files (.cab or .exe files) into the Patch Cache folder located in the VMM installation directory on the VMM server. The default location is:

C:\Program Files\Microsoft System Center 2012\Virtual Machine Manager\Patch Import

This command extracts any patches found in the Patch Import folder and adds these patches to the VMM patch cache on VMMServer01.

NOTE: The patch files will automatically be deleted from the Patch Import folder after they are successfully added to the patch cache.

See Also