Get-ComputerDetails - Empire Module


This page contains detailed information about how to use the powershell/situational_awareness/host/computerdetails Empire module. For list of all Empire modules, visit the Empire Module Library.

Module Overview

Name: Get-ComputerDetails
Module: powershell/situational_awareness/host/computerdetails
Source code [1]: empire/server/modules/powershell/situational_awareness/host/computerdetails.yaml
Source code [2]: empire/server/modules/powershell/situational_awareness/host/computerdetails.py
MITRE ATT&CK: T1082
Language: PowerShell
Needs admin: Yes
OPSEC safe: Yes
Background: Yes

The computerdetails module enumerates useful information on the system. By default, all checks are run.

This module runs in a foreground and is OPSEC unsafe as it writes on the disk and therefore could be detected by AV/EDR running on the target system.

Note that the computerdetails module does not need administrative privileges to work properly which means that a normal user can run this module.

Required Module Options

This is a list of options that are required by the computerdetails module:

Agent
Agent to run module on.

Additional Module Options

This is a list of additional options that are supported by the computerdetails module:

4624
Switch. Only return 4624 logon information (logons to this machine).

4648
Switch. Only return 4648 logon information (RDP to another machine).

AppLocker
Switch. Only return AppLocker logs.

Limit
Limit the number of event log entries returned. Defaults to 100.
Default value: 100.

OutputFunction
PowerShell's output function to use ("Out-String", "ConvertTo-Json", "ConvertTo-Csv", "ConvertTo-Html", "ConvertTo-Xml").
Default value: Out-String.
Suggested values: Out-String, ConvertTo-Json, ConvertTo-Csv, ConvertTo-Html, ConvertTo-Xml.

PSScripts
Switch. Only return PowerShell scripts run from operational log.

SavedRDP
Switch. Only return saved RDP connections.

Computerdetails Example Usage

Here's an example of how to use the computerdetails module in the Empire client console:

[+] New agent Y4LHEV83 checked in
[*] Sending agent (stage 2) to Y4LHEV83 at 192.168.204.135
(empire usestager/windows/ducky) > usemodule powershell/situational_awareness/host/computerdetails

 Author       @JosephBialek                                                        
 Background   True                                                                 
 Comments     https://github.com/mattifestation/PowerSploit/blob/master/Recon/Get- 
              ComputerDetails.ps1                                                  
 Description  Enumerates useful information on the system. By default, all checks  
              are run.                                                             
 Language     powershell                                                           
 Name         powershell/situational_awareness/host/computerdetails                
 NeedsAdmin   True                                                                 
 OpsecSafe    True                                                                 
 Techniques   http://attack.mitre.org/techniques/T1082                             


,Record Options--,------------,----------,-------------------------------------,
| Name           | Value      | Required | Description                         |
|----------------|------------|----------|-------------------------------------|
| 4624           |            | False    | Switch. Only return 4624 logon      |
|                |            |          | information (logons to this         |
|                |            |          | machine).                           |
|----------------|------------|----------|-------------------------------------|
| 4648           |            | False    | Switch. Only return 4648 logon      |
|                |            |          | information (RDP to another         |
|                |            |          | machine).                           |
|----------------|------------|----------|-------------------------------------|
| Agent          |            | True     | Agent to run module on.             |
|----------------|------------|----------|-------------------------------------|
| AppLocker      |            | False    | Switch. Only return AppLocker logs. |
|----------------|------------|----------|-------------------------------------|
| Limit          | 100        | False    | Limit the number of event log       |
|                |            |          | entries returned. Defaults to 100   |
|----------------|------------|----------|-------------------------------------|
| OutputFunction | Out-String | False    | PowerShell's output function to use |
|                |            |          | ("Out-String", "ConvertTo-Json",    |
|                |            |          | "ConvertTo-Csv", "ConvertTo-Html",  |
|                |            |          | "ConvertTo-Xml").                   |
|----------------|------------|----------|-------------------------------------|
| PSScripts      |            | False    | Switch. Only return PowerShell      |
|                |            |          | scripts run from operational log.   |
|----------------|------------|----------|-------------------------------------|
| SavedRDP       |            | False    | Switch. Only return saved RDP       |
|                |            |          | connections.                        |
'----------------'------------'----------'-------------------------------------'

(Empire: usemodule/powershell/situational_awareness/host/computerdetails) > set Agent Y4LHEV83
[*] Set Agent to Y4LHEV83
(Empire: usemodule/powershell/situational_awareness/host/computerdetails) > execute
[*] Tasked Y4LHEV83 to run Task 1
...

Now wait for the results to come.

Author

References

See Also

Check also the following modules related to this module:

Version

This page has been created based on Empire version 4.1.3 (BC Security Fork).
Visit Empire Module Library for more modules.