ActiveDirectory_PS Provider

This provider updates an Microsoft ActiveDirectory server DNS server. It interacts with AD via PowerShell commands that are generated and executed on the local machine. This means that DNSControl must be run on a Windows host. This driver automatically deactivates itself when run on non-Windows systems.

Running on Non-Windows systems

For debugging and testing on non-Windows systems, a “fake PowerShell” mode can be used, which will activate the driver and simulate PowerShell as follows:

Zone Input: Normally when DNSControl needs to know the contents of an existing DNS zone, it generates a PowerShell command to gather such information and saves a copy in a file called adzonedump.ZONE.json (where “ZONE” is replaced with the zone name). When “fake PowerShell” mode is enabled, the PowerShell command is not run, but the adzonedump.ZONE.json file is read. You must generate this file ahead of time (often on a different machine, one that runs PowerShell).

Zone Changes: Normally when DNSControl needs to change DNS records, it executes PowerShell commands as required. When “fake PowerShell” mode is enabled, these commands are simply logged to a file dns_update_commands.ps1 and the system assumes they executed.

To activate this mode, set "fakeps":"true" inside your credentials file for the provider.

Configuration

The ActiveDirectory_PS provider reads an ADServer setting fromcreds.json to know the name of the ActiceDirectory DNS Server to update.

{"activedir":{"ADServer":"ny-dc01"}}

If you want to modify the “fake powershell” mode details, you can set them in the credentials file: