This Powershell Module utilizes the PSGraph module for visualizing membership relations in your local Active Directory.
Explore the docs »
Report Bug
·
Request Feature
This Powershell Module is visualization tool for membership relations within your local ActiveDirectory. Did you ever
- asked yourself in which nested groups a user is memberOf?
- wanted to compare group membership of multiple users?
- needed to document the current state into a pdf file?
This module provides all this.
To get a local copy up and running follow these simple steps.
All module prerequisites will be installed automatically.
The module is written for Windows Powershell 5.1 and needs the ActiveDirectory installed which is automatically available if RSAT is installed.
The module PSGraph is just a wrapper around GraphViz and is looking for it in the following paths: C:\Program Files\NuGet\Packages\Graphviz*\dot.exe or C:\program files*\GraphViz*\bin\dot.exe
You can install it by running Install-GraphViz (provided by PSGraph) or just manually.
The releases are published in the Powershell Gallery, therefor it is quite simple:
Install-Module ADGraph -Force -AllowClobberThe AllowClobber option is currently neccessary because of an issue in the current PowerShellGet module. Hopefully it will not be needed in the future any more.
Simplest way to get started is to use the provided mini GUI.
Start-ADGraph
Everything you can do in the GUI can be done from the Commandline (as the GUI uses the same functions)
$dn = "CN=joe,OU=Users,DC=mydomain,DC=com"
New-ADGraph -Domain "myDomain" -DN "CN=joe,OU=Users,DC=mydomain,DC=com" -ReturnType "SinglePDF" -ShowPDF $true
Get-ADUser "joe" | New-ADGraph -Domain "myDomain"
New-ADGraph -Domain "myDomain" -DN @("CN=jane,OU=Users,DC=mydomain,DC=com","CN=joe,OU=Users,DC=mydomain,DC=com") -ReturnType "SinglePDF" -ShowPDF $true
I hope everything else can be achieved from the integrated help.
New features will be added if any of my scripts need it ;-)
See the open issues for a list of proposed features (and known issues).
If you need a special function feel free to contribute to the project.
Contributions are what make the open source community such an amazing place to be learn, inspire, and create. Any contributions you make are greatly appreciated. For more details please take a look at the CONTRIBUTE document
Short stop:
- Fork the Project
- Create your Feature Branch (
git checkout -b feature/AmazingFeature) - Commit your Changes (
git commit -m 'Add some AmazingFeature') - Push to the Branch (
git push origin feature/AmazingFeature) - Open a Pull Request
- Does only work with Windows Powershell 5.1, not Powershell Core. I will migrate as soon as the AD functionality is available cross plattform
Distributed under the GNU GENERAL PUBLIC LICENSE version 3. See LICENSE.md for more information.
Project Link: https://github.com/Callidus2000/ADGraph
- Friedrich Weinmann for his marvelous PSModuleDevelopment and psframework
- Icons made by Becris from www.flaticon.com