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.
Aliases |
none |
Required? |
true |
Position? |
named |
Default Value |
none |
Accept Pipeline Input? |
false |
Accept Wildcard Characters? |
false |
-DisableProxy
Indicates that this cmdlet disables the update server from using a proxy server when synchronizing updates.
Aliases |
none |
Required? |
true |
Position? |
named |
Default Value |
none |
Accept Pipeline Input? |
false |
Accept Wildcard Characters? |
false |
-EnableProxy
Indicates that this cmdlet enables the update server to use a proxy server when synchronizing updates.
Aliases |
none |
Required? |
true |
Position? |
named |
Default Value |
none |
Accept Pipeline Input? |
false |
Accept Wildcard Characters? |
false |
-IsProxyAccessAnonymous<Boolean>
Indicates whether the update server requires a proxy server to connect to the Internet.
Aliases |
none |
Required? |
true |
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 Performance and Resource Optimization tip (PRO tip) that triggered this action. This parameter lets you audit PRO tips.
Aliases |
none |
Required? |
false |
Position? |
named |
Default Value |
none |
Accept Pipeline Input? |
false |
Accept Wildcard Characters? |
false |
-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.
Aliases |
none |
Required? |
false |
Position? |
named |
Default Value |
none |
Accept Pipeline Input? |
false |
Accept Wildcard Characters? |
false |
-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.
Aliases |
none |
Required? |
true |
Position? |
named |
Default Value |
none |
Accept Pipeline Input? |
false |
Accept Wildcard Characters? |
false |
-ProxyServerPort<UInt32>
Specifies the port that the update server uses to communicate with the specified proxy server.
Aliases |
none |
Required? |
true |
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 |
-UpdateCategories<List`1>
Specifies one or more products that the update server synchronizes.
Aliases |
none |
Required? |
false |
Position? |
named |
Default Value |
none |
Accept Pipeline Input? |
false |
Accept Wildcard Characters? |
false |
-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
Aliases |
none |
Required? |
false |
Position? |
named |
Default Value |
none |
Accept Pipeline Input? |
false |
Accept Wildcard Characters? |
false |
-UpdateLanguages<List`1>
Specifies one or more supported update languages that the update server synchronizes.
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: 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"