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 for this module and details on the cmdlets included can be found here.
These cmdlets have the following requirements
- PowerShell v7.2 or newer
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 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.