Set-SCUpdateServer

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

Syntax

Set-SCUpdateServer [-UpdateServer] <UpdateServer> -AllowConfigurationChanges <Boolean> [-JobVariable <String>]
 [-PROTipID <Guid>] [-RunAsynchronously] [-VMMServer <ServerConnection>] [<CommonParameters>]
Set-SCUpdateServer [-UpdateServer] <UpdateServer> [-DisableProxy] [-JobVariable <String>] [-PROTipID <Guid>]
 [-RunAsynchronously] [-UpdateCategories <System.Collections.Generic.List`1[System.String]>]
 [-UpdateClassifications <System.Collections.Generic.List`1[System.String]>]
 [-UpdateLanguages <System.Collections.Generic.List`1[System.String]>] [-VMMServer <ServerConnection>]
 [<CommonParameters>]
Set-SCUpdateServer [-UpdateServer] <UpdateServer> [-EnableProxy] -IsProxyAccessAnonymous <Boolean>
 [-JobVariable <String>] [-PROTipID <Guid>] [-ProxyCredential <PSCredential>] -ProxyServerName <String>
 -ProxyServerPort <UInt32> [-RunAsynchronously]
 [-UpdateCategories <System.Collections.Generic.List`1[System.String]>]
 [-UpdateClassifications <System.Collections.Generic.List`1[System.String]>]
 [-UpdateLanguages <System.Collections.Generic.List`1[System.String]>] [-VMMServer <ServerConnection>]
 [<CommonParameters>]
Set-SCUpdateServer [-UpdateServer] <UpdateServer> [-JobVariable <String>] [-PROTipID <Guid>]
 [-ProxyCredential <PSCredential>] [-RunAsynchronously]
 [-UpdateCategories <System.Collections.Generic.List`1[System.String]>]
 [-UpdateClassifications <System.Collections.Generic.List`1[System.String]>]
 [-UpdateLanguages <System.Collections.Generic.List`1[System.String]>] [-VMMServer <ServerConnection>]
 [<CommonParameters>]
Set-SCUpdateServer [-UpdateServer] <UpdateServer> [-JobVariable <String>] [-PROTipID <Guid>]
 [-RunAsynchronously] [-UpdateCategories <System.Collections.Generic.List`1[System.String]>]
 [-UpdateClassifications <System.Collections.Generic.List`1[System.String]>]
 [-UpdateLanguages <System.Collections.Generic.List`1[System.String]>] [-VMMServer <ServerConnection>]
 [<CommonParameters>]

Description

The Set-SCUpdateServer cmdlet configures a Microsoft Windows Server Update Services (WSUS) server that has been added to Virtual Machine Manager (VMM). For information about how to add a WSUS server to VMM, type Get-Help Add-SCUpdateServer.

Examples

Example 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 named WSUSComputer01, and then stores that 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. This command sets the proxy address and port and sets the update categories, classifications, and languages to synchronize.

Example 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 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.

Parameters

-AllowConfigurationChanges

Indicates whether configuration changes to the update server are allowed.

Type:Boolean
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 it synchronizes updates.

Type:SwitchParameter
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 it synchronizes updates.

Type:SwitchParameter
Required:True
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
-IsProxyAccessAnonymous

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

Type:Boolean
Required:True
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
-JobVariable

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

Type:String
Required:False
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters: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.

Type:Guid
Required:False
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
-ProxyCredential

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

Type:PSCredential
Required:False
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
-ProxyServerName

Specifies the name of the proxy server that the update server uses to connect with the Microsoft Update Catalog on the Internet. You cannot use special characters, such as a forward slash (/), in this parameter.

Type:String
Required:True
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
-ProxyServerPort

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

Type:UInt32
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.

Type:SwitchParameter
Required:False
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
-UpdateCategories

Specifies one or more products that the update server synchronizes.

Type:System.Collections.Generic.List`1[System.String]
Required:False
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
-UpdateClassifications

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

Type:System.Collections.Generic.List`1[System.String]
Required:False
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
-UpdateLanguages

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

Type:System.Collections.Generic.List`1[System.String]
Required:False
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
-UpdateServer

Specifies a VMM update server object that this cmdlet modifies.

Type:UpdateServer
Required:True
Position:0
Default value:None
Accept pipeline input:True (ByValue)
Accept wildcard characters:False
-VMMServer

Specifies a VMM server for which this cmdlet configures WSUS settings.

Type:ServerConnection
Required:False
Position:Named
Default value:None
Accept pipeline input:True (ByValue)
Accept wildcard characters:False

Outputs

UpdateServer

This cmdlet returns an **UpdateServer** object.