Skip to content

Latest commit

 

History

History
81 lines (60 loc) · 3.79 KB

README.md

File metadata and controls

81 lines (60 loc) · 3.79 KB

AdsiPS

Build Status

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

This module currently only works on Windows Operating Systems.

Contributing

Contributions are welcome via pull requests and issues. Please see our contributing guide for more details

Getting Started

Download from PowerShell Gallery

Only from PowerShell version 5

Install-Module -name ADSIPS

Download from GitHub repository

  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

Use cases

  1. Learning Active Directory: We can't see the code behind the Microsoft ActiveDirectory Module and Quest ActiveDirectory Snapin. This module is a great way to explore and learn on how Active Directory is working,
  2. Delegation: Active Directory queries need to be performed by a tool (GUI for example) and you don't want it to load AD module. Additionally you don't know who will use the tool and if they have/can/know how to install the module,
  3. Performance: ADSI is faster,
  4. Restricted environment: Sometime ActiveDirectory Module is not available/ or can't install it on a machine.

More Information

Authors

  • Thanks to our Contributors!!
    • @LazyWinAdmin
    • @MickyBalladelli
    • @christophekumor
    • @omiossec
    • @oze4
    • @andrewtchilds
    • @NicolasBn
    • @gerane
    • @GaffaOverflow
    • @Skoetting

Resources

Interesting projects using different approaches to reach out to Active Directory in PowerShell/c#