Share via


IComputerTargetGroup.GetSummaryPerUpdate()

Retrieves the summary installation counts for all approved updates.

public UpdateSummaryCollection GetSummaryPerUpdate();
Public Function GetSummaryPerUpdate() As UpdateSummaryCollection
Implements IComputerTargetGroup.GetSummaryPerUpdate

Parameters

This method has no parameters.

Return Values

An UpdateSummaryCollection collection that contains summary installation counts for all approved updates. The results are summarized by update (each member of the collection represents an approved update). For example, for each update, the collection provides the number of clients in this group that have successfully installed the update.

Exceptions

Exception type Condition
WsusObjectNotFoundException Summary information for the target group is not available.

Remarks

The collection may include updates that were not approved for deployment to this target group. For example, if the WSUS server contains 10 updates with eight updates being approved for deployment (five are approved for deployment to this group and three are approved for deployment to another group), this method would return an UpdateSummaryCollection collection that contains eight members.

If the update was not approved for deployment to this group of computers, the value for IUpdateSummary.UnknownCount should be equal to the number of clients in this group.

The UnknownCount also represents those clients in this group that have not reported their status. You can call IUpdate.GetUpdateApprovals(IComputerTargetGroup) to determine if the update is deployed to this group so that you will know for certain as to which state the count represents. However, if the unknown count is less than the number of clients in this group, then the update was approved for deployment to this group.

To retrieve summary information that sums the results for all updates that are deployed to all clients in the group, call IComputerTargetGroup.GetTotalSummary.

Requirements

Server Requires Windows Server 2003 or Windows 2000 Server SP4 and later.
Namespace

Defined in Microsoft.UpdateServices.Administration.

Assembly

Requires Microsoft.UpdateServices.Administration (in Microsoft.UpdateServices.Administration.dll).

.NET Framework

Requires .NET Framework 1.1.

See Also

IComputerTargetGroup.GetTotalSummaryPerComputerTarget, IComputerTargetGroup.GetUpdateInstallationInfoPerComputerTarget(IUpdate)