Set-SCUpdateServer
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 $LanguagesThe 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.