Muokkaa

Jaa

SMS_InstalledSoftware Client WMI Class

  • Artikkeli

The SMS_InstalledSoftware class is a client Windows Management Instrumentation (WMI) class, in Configuration Manager, that merges installed software information from multiple sources to provide categorization and Microsoft Licensing information.

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

Syntax

Class SMS_InstalledSoftware     
{    
      String ARPDisplayName;    
      String ChannelCode;    
      String CM_DSLID;    
      String EvidenceSource;   
      DateTime InstallDate;    
      UInt32 InstallDirectoryValidation;    
      String InstalledLocation;    
      String InstallSource;    
      UInt32 InstallType;   
      UInt32 Language;    
      String LocalPackage;    
      String ProductCode;    
      String ProductID;    
      String ProductName;    
      String ProductVersion;    
      String Publisher;    
      String RegisteredUser;    
      String ServicePack;    
      String SoftwareCode;    
      String SoftwarePropertiesHash;    
      String SoftwarePropertiesHashEx;    
      String UninstallString;    
      String UpgradeCode;    
      UInt32 VersionMajor;    
      UInt32 VersionMinor;    
};

Methods

The SMS_InstalledSoftware class does not define any methods.

Properties

ARPDisplayName
Data type: String

Access type: Read-only

Qualifiers: None

The product display name as found in Add or Remove Programs. An example name is "Microsoft SQL Server 2005 Tools".

ChannelCode
Data type: String

Access type: Read-only

Qualifiers: None

Numeric code that represents the channel through which the software product was acquired. Possible values are:

Value Description
0 Full Packaged Product (Retail)
1 Compliance Checked Product
2 OEM
3 Volume

Note

Other values are undefined.

CM_DSLID
Data type: String

Access type: Read-only

Qualifiers: None

Reserved. For future use.

EvidenceSource
Data type: String

Access type: Read-only

Qualifiers: [SMS_Report (TRUE)]

Describes how this software was discovered.

Value Description
A Windows Installer
B The software's install registry key
C The software's uninstall registry key
D Operating System's Windows Installer
E Operating System's Windows NT registry setting
M Internally computed property
X Unknown

InstallDate
Data type: DateTime

Access type: Read-only

Qualifiers: None

Date and time of when the software product was installed.

InstallDirectoryValidation
Data type: UInt32

Access type: Read-only

Qualifiers: None

Numeric code that provides additional information about the inventoried software. Possible values are:

Value Description
1 Because the InstalledLocation property was not available in any of the data sources, a check was not possible.
2 An executable file was found in the directory specified by the InstalledLocation property or in one of its subdirectories.
3 A file was found in the directory specified by the InstalledLocation property or in one of its subdirectories, but no executable file was found.
4 The directory specified by the InstalledLocation property was located, but it did not contain any executable files or other files.
5 The directory specified by the InstalledLocation property does not exist.

InstalledLocation
Data type: String

Access type: Read-only

Qualifiers: None

The full path to the primary directory that is associated with the software.

InstallSource
Data type: String

Access type: Read-only

Qualifiers: None

The full path of the directory from which the software was installed, for example, \\Software\Microsoft\SMS\Setup.exe.

InstallType
Data type: UInt32

Access type: Read-only

Qualifiers: [SMS_Report (TRUE)]

Describes the type of software that has been installed.

Value Description
0 Physically installed
1 Virtually installed

Language
Data type: UInt32

Access type: Read-only

Qualifiers: None

The language associated with the software product.

LocalPackage
Data type: String

Access type: Read-only

Qualifiers: None

The local cached package, for example, C:\Windows\Installer\9c1c748.msi.

ProductCode
Data type: String

Access type: Read-only

Qualifiers: None

A unique identifier for the particular product release. The identifier is represented as a GUID for Windows Installer-based applications or as the string used by the product to register with Add or Remove Programs.

ProductID
Data type: String

Access type: Read-only

Qualifiers: None

Vendor-generated ID that uniquely identifies the product.

ProductName
Data type: String

Access type: Read-only

Qualifiers: None

The name of the installed product that is displayed to the user, for example, "Microsoft Office 2003".

ProductVersion
Data type: String

Access type: Read-only

Qualifiers: None

The version of the product, for example, "5.1.1969".

Publisher
Data type: String

Access type: Read-only

Qualifiers: None

The company that publishes the software.

RegisteredUser
Data type: String

Access type: Read-only

Qualifiers: None

The registered user for the product.

ServicePack
Data type: String

Access type: Read-only

Qualifiers: None

The major version number of the service pack that is installed on the computer. If no service pack has been installed, the value is 0 (zero). Applicable only to operating systems.

SoftwareCode
Data type: String

Access type: Read-only

Qualifiers: [key]

A normalized version of the ProductCode property. All characters in the string are lowercase.

SoftwarePropertiesHash
Data type: String

Access type: Read-only

Qualifiers: None

A unique 128-bit signature derived from a combination of the ProductName, Publisher, and ProductVersion properties of the software product.

SoftwarePropertiesHashEx
Data type: String

Access type: Read-only

Qualifiers: None

A unique 128-bit signature derived from a combination of the ProductName, Publisher, ProductVersion, and Language properties of the software product.

UninstallString
Data type: String

Access type: Read-only

Qualifiers: None

The uninstall string as registered by the product with Add or Remove Programs, for example, "MsiExec.exe /X{210C4411-95A8-4CAF-8B23-F964CF8A78F3}".

UpgradeCode
Data type: String

Access type: Read-only

Qualifiers: None

A GUID that represents a related set of products. Applicable only to Windows Installer-based products.

VersionMajor
Data type: UInt32

Access type: Read-only

Qualifiers: None

The major product version that is derived from the ProductVersion property.

VersionMinor
Data type: UInt32

Access type: Read-only

Qualifiers: None

The minor product version that is derived from the ProductVersion property.

Remarks

This class merges information from as many as five sources. The first source is the Windows MsiEnumProducts function. This function enumerates through all the products that are currently advertised or installed. Other sources of information for all installed software are the following registry keys:

  • HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\Windows\CurrentVersion\Installer\UserData\[User SID]\Products

  • HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\Windows\CurrentVersion\Uninstall

    The class also gathers information for operating system software from the following sources:

  • WMI class root\CIMV2:Win32_OperatingSystem

  • Registry key HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\Windows NT\CurrentVersion

Requirements

Runtime Requirements

For more information, see Configuration Manager Client Runtime Requirements.

Development Requirements

For more information, see Configuration Manager Client Development Requirements.

See Also

Asset Intelligence Client WMI Classes
SMS_AutoStartSoftware Client WMI Class
SMS_BrowserHelperObject Client WMI Class
SMS_InstalledExecutable Client WMI Class
SMS_InstalledSoftwareMS Client WMI Class
SMS_Processor Client WMI Class
SMS_SoftwareShortcut Client WMI Class
SMS_SystemConsoleUsage Client WMI Class
SMS_SystemConsoleUser Client WMI Class