SMS_SoftwareUpdate Server WMI Class

  • Article

 

Applies To: System Center 2012 Configuration Manager, System Center 2012 Configuration Manager SP1, System Center 2012 R2 Configuration Manager

The SMS_SoftwareUpdate Windows Management Instrumentation (WMI) class is an SMS Provider server class, in System Center 2012 R2 Configuration Manager, that exposes software update information available on a site and serves as the core class for software updates.

The following syntax is simplified from Managed Object Format (MOF) code and includes all inherited properties.

Syntax

Class SMS_SoftwareUpdate : SMS_ConfigurationItemBaseClass 
{ 
      String ApplicabilityCondition; 
      String ArticleID; 
      String BulletinID; 
      String CategoryInstance_UniqueIDs[]; 
      UInt32 CI_ID; 
      String CI_UniqueID; 
      UInt32 CIType_ID; 
      UInt32 CIVersion; 
      String CreatedBy; 
      UInt32 CustomSeverity; 
      String CustomSeverityName; 
      DateTime DateCreated; 
      DateTime DateLastModified; 
      DateTime DatePosted; 
      DateTime DateRevised; 
      DateTime EffectiveDate; 
      UInt32 EULAAccepted; 
      Boolean EULAExists; 
      DateTime EULASignoffDate; 
      String EULASignoffUser; 
      UInt32 ExecutionContext; 
      Boolean IsBundle; 
      Boolean IsContentProvisioned; 
      Boolean IsDeployable; 
      Boolean IsDeployed; 
      Boolean IsDigest; 
      Boolean IsEnabled; 
      Boolean IsExpired; 
      Boolean IsHidden; 
      Boolean IsLatest;
      Boolean IsMetadataOnlyUpdate; 
      Boolean IsOfflineServiceable; 
      Boolean IsQuarantined; 
      Boolean IsSuperseded; 
      Boolean IsUserDefined; 
      String LastModifiedBy; 
      DateTime LastStatusTime; 
      String LocalizedCategoryInstanceNames[]; 
      String LocalizedDescription; 
      String LocalizedDisplayName; 
      SMS_CI_LocalizedEulas LocalizedEulas[]; 
      SMS_CI_LocalizedProperties LocalizedInformation[]; 
      String LocalizedInformativeURL; 
      UInt32 LocalizedPropertyLocaleID; 
      UInt32 MaxExecutionTime; 
      UInt32 ModelID;
      String ModelName; 
      UInt32 NumMissing; 
      UInt32 NumNotApplicable; 
      UInt32 NumPresent; 
      UInt32 NumTotal; 
      UInt32 NumUnknown; 
      UInt32 PercentCompliant; 
      UInt32 PermittedUses; 
      String PlatformCategoryInstance_UniqueIDs[]; 
      UInt32 PlatformType; 
      Boolean RequiresExclusiveHandling; 
      UInt32 RevisionNumber; 
      SMS_SDMPackageLocalizedData SDMPackageLocalizedData[]; 
      UInt32 SDMPackageVersion; 
      String SDMPackageXML; 
      String SecuredScopeNames[]; 
      String SedoObjectVersion; 
      UInt32 Severity; 
      String SeverityName; 
      SInt64 Size; 
      String SourceSite; 
      String UpdateLocales[]; 
};

Methods

The following table shows the methods in SMS_SoftwareUpdate.

Method

Description

 AcceptEULA Method in Class SMS_SoftwareUpdate

Accepts or declines the Microsoft Software License Terms of a software update.

FilterUpdates Method in Class SMS_SoftwareUpdate

For internal use only.

 GetEULA Method in Class SMS_SoftwareUpdate

Gets the localized Microsoft Software License Terms content of a software update.

 SetEnforcement Method in Class SMS_SoftwareUpdate

Sets policy enforcement of a software update.

SyncNow Method in Class SMS_SoftwareUpdate

Performs a manual synchronization of the Software Update Point.

Properties

Remarks

Class qualifiers for this class include:

  • Secured

For more information about both the class qualifiers and the property qualifiers included in the Properties section, see Configuration Manager Class and Property Qualifiers.

An SMS_SoftwareUpdate object is a type of configuration item, defined by SMS_ConfigurationItemBaseClass Server WMI Class. Use SMS_SoftwareUpdate to determine the compliance of software updates using the Software Updates feature in System Center 2012 R2 Configuration Manager.

Software update content must be downloaded manually. To identify which contents need to be downloaded, your application queries SMS_CIToContent Server WMI Class and obtains the list of ContentID properties matching the specific language criteria. With this list, the application can obtain the associated download URL and the related properties for the content files from SMS_CIContentFiles Server WMI Class.

When the update content has been determined, the application optionally prepares the update for deployment using an SMS_AuthorizationList Server WMI Class object to create an authorized list of updates. Your application also has the option of implementing SMS_Template Server WMI Class to create a custom deployment template.

Note

When it is building an authorization list to include the software update, the application must set the IsBundle property of SMS_SoftwareUpdate to true to indicate that the update is part of a bundle. For more information, see SMS_AuthorizationList Server WMI Class.

When the application is ready to deploy the software update, it uses an SMS_UpdatesAssignment Server WMI Class object to create a deployment.

You cannot import, create, or configure software updates in the Desired Configuration Management node. These functions are made available to configuration baselines through the Software Updates feature when software updates are downloaded. Therefore, software update configuration items can be selected to be included in configuration baselines even though they are not displayed under the Configuration Items node.

See How to Enumerate Updates Matching a Specific Criteria for a discussion of queries that you can use to enumerate the information about multiple software updates.

Requirements

Runtime Requirements

For more information, see Configuration Manager Server Runtime Requirements.

Development Requirements

For more information, see Configuration Manager Server Development Requirements.

See Also

Configuration Manager Software Updates Server WMI Classes
SMS_AuthorizationList Server WMI Class
SMS_CIToContent Server WMI Class
SMS_CIContentFiles Server WMI Class
SMS_CIUpdateSources Server WMI Class
SMS_Template Server WMI Class
SMS_UpdatesAssignment Server WMI Class
Configuration Manager Software Updates