Share via

Set-SCUpdateServer

  • Reference
Module:
VirtualMachineManager

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

Syntax

Set-SCUpdateServer
   [-VMMServer <ServerConnection>]
   [-UpdateServer] <UpdateServer>
   [-UpdateLanguages <System.Collections.Generic.List`1[System.String]>]
   [-UpdateCategories <System.Collections.Generic.List`1[System.String]>]
   [-UpdateClassifications <System.Collections.Generic.List`1[System.String]>]
   [-ProxyCredential <PSCredential>]
   [-RunAsynchronously]
   [-PROTipID <Guid>]
   [-JobVariable <String>]
   [<CommonParameters>]
Set-SCUpdateServer
   [-VMMServer <ServerConnection>]
   [-UpdateServer] <UpdateServer>
   [-UpdateLanguages <System.Collections.Generic.List`1[System.String]>]
   [-UpdateCategories <System.Collections.Generic.List`1[System.String]>]
   [-UpdateClassifications <System.Collections.Generic.List`1[System.String]>]
   [-RunAsynchronously]
   [-PROTipID <Guid>]
   [-JobVariable <String>]
   [<CommonParameters>]
Set-SCUpdateServer
   [-VMMServer <ServerConnection>]
   [-UpdateServer] <UpdateServer>
   [-UpdateLanguages <System.Collections.Generic.List`1[System.String]>]
   [-UpdateCategories <System.Collections.Generic.List`1[System.String]>]
   [-UpdateClassifications <System.Collections.Generic.List`1[System.String]>]
   [-EnableProxy]
   -ProxyServerName <String>
   -ProxyServerPort <UInt32>
   -IsProxyAccessAnonymous <Boolean>
   [-ProxyCredential <PSCredential>]
   [-RunAsynchronously]
   [-PROTipID <Guid>]
   [-JobVariable <String>]
   [<CommonParameters>]
Set-SCUpdateServer
   [-VMMServer <ServerConnection>]
   [-UpdateServer] <UpdateServer>
   [-UpdateLanguages <System.Collections.Generic.List`1[System.String]>]
   [-UpdateCategories <System.Collections.Generic.List`1[System.String]>]
   [-UpdateClassifications <System.Collections.Generic.List`1[System.String]>]
   [-DisableProxy]
   [-RunAsynchronously]
   [-PROTipID <Guid>]
   [-JobVariable <String>]
   [<CommonParameters>]
Set-SCUpdateServer
   [-VMMServer <ServerConnection>]
   [-UpdateServer] <UpdateServer>
   -AllowConfigurationChanges <Boolean>
   [-RunAsynchronously]
   [-PROTipID <Guid>]
   [-JobVariable <String>]
   [<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
Position:Named
Default value:None
Required:True
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
Position:Named
Default value:None
Required:True
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
Position:Named
Default value:None
Required:True
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
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-JobVariable

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

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

-UpdateServer

Specifies a VMM update server object that this cmdlet modifies.

Type:UpdateServer
Position:0
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-VMMServer

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

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

Outputs

UpdateServer

This cmdlet returns an UpdateServer object.