The SMS_SystemConsoleUsage class is a client Windows Management Instrumentation (WMI) class, in Configuration Manager, that defines usage data about devices, based on the Windows security event log.
Note |
---|
For this class to gather usable data, the Auditing of Logon/Logoff policy must be turned on for each computer. |
The following syntax is simplified from Managed Object Format (MOF) code and includes all inherited properties.
Class SMS_SystemConsoleUsage { DateTime SecurityLogStartDate; String TopConsoleUser; UInt32 TotalConsoleTime; UInt32 TotalConsoleUsers; UInt32 TotalSecurityLogTime; }; |
Methods
The SMS_SystemConsoleUsage class does not define any methods.
Properties
- SecurityLogStartDate
- Data type: DateTimeAccess type: Read-onlyQualifiers: [key]The date and time of the oldest record in the system security event log.
- TopConsoleUser
- Data type: StringAccess type: Read-onlyQualifiers: NoneThe user with the most console usage on the computer.
- TotalConsoleTime
- Data type: UInt32Access type: Read-onlyQualifiers: NoneThe total number of console logon minutes recorded in the system security event log for all users.
- TotalConsoleUsers
- Data type: UInt32Access type: Read-onlyQualifiers: NoneThe total number of unique console users recorded in the system security event log.
- TotalSecurityLogTime
- Data type: UInt32Access type: Read-onlyQualifiers: NoneThe total time, in minutes, in the system security event log. This time is calculated by subtracting the timestamp for the oldest event in the log from the timestamp of the newest event.
Remarks
This class gathers information about all users from the system security event log by using logon and logoff events. When a logon event is found, the associated logon ID is used to search for a matching logoff event. If more than one logoff event is found for a specific logon event, then the last logoff event is used to calculate the amount of time that the user was logged on. This is because it is possible to issue more than one logoff request before the system actually performs the logoff action. If a matching logoff event cannot be found, the next shutdown event or logon event is used in place of a logoff event. If none of these can be found, the latest entry in the security log is used. The resulting information is aggregated by user and ordered by total console usage.
Note |
---|
Only interactive logons are acknowledged by this class. |
Some security logs can roll over frequently, or they can extend for several years. The time polled for this class is limited to the last 90 days.
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
Reference
SMS_AutoStartSoftware Client WMI ClassSMS_BrowserHelperObject Client WMI Class
SMS_InstalledExecutable Client WMI Class
SMS_InstalledSoftware Client WMI Class
SMS_InstalledSoftwareMS Client WMI Class
SMS_Processor Client WMI Class
SMS_SoftwareShortcut Client WMI Class
SMS_SystemConsoleUser Client WMI Class