Share via


Start-SCUpdateServerSynchronization

Starts syncrhronization between a VMM update server and WSUS.

Syntax

Default (Default)

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.

Parameter properties

Type:SwitchParameter
Default value:None
Supports wildcards:False
DontShow:False

Parameter sets

(All)
Position:Named
Mandatory:False
Value from pipeline:False
Value from pipeline by property name:False
Value from remaining arguments:False

-JobVariable

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

Parameter properties

Type:String
Default value:None
Supports wildcards:False
DontShow:False

Parameter sets

(All)
Position:Named
Mandatory:False
Value from pipeline:False
Value from pipeline by property name:False
Value from remaining arguments: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.

Parameter properties

Type:Guid
Default value:None
Supports wildcards:False
DontShow:False

Parameter sets

(All)
Position:Named
Mandatory:False
Value from pipeline:False
Value from pipeline by property name:False
Value from remaining arguments:False

-RunAsynchronously

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

Parameter properties

Type:SwitchParameter
Default value:None
Supports wildcards:False
DontShow:False

Parameter sets

(All)
Position:Named
Mandatory:False
Value from pipeline:False
Value from pipeline by property name:False
Value from remaining arguments:False

-UpdateServer

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

Parameter properties

Type:UpdateServer
Default value:None
Supports wildcards:False
DontShow:False

Parameter sets

(All)
Position:0
Mandatory:True
Value from pipeline:True
Value from pipeline by property name:False
Value from remaining arguments:False

-VMMServer

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

Parameter properties

Type:ServerConnection
Default value:None
Supports wildcards:False
DontShow:False

Parameter sets

(All)
Position:Named
Mandatory:False
Value from pipeline:True
Value from pipeline by property name:False
Value from remaining arguments:False

CommonParameters

This cmdlet supports the common parameters: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction, and -WarningVariable. For more information, see about_CommonParameters.

Outputs

UpdateServer

This cmdlet returns an UpdateServer object.