PSOpenAD

Cross-platform PowerShell module alternative to Microsoft's Active Directory module

MIT License

Stars
97

PSOpenAD

PSOpenAD aims to be a cross-platform PowerShell module alternative to Microsoft's Active Directory module, enhancing AD management with modern capabilities.

See about_PSOpenAD for more details.

Documentation

Documentation for this module and details on the cmdlets included can be found here.

Requirements

These cmdlets have the following requirements

  • PowerShell v7.2 or newer

Installing

The easiest way to install this module is through PowerShellGet or PSResourceGet.

You can install this module by running either of the following Install-PSResource or Install-Module command.

# Install for only the current user
Install-PSResource -Name PSOpenAD -Scope CurrentUser
Install-Module -Name PSOpenAD -Scope CurrentUser

# Install for all users
Install-PSResource -Name PSOpenAD -Scope AllUsers
Install-Module -Name PSOpenAD -Scope AllUsers

The Install-PSResource cmdlet is part of the new PSResourceGet module from Microsoft available in newer versions while Install-Module is present on older systems.

Contributing

Contributing is quite easy, fork this repo and submit a pull request with the changes. To build this module run .\build.ps1 -Task Build in PowerShell. To test a build run .\build.ps1 -Task Test in PowerShell. The script ./tools/run-samba.sh can be used to run Samba inside a test container that is needed to run some of the tests locally. This script will ensure all dependencies are installed before running the test suite.

Badges
Extracted from project README
Test workflow codecov PowerShell Gallery License