IUpdate
Use this interface to approve or decline updates for deployment and retrieve information about the update.
To retrieve this interface, call one of the following methods:
- IUpdateApproval.GetUpdate
- IUpdateEvent.GetUpdate
- IUpdateInstallationInfo.GetUpdate
- IUpdateServer.GetUpdate
- UpdateCollection.Item
The IUpdate interface is derived from the System.Object class.
Public Methods
The IUpdate interface has the following public methods.
| Method | Description |
|---|---|
| AcceptLicenseAgreement() | Accepts the license agreement that is associated with the update. |
| Approve(UpdateApprovalAction, IComputerTargetGroup) | Approves an update for deployment to clients. |
| Approve(UpdateApprovalAction, IComputerTargetGroup, DateTime) | Approves an update for deployment to clients and provides a deadline by when the client must act on the update. |
| CancelDownload() | Stops downloading the update and its dependencies to the WSUS server. |
| Decline() | Declines the update for deployment. |
| Equals(Object) | Determines if the specified Object is equal to the current Object. |
| GetChangesFromPreviousRevision() | Retrieves the reasons for why the update was revised. |
| GetHashCode() | Serves as a hash function for a particular type. GetHashCode is suitable for use in hashing algorithms and data structures like a hash table. |
| GetLicenseAgreement() | Retrieves the license agreement for this update. |
| GetRelatedUpdates(UpdateRelationship) | Retrieves a list of related updates. |
| GetSummaryPerComputerTargetGroup() | Retrieves a collection of summary information for each target group to which the update applies. |
| GetSupportedUpdateLanguages() | Retrieves a collection of the languages that this update supports. |
| GetType() | Retrieves the Type of the current instance. |
| GetUpdateApprovals() | Retrieves a collection of all approvals for this update. |
| GetUpdateApprovals(IComputerTargetGroup) | Retrieves a collection of approvals for this update. |
| GetUpdateApprovals(IComputerTargetGroup, UpdateApprovalAction, DateTime, DateTime) | Retrieves a collection of approvals for this update based on the given criteria. |
| GetUpdateCategories() | Retrieves a collection of product categories to which this update belongs. |
| GetUpdateClassifications() | Retrieves the classification to which the update belongs. |
| GetUpdateEventHistory(DateTime, DateTime) | Retrieves the event history that is associated with this update. |
| GetUpdateInstallationInfoPerComputerTarget(IComputerTargetGroup) | Retrieves a collection of installation information for each client in the specified target group. |
| PurgeAssociatedReportingEvents(DateTime, DateTime) | Uses the specified date range to remove events that are associated with this update. |
| RefreshUpdateApprovals() | Moves existing approvals from older revisions to the latest revision of this update. |
| ResumeDownload() | Resumes a failed or canceled download. |
| ToString() | Retrieves a String that represents the current Object. |
Public Properties
The IUpdate interface has the following public properties.
| Property | Description |
|---|---|
| AdditionalInformationUrls | Retrieves a collection of URLs provided by the publisher of the update that provide additional information about the update. |
| ArrivalDate | Retrieves the date and time when the metadata for this revision of the update finished downloading to the WSUS server. |
| CompanyTitles | Retrieves the titles of all the companies to which this update belongs. |
| CreationDate | Retrieves the date and time when this revision of the update's metadata was authored. |
| Description | Retrieves a short description of the update. |
| HasEarlierRevision | Retrieves a value that indicates if the WSUS server contains earlier revisions of this update. |
| HasLicenseAgreement | Retrieves a value that indicates if the update has an associated license agreement. |
| HasStaleUpdateApprovals | Retrieves a value that indicates if an older revision of the update contains an approval. |
| HasSupersededUpdates | Retrieves a value that indicates if the update supersedes other updates. |
| Id | Retrieves the unique identifier of the update. |
| InstallationBehavior | Retrieve the installation behavior of the update. |
| IsApproved | Retrieve a value that indicates if this revision of the update is approved for at least one target group. |
| IsDeclined | Retrieves a value that indicates if this update is declined. |
| IsLatestRevision | Retrieves a value that indicates if this revision is the latest revision of the update. |
| IsSuperseded | Retrieves a value that indicates if this update is superseded by a related update. |
| IsWsusInfrastructureUpdate | Retrieves a value that indicates if this update is a WSUS infrastructure update. |
| KnowledgeBaseArticles | Retrieves a collection of Knowledge Base article numbers that are associated with the update. |
| LegacyName | Retrieves the name of the update that was used in previous versions. |
| MsrcSeverity | Retrieves the maximum severity rating of the Microsoft Security Response Center (MSRC) bulletin that is associated with the update. |
| ProductFamilyTitles | Retrieves the titles of all product family categories to which the update belongs. |
| ProductTitles | Retrieves the titles of all product categories to which the update belongs. |
| PublicationState | Retrieves the publication state of the update. |
| RequiresLicenseAgreementAcceptance | Retrieves a value that indicates if the update requires a user to accept the license agreement. |
| SecurityBulletins | Retrieves a collection of Security Bulletin numbers that are associated with the update. |
| State | Retrieves the current state of the update. |
| Title | Retrieves the title of the update. |
| UninstallationBehavior | Retrieves the removal behavior of the update. |
| UpdateClassificationTitle | Retrieves the title of the classification to which the update belongs. |
| UpdateType | Retrieves a value that indicates if the update is a software update or a driver update. |
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. |