ISubscription.SetUpdateCategories Method (UpdateCategoryCollection)

Applies To: Windows Server Update Services

Sets the categories of updates that you want the WSUS server to synchronize.

Namespace:   Microsoft.UpdateServices.Administration
Assembly:  Microsoft.UpdateServices.Administration (in Microsoft.UpdateServices.Administration.dll)

Syntax

void SetUpdateCategories(
    UpdateCategoryCollection updateCategories
)

void SetUpdateCategories(
    UpdateCategoryCollection^ updateCategories
)

abstract SetUpdateCategories : 
        updateCategories:UpdateCategoryCollection -> unit

Sub SetUpdateCategories (
    updateCategories As UpdateCategoryCollection
)

Parameters

• updateCategories
  Type: Microsoft.UpdateServices.Administration.UpdateCategoryCollection

  An UpdateCategoryCollection collection of the categories of updates to synchronize.

Exceptions

Exception

Condition

ArgumentNullException

categories cannot be null.

Remarks

To use the specified categories in the synchronization process, you must call.Save.

Note that the categories of a downstream server are determined by the upstream server; WSUS ignores the categories that you specify on a downstream server (when SyncFromMicrosoftUpdate is false).

You should not include related parent-child categories in the collection. For example, you should not include the Windows product family category and the Windows Server 2003 product in the same collection. However, you can specify the Office product family category and the Windows Server 2003 product category in the same collection because they are not related. If the collection contains related parent-child categories, WSUS ignores the child categories and synchronizes all the products for the parent category. For example, if the collection includes both the Windows product family category and the Windows Server 2003 product category, WSUS synchronizes all the Windows products.

If the collection contains a company category, all the products for that company are synchronized. If the collection contains a product family category, all products for that product family are synchronized. If the collection contains a company category or a product family category, all new products for the company or product family are automatically included in the list of products to synchronize.

If you want to limit the products that WSUS synchronizes, include only those products that you want to synchronize in the collection (do not include the company or product family categories).

See Also

ISubscription Interface
Microsoft.UpdateServices.Administration Namespace

Return to top