Get-ADIDNSZone - Empire Module


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

Module Overview


Name: Get-ADIDNSZone
Module: powershell/situational_awareness/network/powermad/get_adidns_zone
Source code [1]: empire/server/modules/powershell/situational_awareness/network/powermad/get_adidns_zone.yaml
Source code [2]: empire/server/data/module_source/situational_awareness/network/powermad.ps1
MITRE ATT&CK: T1016
Language: PowerShell
Needs admin: No
OPSEC safe: Yes
Background: Yes

The get_adidns_zone module querys ADIDNS zones in the specified domain. Part of Powermad.

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

Agent
Agent to run module on.

Additional Module Options


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

DistinguishedName
Distinguished name for the ADIDNS zone. Do not include the node name.

Domain
The targeted domain in DNS format. This parameter is required when using an IP address in the DomainController parameter.

DomainController
Domain controller to target. This parameter is mandatory on a non-domain attached system.

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.

Partition
(DomainDNSZones,ForestDNSZones,System) The AD partition name where the zone is stored. By default, this function will loop through all three partitions.

Zone
The ADIDNS zone to search for.

Get_adidns_zone Example Usage


Here's an example of how to use the get_adidns_zone 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/powermad/get_adidns_zone

 Author       @Kevin-Robertson                                                  
              @snovvcrash                                                       
 Background   True                                                              
 Comments     https://github.com/Kevin-Robertson/Powermad                       
 Description  Query ADIDNS zones in the specified domain. Part of Powermad.     
 Language     powershell                                                        
 Name         powershell/situational_awareness/network/powermad/get_adidns_zone 
 NeedsAdmin   False                                                             
 OpsecSafe    True                                                              
 Techniques   http://attack.mitre.org/techniques/T1016                          


,Record Options-----,------------,----------,-------------------------------------,
| Name              | Value      | Required | Description                         |
|-------------------|------------|----------|-------------------------------------|
| Agent             |            | True     | Agent to run module on.             |
|-------------------|------------|----------|-------------------------------------|
| DistinguishedName |            | False    | Distinguished name for the ADIDNS   |
|                   |            |          | zone. Do not include the node name. |
|-------------------|------------|----------|-------------------------------------|
| Domain            |            | False    | The targeted domain in DNS format.  |
|                   |            |          | This parameter is required when     |
|                   |            |          | using an IP address in the          |
|                   |            |          | DomainController parameter.         |
|-------------------|------------|----------|-------------------------------------|
| DomainController  |            | False    | Domain controller to target. This   |
|                   |            |          | parameter is mandatory on a non-    |
|                   |            |          | domain attached system.             |
|-------------------|------------|----------|-------------------------------------|
| OutputFunction    | Out-String | False    | PowerShell's output function to use |
|                   |            |          | ("Out-String", "ConvertTo-Json",    |
|                   |            |          | "ConvertTo-Csv", "ConvertTo-Html",  |
|                   |            |          | "ConvertTo-Xml").                   |
|-------------------|------------|----------|-------------------------------------|
| Partition         |            | False    | (DomainDNSZones,ForestDNSZones,Syst |
|                   |            |          | em) The AD partition name where the |
|                   |            |          | zone is stored. By default, this    |
|                   |            |          | function will loop through all      |
|                   |            |          | three partitions.                   |
|-------------------|------------|----------|-------------------------------------|
| Zone              |            | False    | The ADIDNS zone to search for.      |
'-------------------'------------'----------'-------------------------------------'

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

Now wait for the results to come.

Authors


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.