Start-SCUpdateServerSynchronization
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