Add-SCPatch

Add-SCPatch

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

Syntax

Parameter Set: Default
Add-SCPatch [-JobVariable <String> ] [-PatchFilePath <String> ] [-PROTipID <Guid> ] [-RunAsynchronously] [-VMMServer <ServerConnection> ] [ <CommonParameters>]

Detailed Description

The Add-SCPatch cmdlet adds information about patches and binaries to the 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

Parameters

-JobVariable<String>

Specifies that job progress is tracked and stored in the variable named by this parameter.

-PatchFilePath<String>

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<Guid>

Specifies the ID of the PRO tip that triggered this action. This allows for auditing of PRO tips.

-RunAsynchronously

Indicates that the job runs asynchronously so that control returns to the command shell immediately.

-VMMServer<ServerConnection>

Specifies a VMM server object.

<CommonParameters>

This cmdlet supports the common parameters: -Verbose, -Debug, -ErrorAction, -ErrorVariable, -OutBuffer, and -OutVariable. For more information, see about_CommonParameters.

Inputs

The input type is the type of the objects that you can pipe to the cmdlet.

Outputs

The output type is the type of the objects that the cmdlet emits.

Examples

1: Add a new patch from the default patch import directory.

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.

PS C:\> Add-SCPatch -VMMServer "VMMServer01.Contoso.com"

Related topics

New-SCComputerConfiguration

New-SCP2V

New-SCV2V

New-SCVMXComputerConfiguration