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)