Share via

Start-SCUpdateServerSynchronization

  • Article

Start-SCUpdateServerSynchronization

Initiates a synchronization between the VMM update server and WSUS.

Syntax

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

Detailed Description

The Start-SCUpdateServerSynchronization cmdlet initiates a 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. On subsequent synchronizations, an incremental import is performed by default. However, you can force a full catalog import at any time by using Start-SCUpdateServerSynchronization with the ForceFullUpdateCatalogImport parameter.

Parameters

-ForceFullUpdateCatalogImport

Indicates that the VMM update server will import the full update catalog from Windows Server Update Services. On subsequent synchronizations, an incremental import of the catalog is the default import.

Aliases

none

Required?

false

Position?

named

Default Value

none

Accept Pipeline Input?

false

Accept Wildcard Characters?

false

-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

-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

-UpdateServer<UpdateServer>

Specifies a VMM update server object.

Aliases

none

Required?

true

Position?

1

Default Value

none

Accept Pipeline Input?

True (ByValue)

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.

  • UpdateServer

Examples

Example 1: Start an update server synchronization

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

The second command starts synchronization between WSUSComputer01 and Microsoft Update.

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

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

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

The second command starts synchronization between WSUSComputer01 and Microsoft update, specifying that the full catalog is imported.

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

Get-SCUpdateServer