Share via

Start-SCUpdateServerSynchronization

  • Reference
Module:
VirtualMachineManager

Starts syncrhronization between a VMM update server and WSUS.

Syntax

Start-SCUpdateServerSynchronization
     [-VMMServer <ServerConnection>]
     [-UpdateServer] <UpdateServer>
     [-ForceFullUpdateCatalogImport]
     [-RunAsynchronously]
     [-PROTipID <Guid>]
     [-JobVariable <String>]
     [<CommonParameters>]

Description

The Start-SCUpdateServerSynchronization cmdlet starts synchronization between the Virtual Machine Manager (VMM) update server and Windows Server Update Services (WSUS).

The first time this synchronization runs, it imports the full WSUS update catalog into VMM. By default, after the first synchronization, this cmdlet performs an incremental import. To force a full catalog import, specify the ForceFullUpdateCatalogImport parameter.

Examples

Example 1: Start an update server synchronization

PS C:\> $UpdateServer = Get-SCUpdateServer -ComputerName "WSUSComputer01"
PS C:\> Start-SCUpdateServerSynchronization -UpdateServer $UpdateServer

The first command gets the update server named WSUSComputer01, and then stores that object in the $UpdateServer variable.

The second command starts synchronization between WSUSComputer01 and Microsoft Update.

Example 2: Start a full import of the Microsoft Update Catalog

PS C:\> $UpdateServer = Get-SCUpdateServer -ComputerName "WSUSComputer01"
PS C:\> Start-SCUpdateServerSynchronization -UpdateServer $UpdateServer -ForceFullUpdateCatalogImport

The first command gets the update server named WSUSComputer01, and then stores that object in the $UpdateServer variable.

The second command starts synchronization between WSUSComputer01 and Microsoft Update. The command specifies that the full catalog is imported.

Parameters

-ForceFullUpdateCatalogImport

Indicates that the VMM update server imports the full update catalog from WSUS. By default, after the first synchronization, this cmdlet performs an incremental import.

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-JobVariable

Specifies a variable in which job progress is tracked and stored.

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-PROTipID

Specifies the ID of the Performance and Resource Optimization tip (PRO tip) that triggered this action. This parameter lets you audit PRO tips.

Type:Guid
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-RunAsynchronously

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

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-UpdateServer

Specifies a VMM update server that this cmdlet synchronizes to WSUS.

Type:UpdateServer
Position:0
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-VMMServer

Specifies a VMM server for which this cmdlet synchronizes the VMM update server.

Type:ServerConnection
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

Outputs

UpdateServer

This cmdlet returns an UpdateServer object.