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.
Aliases |
none |
Required? |
false |
Position? |
named |
Default Value |
none |
Accept Pipeline Input? |
false |
Accept Wildcard Characters? |
false |
-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.
Aliases |
none |
Required? |
false |
Position? |
named |
Default Value |
none |
Accept Pipeline Input? |
false |
Accept Wildcard Characters? |
false |
-PROTipID<Guid>
Specifies the ID of the PRO tip that triggered this action. This allows for auditing of PRO tips.
Aliases |
none |
Required? |
false |
Position? |
named |
Default Value |
none |
Accept Pipeline Input? |
false |
Accept Wildcard Characters? |
false |
-RunAsynchronously
Indicates that the job runs asynchronously so that control returns to the command shell immediately.
Aliases |
none |
Required? |
false |
Position? |
named |
Default Value |
none |
Accept Pipeline Input? |
false |
Accept Wildcard Characters? |
false |
-VMMServer<ServerConnection>
Specifies a VMM server object.
Aliases |
none |
Required? |
false |
Position? |
named |
Default Value |
none |
Accept Pipeline Input? |
True (ByValue) |
Accept Wildcard Characters? |
false |
<CommonParameters>
This cmdlet supports the common parameters: -Verbose, -Debug, -ErrorAction, -ErrorVariable, -OutBuffer, and -OutVariable. For more information, see about_CommonParameters (https://go.microsoft.com/fwlink/p/?LinkID=113216).
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"