Set-SCUpdateServer

Applies To: System Center 2012 - Virtual Machine Manager

Set-SCUpdateServer

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

Syntax

Parameter Set: Default
Set-SCUpdateServer [-UpdateServer] <UpdateServer> [-JobVariable <String> ] [-PROTipID <Guid> ] [-ProxyCredential <PSCredential> ] [-RunAsynchronously] [-UpdateCategories <List<String>> ] [-UpdateClassifications <List<String>> ] [-UpdateLanguages <List<String>> ] [-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<String>> ] [-UpdateClassifications <List<String>> ] [-UpdateLanguages <List<String>> ] [-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<String>> ] [-UpdateClassifications <List<String>> ] [-UpdateLanguages <List<String>> ] [-VMMServer <ServerConnection> ] [ <CommonParameters>]

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

Detailed 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

-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

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

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 PRO tip that triggered this action. This allows for auditing of 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 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.

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 will use 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<String>>

Specifies one or more products that the update server will synchronize.

Aliases

none

Required?

false

Position?

named

Default Value

none

Accept Pipeline Input?

false

Accept Wildcard Characters?

false

-UpdateClassifications<List<String>>

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.

Aliases

none

Required?

false

Position?

named

Default Value

none

Accept Pipeline Input?

false

Accept Wildcard Characters?

false

-UpdateLanguages<List<String>>

Specifies one or more supported update languages that the update server will synchronize.

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.

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

1: Enable the proxy setting on an update server.

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.

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

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

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.

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

Add-SCUpdateServer

Get-SCUpdateServer

Remove-SCUpdateServer