Add-WsusDynamicCategory
Adds a dynamic category to a WSUS server.
Syntax
ByObject
Add-WsusDynamicCategory
-InputObject <IDynamicCategory>
[-UpdateServer <IUpdateServer>]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
ByName
Add-WsusDynamicCategory
-Name <String>
-DynamicCategoryType <DynamicCategoryType>
[-UpdateServer <IUpdateServer>]
[-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.
Parameter properties
| Type: | SwitchParameter |
| Default value: | None |
| Supports wildcards: | False |
| DontShow: | False |
| Aliases: | cf |
Parameter sets
(All)
| Position: | Named |
| Mandatory: | False |
| Value from pipeline: | False |
| Value from pipeline by property name: | False |
| Value from remaining arguments: | False |
-DynamicCategoryType
Specifies the type of the dynamic category to add. The acceptable values for this parameter are:
- ComputerModel
- Device
- Application
Parameter properties
| Type: | DynamicCategoryType |
| Default value: | None |
| Accepted values: | ComputerModel, Device, Application, Any |
| Supports wildcards: | False |
| DontShow: | False |
| Aliases: | Type |
Parameter sets
ByName
| Position: | Named |
| Mandatory: | True |
| Value from pipeline: | False |
| Value from pipeline by property name: | False |
| Value from remaining arguments: | False |
-InputObject
Specifies the dynamic category object that this cmdlet adds to the server. To obtain a dynamic category, use the Get-WsusDynamicCategory cmdlet.
Parameter properties
| Type: | IDynamicCategory |
| Default value: | None |
| Supports wildcards: | False |
| DontShow: | False |
Parameter sets
ByObject
| Position: | Named |
| Mandatory: | True |
| Value from pipeline: | True |
| Value from pipeline by property name: | False |
| Value from remaining arguments: | False |
-Name
Specifies the name of the dynamic category to add.
Parameter properties
| Type: | String |
| Default value: | None |
| Supports wildcards: | False |
| DontShow: | False |
Parameter sets
ByName
| Position: | Named |
| Mandatory: | True |
| Value from pipeline: | False |
| Value from pipeline by property name: | False |
| Value from remaining arguments: | 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.
Parameter properties
| Type: | IUpdateServer |
| Default value: | None |
| Supports wildcards: | False |
| DontShow: | False |
Parameter sets
(All)
| Position: | Named |
| Mandatory: | False |
| Value from pipeline: | False |
| Value from pipeline by property name: | False |
| Value from remaining arguments: | False |
-WhatIf
Shows what would happen if the cmdlet runs. The cmdlet is not run.
Parameter properties
| Type: | SwitchParameter |
| Default value: | None |
| Supports wildcards: | False |
| DontShow: | False |
| Aliases: | wi |
Parameter sets
(All)
| Position: | Named |
| Mandatory: | False |
| Value from pipeline: | False |
| Value from pipeline by property name: | False |
| Value from remaining arguments: | False |
CommonParameters
This cmdlet supports the common parameters: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction, and -WarningVariable. For more information, see about_CommonParameters.