Home

Welcome to the PSADHealth wiki!

What does this toolkit do?

This toolkit contains a number of monitors for validating the health of Active Directory. The toolkit consists of functions and scripts that will check specific areas of Active Directory that can be troublesome to keep an eye on with other tools. Each tool in the kit is meant to check a particular aspect of Active Directory and return a result.

The goal is to have this tool run the various included tasks at regular intervals and alert you only when there is an issue. These tools are designed to be run as scheduled tasks or scheduled jobs and send email alerts, chatbot updates, slack notifications, etc. You can send the results to the tool that works best for you!

These scripts are built by a group of individuals who recognized that the monitoring tools in their org's were either not able to perform these tests or the tools that could, were too expensive to purchase. They created their own tools and collaborated to make a toolkit of unique, yet useful functions to help them keep better tabs on their AD infrastructure.

Tool Selection

You may not need or want to run all of the included scripts/tests. Every environment is unique and you should feel free to pick and choose what you want to be run. Each tool is independent of the others, which allows you to run what you want and even augment what we have provided. Even better yet, got a script that checks something we didn't think of? Why don't you contribute that script to the project!

Caveat Emptor (Buyer Beware)

These scripts test and modify the core pieces of a company Directory Services infrastructure. Test our scripts in your environment carefully before you fully implement and set on auto-pilot! All scripts have been tested in multiple environments by the authors and we're committed to releasing quality code, but please be smart and make sure everything works as expected in YOUR environment!

We are constantly improving this project but it will always be a continual "work in progress". See the TBD highlights in the WIKI for each script to see where we have identified possible missing levels of configuration.

• One area we're light on right now is Error Handling, so keep that in mind.
• Also, check the issue lists for possible bugs and issues.
• If you come across a problem, please submit an issue so we can correct it.