DSInternals PowerShell Module and Framework v3.3 Releases

DSInternals PowerShell Module and Framework

The DSInternals project consists of these two parts:

  • The DSInternals Framework exposes several internal features of Active Directory and can be used from any .NET application. The codebase has already been integrated into several 3rd party commercial products that use it in scenarios like Active Directory disaster recovery, identity management, cross-forest migrations, and password strength auditing.
  • The DSInternals PowerShell Module provides easy-to-use cmdlets that are built on top of the Framework. The main features include offline ntds.dit file manipulation and querying domain controllers through the Directory Replication Service (DRS) Remote Protocol.

DSInternals PowerShell

Changelog v3.3

Notable Changes

  • Scripts generated by the New-ADDBRestoreFromMediaScript cmdlet now fix SYSVOL references in the DFS-R subscription object if it is restored to a different path.
  • Commonly thrown exceptions now contain more explanatory messages.
  • The .NET Framework 4.5.1 requirement is now enforced.

See the Changelog for a more detailed list of new features.

PowerShell Module

Standalone module for offline installation and for legacy PowerShell versions is attached. See the
Installation Notes before proceeding.

PowerShell Gallery

For convenience, the DSInternals PowerShell module is also available on Microsoft’s PowerShell Gallery.


Option 1 – Online (PowerShell 5+)

Since PowerShell 5, you can install the DSInternals module directly from the official PowerShell Gallery by running this command:

Install-Module DSInternals

Option 2 – Offline (Windows PowerShell 3+)

  1. Download the current release from GitHub.
  2. “Unblock” the ZIP file, using either the Properties dialog or the Unblock-File cmdlet. If you fail to do so, all the extracted DLLs will inherit this attribute and PowerShell will refuse to load them.
  3. Extract the ZIP file to a temporary location.
  4. Copy the DSInternals directory to your PowerShell modules directory, e.g. C:\Windows\system32\WindowsPowerShell\v1.0\Modules\DSInternals or C:\Users\John\Documents\WindowsPowerShell\Modules\DSInternals.
  5. Launch Windows PowerShell.
  6. (Optional) If you copied the module to a different directory than advised in step 4, you have to manually import it using the Import-Module .\DSInternals\DSInternals.psd1 command.
  7. Start using the module and don’t be evil.


Copyright (c) 2015 Michael Grafnetter