TestimoX

API Reference

Class

WindowsUpdateSearchQueryBuilder

Namespace ComputerX.Updates
Assembly ComputerX
Modifiers sealed

Builds Windows Update Agent search criteria strings using strongly typed filters.

Inheritance

  • Object
  • WindowsUpdateSearchQueryBuilder

Constructors

public WindowsUpdateSearchQueryBuilder() #

Methods

public WindowsUpdateSearchQueryBuilder AddAutoSelectOnWebSites(Boolean autoSelectOnWebSites) #
Returns: WindowsUpdateSearchQueryBuilder

Adds a filter indicating whether the update is auto-selected on web sites.

Parameters

autoSelectOnWebSites System.Boolean requiredposition: 0
Desired auto-select state.

Returns

The current builder instance.

public WindowsUpdateSearchQueryBuilder AddBrowseOnly(Boolean browseOnly) #
Returns: WindowsUpdateSearchQueryBuilder

Adds a filter indicating whether the update is browse-only.

Parameters

browseOnly System.Boolean requiredposition: 0
Desired browse-only state.

Returns

The current builder instance.

public WindowsUpdateSearchQueryBuilder AddCategoryIds(IEnumerable<String> categoryIds) #
Returns: WindowsUpdateSearchQueryBuilder

Adds category identifiers to narrow the search.

Parameters

categoryIds System.Collections.Generic.IEnumerable{System.String} requiredposition: 0
Category identifiers to include.

Returns

The current builder instance.

public WindowsUpdateSearchQueryBuilder AddCriteria(Nullable<WindowsUpdateInstallationStatus> installationStatus = null, Nullable<Boolean> isHidden = null, Nullable<WindowsUpdateQueryType> updateType = null, Nullable<WindowsUpdateDeploymentAction> deploymentAction = null, IEnumerable<String> updateIds = null, IEnumerable<String> categoryIds = null, Nullable<Boolean> isAssigned = null, Nullable<Boolean> rebootRequired = null, Nullable<Boolean> browseOnly = null, Nullable<Boolean> autoSelectOnWebSites = null, Nullable<Int32> revisionNumber = null, String customCriteria = null) #
Returns: WindowsUpdateSearchQueryBuilder

Adds multiple structured criteria in one call.

Parameters

installationStatus System.Nullable{ComputerX.Updates.WindowsUpdateInstallationStatus} = null optionalposition: 0
Optional installation state filter.
isHidden System.Nullable{System.Boolean} = null optionalposition: 1
Optional hidden-state filter.
updateType System.Nullable{ComputerX.Updates.WindowsUpdateQueryType} = null optionalposition: 2
Optional update type filter.
deploymentAction System.Nullable{ComputerX.Updates.WindowsUpdateDeploymentAction} = null optionalposition: 3
Optional deployment action filter.
updateIds System.Collections.Generic.IEnumerable{System.String} = null optionalposition: 4
Optional update identifiers to include.
categoryIds System.Collections.Generic.IEnumerable{System.String} = null optionalposition: 5
Optional category identifiers to include.
isAssigned System.Nullable{System.Boolean} = null optionalposition: 6
Optional assigned-state filter.
rebootRequired System.Nullable{System.Boolean} = null optionalposition: 7
Optional reboot-required filter.
browseOnly System.Nullable{System.Boolean} = null optionalposition: 8
Optional browse-only filter.
autoSelectOnWebSites System.Nullable{System.Boolean} = null optionalposition: 9
Optional auto-select-on-web-sites filter.
revisionNumber System.Nullable{System.Int32} = null optionalposition: 10
Optional revision number filter.
customCriteria System.String = null optionalposition: 11
Optional raw WUA criteria appended to the built query.

Returns

The current builder instance.

public WindowsUpdateSearchQueryBuilder AddCustomCriteria(String customCriteria) #
Returns: WindowsUpdateSearchQueryBuilder

Adds raw custom criteria to the query.

Parameters

customCriteria System.String requiredposition: 0
Raw WUA criteria to append.

Returns

The current builder instance.

public WindowsUpdateSearchQueryBuilder AddDeploymentAction(WindowsUpdateDeploymentAction action) #
Returns: WindowsUpdateSearchQueryBuilder

Adds a filter for the deployment action.

Parameters

action ComputerX.Updates.WindowsUpdateDeploymentAction requiredposition: 0
Deployment action filter.

Returns

The current builder instance.

public WindowsUpdateSearchQueryBuilder AddInstallationStatus(WindowsUpdateInstallationStatus status) #
Returns: WindowsUpdateSearchQueryBuilder

Adds a filter for the installation status of an update.

Parameters

status ComputerX.Updates.WindowsUpdateInstallationStatus requiredposition: 0
Desired installation state.

Returns

The current builder instance.

public WindowsUpdateSearchQueryBuilder AddIsAssigned(Boolean isAssigned) #
Returns: WindowsUpdateSearchQueryBuilder

Adds a filter indicating whether the update is assigned to the target.

Parameters

isAssigned System.Boolean requiredposition: 0
Desired assigned state.

Returns

The current builder instance.

public WindowsUpdateSearchQueryBuilder AddIsHidden(Boolean isHidden) #
Returns: WindowsUpdateSearchQueryBuilder

Adds a filter indicating whether matching updates are hidden.

Parameters

isHidden System.Boolean requiredposition: 0
Desired hidden state.

Returns

The current builder instance.

public WindowsUpdateSearchQueryBuilder AddRebootRequired(Boolean rebootRequired) #
Returns: WindowsUpdateSearchQueryBuilder

Adds a filter indicating whether the update requires a reboot.

Parameters

rebootRequired System.Boolean requiredposition: 0
Desired reboot-required state.

Returns

The current builder instance.

public WindowsUpdateSearchQueryBuilder AddRevisionNumber(Int32 revisionNumber) #
Returns: WindowsUpdateSearchQueryBuilder

Adds a filter for a specific revision number.

Parameters

revisionNumber System.Int32 requiredposition: 0
Desired revision number.

Returns

The current builder instance.

public WindowsUpdateSearchQueryBuilder AddUpdateIds(IEnumerable<String> updateIds) #
Returns: WindowsUpdateSearchQueryBuilder

Adds update identifiers to narrow the search.

Parameters

updateIds System.Collections.Generic.IEnumerable{System.String} requiredposition: 0
Update identifiers to include.

Returns

The current builder instance.

public WindowsUpdateSearchQueryBuilder AddUpdateType(WindowsUpdateQueryType type) #
Returns: WindowsUpdateSearchQueryBuilder

Adds a filter for the update type.

Parameters

type ComputerX.Updates.WindowsUpdateQueryType requiredposition: 0
Desired update type.

Returns

The current builder instance.

public String Build() #
Returns: String

Builds the WUA search criteria string.

Returns

The assembled criteria string.

public WindowsUpdateSearchQueryBuilder Reset() #
Returns: WindowsUpdateSearchQueryBuilder

Clears all accumulated criteria.

Returns

The current builder instance.