Set-SCUpdateServer

Set-SCUpdateServer

Configures the settings of a WSUS computer that has been added to VMM.

Syntax

Parameter Set: Default
Set-SCUpdateServer [-UpdateServer] <UpdateServer> [-JobVariable <String> ] [-PROTipID <Guid]> ] [-ProxyCredential <PSCredential> ] [-RunAsynchronously] [-UpdateCategories <List`1> ] [-UpdateClassifications <List`1> ] [-UpdateLanguages <List`1> ] [-VMMServer <ServerConnection> ] [ <CommonParameters>]

Parameter Set: ConfigSettingsChange
Set-SCUpdateServer [-UpdateServer] <UpdateServer> -AllowConfigurationChanges <Boolean> [-JobVariable <String> ] [-PROTipID <Guid]> ] [-RunAsynchronously] [-VMMServer <ServerConnection> ] [ <CommonParameters>]

Parameter Set: DisableProxy
Set-SCUpdateServer [-UpdateServer] <UpdateServer> -DisableProxy [-JobVariable <String> ] [-PROTipID <Guid]> ] [-RunAsynchronously] [-UpdateCategories <List`1> ] [-UpdateClassifications <List`1> ] [-UpdateLanguages <List`1> ] [-VMMServer <ServerConnection> ] [ <CommonParameters>]

Parameter Set: EnableProxy
Set-SCUpdateServer [-UpdateServer] <UpdateServer> -EnableProxy -IsProxyAccessAnonymous <Boolean> -ProxyServerName <String> -ProxyServerPort <UInt32> [-JobVariable <String> ] [-PROTipID <Guid]> ] [-ProxyCredential <PSCredential> ] [-RunAsynchronously] [-UpdateCategories <List`1> ] [-UpdateClassifications <List`1> ] [-UpdateLanguages <List`1> ] [-VMMServer <ServerConnection> ] [ <CommonParameters>]

Parameter Set: ManualSync
Set-SCUpdateServer [-UpdateServer] <UpdateServer> [-JobVariable <String> ] [-PROTipID <Guid]> ] [-RunAsynchronously] [-UpdateCategories <List`1> ] [-UpdateClassifications <List`1> ] [-UpdateLanguages <List`1> ] [-VMMServer <ServerConnection> ] [ <CommonParameters>]

Detailed Description

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

Parameters

-AllowConfigurationChanges<Boolean>

Indicates whether configuration changes to the update server are allowed.

-DisableProxy

Indicates that this cmdlet disables the update server from using a proxy server when synchronizing updates.

-EnableProxy

Indicates that this cmdlet enables the update server to use a proxy server when synchronizing updates.

-IsProxyAccessAnonymous<Boolean>

Indicates whether the update server requires a proxy server to connect to the Internet.

-JobVariable<String>

Specifies that job progress is tracked and stored in the variable named by this parameter.

-PROTipID<Guid]>

Specifies the ID of the Performance and Resource Optimization tip (PRO tip) that triggered this action. This parameter lets you audit PRO tips.

-ProxyCredential<PSCredential>

Specifies a credential object that contains the user name and password of an account that has permission to communicate with the proxy server.

-ProxyServerName<String>

Specifies the name of the proxy server that the update server uses to connect with the Microsoft Update Catalog on the Internet.

You cannot specify special characters such as a forward slash (/) in this parameter.

-ProxyServerPort<UInt32>

Specifies the port that the update server uses to communicate with the specified proxy server.

-RunAsynchronously

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

-UpdateCategories<List`1>

Specifies one or more products that the update server synchronizes.

-UpdateClassifications<List`1>

Specifies one or more update classifications that the update server synchronizes. Valid values are:

-- Applications
-- Critical Updates
-- Definition Updates
-- Drivers
-- Feature Packs
-- Security Updates
-- Service Packs
-- Tools
-- Update Rollups
-- Updates

-UpdateLanguages<List`1>

Specifies one or more supported update languages that the update server synchronizes.

-UpdateServer<UpdateServer>

Specifies a VMM update server object.

-VMMServer<ServerConnection>

Specifies a VMM server object.

<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: Enable the proxy setting on an update server

The first command gets the update server object named WSUSComputer01, and then 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.

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

Example 2: Specify a new product type setting for an update server

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

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

PS C:\> $UpdateServer = Get-SCUpdateServer -ComputerName "WSUSComputer01"
PS C:\> Set-SCUpdateServer -UpdateServer $UpdateServer -UpdateClassifications "Service Packs" 

Related topics

Add-SCUpdateServer

Get-SCUpdateServer

Remove-SCUpdateServer