Set-SCUpdateServer

Configures the settings of a Windows Server Update Services computer that has been added to VMM.

Description

The Set-SCUpdate Server cmdlet configurs the settings of a Microsoft Windows Server Update Services (WSUS) computer that has been added to System Center Virtual Machine Manager (VMM). Configuration settings that can be modified include: proxy server, proxy port, proxy credentials, languages, product categories, and classifications.

For more information about how to add a WSUS computer to VMM, type: "Get-Help Add-SCUpdateServer".

For more information about Set-SCUpdateServer, type: "Get-Help Set-SCUpdateServer -online".

Parameters

UpdateServer

Required? true
Accept Pipeline Input? true (ByValue)
Position? 0 
Specifies a VMM update server object.

AllowConfigurationChanges

Required? false
Accept Pipeline Input? false
Position? named 
Indicates whether configuration changes to the update server are allowed.

JobVariable

Required? false
Accept Pipeline Input? false
Position? named 
Specifies that job progress is tracked and stored in the variable named by this parameter.

PROTipID

Required? false
Accept Pipeline Input? false
Position? named 
Specifies the ID of the PRO tip that triggered this action. This allows for auditing of PRO tips.

RunAsynchronously

Required? false
Accept Pipeline Input? false
Position? named 
Indicates that the job runs asynchronously so that control returns to the command shell immediately.

VMMServer

Required? false
Accept Pipeline Input? true (ByValue)
Position? named 
Specifies a VMM server object.

UpdateServer

Required? true
Accept Pipeline Input? true (ByValue)
Position? 0 
Specifies a VMM update server object.

JobVariable

Required? false
Accept Pipeline Input? false
Position? named 
Specifies that job progress is tracked and stored in the variable named by this parameter.

PROTipID

Required? false
Accept Pipeline Input? false
Position? named 
Specifies the ID of the PRO tip that triggered this action. This allows for auditing of PRO tips.

ProxyCredential

Required? false
Accept Pipeline Input? false
Position? named 
Specifies a credential object that contains the user name and password of an account that has permission to communicate with the proxy server.

RunAsynchronously

Required? false
Accept Pipeline Input? false
Position? named 
Indicates that the job runs asynchronously so that control returns to the command shell immediately.

UpdateCategories

Required? false
Accept Pipeline Input? false
Position? named 
Specifies one or more products that the update server will synchronize.

UpdateClassifications

Required? false
Accept Pipeline Input? false
Position? named 
Specifies one or more update classifications that the update server will synchronize. Valid values are: Applications, Critical Updates, Definition Updates, Drivers, Feature Packs, Security Updates, Service Packs, Tools, Update Rollups, Updates.

UpdateLanguages

Required? false
Accept Pipeline Input? false
Position? named 
Specifies one or more supported update languages that the update server will synchronize.

VMMServer

Required? false
Accept Pipeline Input? true (ByValue)
Position? named 
Specifies a VMM server object.

UpdateServer

Required? true
Accept Pipeline Input? true (ByValue)
Position? 0 
Specifies a VMM update server object.

DisableProxy

Required? true
Accept Pipeline Input? false
Position? named 
Disables the update server from using a proxy server when synchronizing updates.

JobVariable

Required? false
Accept Pipeline Input? false
Position? named 
Specifies that job progress is tracked and stored in the variable named by this parameter.

PROTipID

Required? false
Accept Pipeline Input? false
Position? named 
Specifies the ID of the PRO tip that triggered this action. This allows for auditing of PRO tips.

RunAsynchronously

Required? false
Accept Pipeline Input? false
Position? named 
Indicates that the job runs asynchronously so that control returns to the command shell immediately.

UpdateCategories

Required? false
Accept Pipeline Input? false
Position? named 
Specifies one or more products that the update server will synchronize.

UpdateClassifications

Required? false
Accept Pipeline Input? false
Position? named 
Specifies one or more update classifications that the update server will synchronize. Valid values are: Applications, Critical Updates, Definition Updates, Drivers, Feature Packs, Security Updates, Service Packs, Tools, Update Rollups, Updates.

UpdateLanguages

Required? false
Accept Pipeline Input? false
Position? named 
Specifies one or more supported update languages that the update server will synchronize.

VMMServer

Required? false
Accept Pipeline Input? true (ByValue)
Position? named 
Specifies a VMM server object.

UpdateServer

Required? true
Accept Pipeline Input? true (ByValue)
Position? 0 
Specifies a VMM update server object.

EnableProxy

Required? true
Accept Pipeline Input? false
Position? named 
Enables the update server to use a proxy server when synchronizing updates.

IsProxyAccessAnonymous

Required? true
Accept Pipeline Input? false
Position? named 
Indicates whether the update server requires a proxy server to connect to the Internet.

ProxyServerName

Required? true
Accept Pipeline Input? false
Position? named 
Specifies the name of the proxy server that the update server will use to connect with the Microsoft Update Catalog on the Internet.  

Example format: -ProxyServerName "proxy.contoso.com"

NOTE: Special characters (such as a forward slash "/") cannot be used with this parameter.

ProxyServerPort

Required? true
Accept Pipeline Input? false
Position? named 
Specifies the port that the update server will use to communicate with the specified proxy server.

JobVariable

Required? false
Accept Pipeline Input? false
Position? named 
Specifies that job progress is tracked and stored in the variable named by this parameter.

PROTipID

Required? false
Accept Pipeline Input? false
Position? named 
Specifies the ID of the PRO tip that triggered this action. This allows for auditing of PRO tips.

ProxyCredential

Required? false
Accept Pipeline Input? false
Position? named 
Specifies a credential object that contains the user name and password of an account that has permission to communicate with the proxy server.

RunAsynchronously

Required? false
Accept Pipeline Input? false
Position? named 
Indicates that the job runs asynchronously so that control returns to the command shell immediately.

UpdateCategories

Required? false
Accept Pipeline Input? false
Position? named 
Specifies one or more products that the update server will synchronize.

UpdateClassifications

Required? false
Accept Pipeline Input? false
Position? named 
Specifies one or more update classifications that the update server will synchronize. Valid values are: Applications, Critical Updates, Definition Updates, Drivers, Feature Packs, Security Updates, Service Packs, Tools, Update Rollups, Updates.

UpdateLanguages

Required? false
Accept Pipeline Input? false
Position? named 
Specifies one or more supported update languages that the update server will synchronize.

VMMServer

Required? false
Accept Pipeline Input? true (ByValue)
Position? named 
Specifies a VMM server object.

UpdateServer

Required? true
Accept Pipeline Input? true (ByValue)
Position? 0 
Specifies a VMM update server object.

JobVariable

Required? false
Accept Pipeline Input? false
Position? named 
Specifies that job progress is tracked and stored in the variable named by this parameter.

PROTipID

Required? false
Accept Pipeline Input? false
Position? named 
Specifies the ID of the PRO tip that triggered this action. This allows for auditing of PRO tips.

RunAsynchronously

Required? false
Accept Pipeline Input? false
Position? named 
Indicates that the job runs asynchronously so that control returns to the command shell immediately.

UpdateCategories

Required? false
Accept Pipeline Input? false
Position? named 
Specifies one or more products that the update server will synchronize.

UpdateClassifications

Required? false
Accept Pipeline Input? false
Position? named 
Specifies one or more update classifications that the update server will synchronize. Valid values are: Applications, Critical Updates, Definition Updates, Drivers, Feature Packs, Security Updates, Service Packs, Tools, Update Rollups, Updates.

UpdateLanguages

Required? false
Accept Pipeline Input? false
Position? named 
Specifies one or more supported update languages that the update server will synchronize.

VMMServer

Required? false
Accept Pipeline Input? true (ByValue)
Position? named 
Specifies a VMM server object.

Examples

1: Enable the proxy setting on an update server. 
PS C:\> $UpdateServer = Get-SCUpdateServer -ComputerName "WSUSComputer01"
PS C:\> $Categories = @("SQL Server", "Windows")
PS C:\> $Classifications = @("Security Updates", "Service Packs")
PS C:\> $Languages = @("en", "pt-br") 
PS C:\> Set-SCUpdateServer –UpdateServer $UpdateServer -EnableProxy –ProxyServerName "proxy.contoso.com" -ProxyServerPort "88" -IsProxyAccessAnonymous $True -UpdateCategories $Categories -UpdateClassifications $Classifications -UpdateLanguages $Languages

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

The second command creates an array named $Categories and populates the array with two products.

The third command creates an array named $Classification and populates the array with two update classifications.

The fourth command creates an array named $Languages and populates the array with two supported update languages, English and Brazilian Portuguese. 

The last command enables the proxy setting for the update server stored in $UpdateServer, sets the proxy address and port, and sets the update categories, classifications, and languages to synchronize.
2: Specify a new product type setting for an update server. 
PS C:\> $UpdateServer = Get-SCUpdateServer -ComputerName "WSUSComputer01"
PS C:\> Set-SCUpdateServer –UpdateServer $UpdateServer –UpdateClassifications “Service Packs”


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

The second command enables the service packs update classification for the update server stored in $UpdateServer.

See Also