Set-DomainObject - Empire Module


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

Module Overview

Name: Set-DomainObject
Module: powershell/situational_awareness/network/powerview/set_ad_object
Source code [1]: empire/server/modules/powershell/situational_awareness/network/powerview/set_ad_object.yaml
Source code [2]: empire/server/data/module_source/situational_awareness/network/powerview.ps1
MITRE ATT&CK: T1487, S0194
Language: PowerShell
Needs admin: No
OPSEC safe: Yes
Background: Yes

The set_ad_object module takes a SID, name, or SamAccountName to query for a specified domain object, and then sets a specified "PropertyName" to a specified "PropertyValue". Part of PowerView.

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 set_ad_object 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 set_ad_object module:

Agent
Agent to run module on.

Additional Module Options

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

Clear
Specifies an array of object properties that will be cleared in the directory.

Domain
The domain to query for objects, defaults to the current domain.

Identity
A SamAccountName, DistinguishedName, SID, GUID, or a dns host name, wildcards accepted.

LDAPFilter
Specifies an LDAP query string that is used to filter Active Directory objects.

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.

ResultPageSize
Specifies the PageSize to set for the LDAP searcher object.

SearchBase
The LDAP source to search through, e.g. "LDAP://OU=secret,DC=testlab,DC=local" Useful for OU queries.

SearchScope
Specifies the scope to search under, Base/OneLevel/Subtree (default of Subtree).

Server
Specifies an active directory server (domain controller) to bind to.

ServerTimeLimit
Specifies the maximum amount of time the server spends searching. Default of 120 seconds.

Set
Specifies values for one or more object properties (in the form of a hashtable) that will replace the current values.

Tombstone
Switch. Specifies that the search should also return deleted/tombstoned objects.

Xor
Specifies values for one or more object properties (in the form of a hashtable) that will XOR the current values.

Set_ad_object Example Usage

Here's an example of how to use the set_ad_object 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/network/powerview/set_ad_object

 Author       @harmj0y                                                             
 Background   True                                                                 
 Comments     https://github.com/PowerShellMafia/PowerSploit/blob/dev/Recon/       
 Description  Takes a SID, name, or SamAccountName to query for a specified domain 
              object, and then sets a specified "PropertyName" to a specified      
              "PropertyValue". Part of PowerView.                                  
 Language     powershell                                                           
 Name         powershell/situational_awareness/network/powerview/set_ad_object     
 NeedsAdmin   False                                                                
 OpsecSafe    True                                                                 
 Software     http://attack.mitre.org/software/S0194                               
 Techniques   http://attack.mitre.org/techniques/T1487                             


,Record Options---,------------,----------,-------------------------------------,
| Name            | Value      | Required | Description                         |
|-----------------|------------|----------|-------------------------------------|
| Agent           |            | True     | Agent to run module on.             |
|-----------------|------------|----------|-------------------------------------|
| Clear           |            | False    | Specifies an array of object        |
|                 |            |          | properties that will be cleared in  |
|                 |            |          | the directory                       |
|-----------------|------------|----------|-------------------------------------|
| Domain          |            | False    | The domain to query for objects,    |
|                 |            |          | defaults to the current domain.     |
|-----------------|------------|----------|-------------------------------------|
| Identity        |            | False    | A SamAccountName,                   |
|                 |            |          | DistinguishedName, SID, GUID, or a  |
|                 |            |          | dns host name, wildcards accepted.  |
|-----------------|------------|----------|-------------------------------------|
| LDAPFilter      |            | False    | Specifies an LDAP query string that |
|                 |            |          | is used to filter Active Directory  |
|                 |            |          | objects.                            |
|-----------------|------------|----------|-------------------------------------|
| OutputFunction  | Out-String | False    | PowerShell's output function to use |
|                 |            |          | ("Out-String", "ConvertTo-Json",    |
|                 |            |          | "ConvertTo-Csv", "ConvertTo-Html",  |
|                 |            |          | "ConvertTo-Xml").                   |
|-----------------|------------|----------|-------------------------------------|
| ResultPageSize  |            | False    | Specifies the PageSize to set for   |
|                 |            |          | the LDAP searcher object.           |
|-----------------|------------|----------|-------------------------------------|
| SearchBase      |            | False    | The LDAP source to search through,  |
|                 |            |          | e.g. "LDAP://OU=secret,DC=testlab,D |
|                 |            |          | C=local" Useful for OU queries.     |
|-----------------|------------|----------|-------------------------------------|
| SearchScope     |            | False    | Specifies the scope to search       |
|                 |            |          | under, Base/OneLevel/Subtree        |
|                 |            |          | (default of Subtree)                |
|-----------------|------------|----------|-------------------------------------|
| Server          |            | False    | Specifies an active directory       |
|                 |            |          | server (domain controller) to bind  |
|                 |            |          | to                                  |
|-----------------|------------|----------|-------------------------------------|
| ServerTimeLimit |            | False    | Specifies the maximum amount of     |
|                 |            |          | time the server spends searching.   |
|                 |            |          | Default of 120 seconds.             |
|-----------------|------------|----------|-------------------------------------|
| Set             |            | False    |  Specifies values for one or more   |
|                 |            |          | object properties (in the form of a |
|                 |            |          | hashtable) that will replace the    |
|                 |            |          | current values.                     |
|-----------------|------------|----------|-------------------------------------|
| Tombstone       |            | False    | Switch. Specifies that the search   |
|                 |            |          | should also return                  |
|                 |            |          | deleted/tombstoned objects.         |
|-----------------|------------|----------|-------------------------------------|
| Xor             |            | False    | Specifies values for one or more    |
|                 |            |          | object properties (in the form of a |
|                 |            |          | hashtable) that will XOR the        |
|                 |            |          | current values                      |
'-----------------'------------'----------'-------------------------------------'

(Empire: usemodule/powershell/situational_awareness/network/powerview/set_ad_object) > set Agent Y4LHEV83
[*] Set Agent to Y4LHEV83
(Empire: usemodule/powershell/situational_awareness/network/powerview/set_ad_object) > 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.