ISubscription.StartSynchronization()

Article
08/07/2009

Starts the WSUS server synchronization process.

public void StartSynchronization();

Public Sub StartSynchronization()
Implements ISubscription.StartSynchronization

Parameters

This method has no parameters.

Return Value

This method does not return a value.

Exceptions

Exception type	Condition
System.InvalidOperationException	The subscription cannot be started either because of its current state or because WSUS is currently saving server configuration changes.

Remarks

Use this method to manually start the synchronization agent (the agent runs in a separate process). To schedule synchronization to occur every day at a specific time, call ISubscription.SynchronizeAutomatically and ISubscription.SynchronizeAutomaticallyTimeOfDay.

Note that it can take a long time to synchronize the updates. The amount of time depends on the number of categories and classifications to synchronize, the time since you last synchronized, and the available network bandwidth.

To determine the status and progress of the synchronization process, call ISubscription.GetSynchronizationStatus and ISubscription.GetSynchronizationProgress, respectively.

WSUS synchronizes only new updates (or the latest new revision of an update) that were published since the last time you synchronized the updates.

Requirements

Server	Requires Windows Server 2003 or Windows 2000 Server SP4 and later.
Namespace	Defined in Microsoft.UpdateServices.Administration.
Assembly	Requires Microsoft.UpdateServices.Administration (in Microsoft.UpdateServices.Administration.dll).
.NET Framework	Requires .NET Framework 1.1.