Add-WsusDynamicCategory

Adds a dynamic category to a WSUS server.

Syntax

Add-WsusDynamicCategory
   [-UpdateServer <IUpdateServer>]
   -InputObject <IDynamicCategory>
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]
Add-WsusDynamicCategory
   [-UpdateServer <IUpdateServer>]
   -Name <String>
   -DynamicCategoryType <DynamicCategoryType>
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Description

The Add-WsusDynamicCategory cmdlet adds a dynamic category to a Windows Server Update Services (WSUS) server.

In order to transfer dynamic categories from one update server to another, pass the results of the Get-WsusDynamicCategory cmdlet to the current cmdlet by using the pipeline operator.

This cmdlet is used to add Dynamic Categories to WSUS, based on the type of requirement (computer model, device or application). The definition of Dynamic Categories in a WSUS implementation helps to categorize the applying of updates to the different categories available.

In some cases, you need advanced automation when using Dynamic Categories. If you want to download a specific device driver for a specific group of computers in the physical network, for example, advanced automation is required to use Dynamic Categories. In this case, the use of Microsoft Endpoint Configuration Manager is needed to install and configure a software update point feature.

Examples

Example 1: Add a dynamic category to the local WSUS server

PS C:\> Add-WsusDynamicCategory -DynamicCategoryType Device -Name "PCI/Device07"
Name                                     Type                                     Status
----                                     ----                                     ------
PCI/Device07                             Device                                   True

This command adds a dynamic category named PCI/Device07 the local update server. The command specifies that they type is Device.

Parameters

-Confirm

Prompts you for confirmation before running the cmdlet.

Type:SwitchParameter
Aliases:cf
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-DynamicCategoryType

Specifies the type of the dynamic category to add. The acceptable values for this parameter are:

  • ComputerModel
  • Device
  • Application
Type:DynamicCategoryType
Aliases:Type
Accepted values:ComputerModel, Device, Application, Any
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-InputObject

Specifies the dynamic category object that this cmdlet adds to the server. To obtain a dynamic category, use the Get-WsusDynamicCategory cmdlet.

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

-Name

Specifies the name of the dynamic category to add.

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

-UpdateServer

Specifies the WSUS server to which this cmdlet adds the dynamic category. To obtain a server, use the Get-WsusServer cmdlet. If you do not specify a value for this parameter, the cmdlet adds the dynamic category to the local server.

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

-WhatIf

Shows what would happen if the cmdlet runs. The cmdlet is not run.

Type:SwitchParameter
Aliases:wi
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

Inputs

Microsoft.UpdateServices.Administration.IDynamicCategory

Outputs

Object