README.md

AdsiPS

AdsiPS is a PowerShell module to interact with Active Directory using the .NET Framework (ADSI, System.DirectoryServices namespace,...)

Note: This module currently only works on Windows Operating Systems.

Usage

Option A: Download from PowerShell Gallery

Only from PowerShell v5.1 (on Windows OS only)

Install-Module -name ADSIPS

Option B: Manual download from GitHub

1. Download the repository
2. Unblock the zip file
3. Extract the folder to a module path (e.g. $home\Documents\WindowsPowerShell\Modules)
4. Run build.ps1 (exists in project root).
   • NOTE: If you get an error after running build.ps1 - please use build.ps1 -InstallDependencies
5. build.ps1 creates a folder called ~\buildoutput\AdsiPs in the directory which AdsiPs was saved to
6. Inside of \buildoutput\AdsiPs there is a file called AdsiPs.psm1
7. Run Import-Module -Path "C:\Path\To\buildoutput\AdsiPs\AdsiPs.psm1" to import the AdsiPs module

Documentation

• Functions
• Contributing & TODO
• Use cases

Thanks to all our Contributors!

• @LazyWinAdmin
• @MickyBalladelli
• @christophekumor
• @omiossec
• @oze4
• @andrewtchilds
• @NicolasBn
• @gerane
• @Skoetting
• @LaurentLienhard
• @JM2K69

Resources

• MSDN is a great resource if you want to find more information on the NET classes to use. See System.DirectoryServices
• Interesting projects using different approaches to reach out to Active Directory in PowerShell/c#
  • ADAudit by @darkoperator
  • ADSI on powershell.com by @TobiasPSP by Tobias Weltner
  • ADRecon from @sense-of-security
  • PowerView from @PowerShellMafia team
  • Invoke-Kerberoast from @EmpireProject team
  • PSAD by @zloeber
  • Test-ActiveDirectory by @markwragg
  • AdEnumerator(LDAP) by @chango77747
  • Grant-ADPermission by @edemilliere
  • ADSec by @FriedrichWeinmann