whatisgithub

What is activedirectorytiermodel?

microsoft/activedirectorytiermodel — explained in plain English

Analysis updated 2026-08-08 · repo last pushed 2026-08-07

351PowerShellAudience · ops devopsComplexity · 3/5ActiveSetup · hard

In one sentence

A Microsoft toolkit that automates setting up layered security tiers in Windows Active Directory using a JSON config file, so compromised lower-level accounts can't be used to reach more sensitive systems.

Mindmap

mindmap
  root((repo))
    What it does
      Builds tiered AD security
      Reads JSON config file
      Drifts only what changed
      Audits live environment
    Tech stack
      PowerShell
      JSON config
      Microsoft Sentinel
    Use cases
      Stand up tiering first time
      Enforce consistent structure
      Monitor with Sentinel
    Audience
      Enterprise IT admins
      Security engineers
    Setup needs
      Domain Admin rights
      PowerShell 7 plus
      English AD required

Code map

Detail Auto

An interactive map of this repo's files and how they connect — its source is parsed live in your browser. Click Visualize to build it.

filefunction / class

What do people build with it?

USE CASE 1

Stand up a complete tiered Active Directory security structure from a single JSON config file instead of manual click-work.

USE CASE 2

Run the audit script to check if your live Active Directory environment has drifted from your intended configuration.

USE CASE 3

Preview exactly what changes would be applied using WhatIf mode before running the framework for real.

USE CASE 4

Integrate with Microsoft Sentinel to get built-in security detection rules for your tiered environment.

What is it built with?

PowerShellJSONMicrosoft Sentinel

How does it compare?

microsoft/activedirectorytiermodelcylinderchairman/aida64bartates/lunar-client-minecraft
Stars351378284
LanguagePowerShellPowerShellPowerShell
Last pushed2026-08-07
MaintenanceActive
Setup difficultyhardeasyeasy
Complexity3/51/51/5
Audienceops devopsgeneralgeneral

Figures from each repo's GitHub metadata at analysis time.

How do you get it running?

Difficulty · hard Time to first run · 1h+

Requires Domain Admin privileges, PowerShell 7 or later, and both your machine and Active Directory must be in English.

No license is specified in the repository, so default copyright restrictions apply and you should contact Microsoft before using or modifying this code.

So what is it?

Active Directory Tier Model is a Microsoft-built toolkit that helps IT and security teams set up a layered security structure inside Windows Active Directory environments. The "tier model" is a widely recommended approach where administrators and systems are separated into tiers, Tier 0 for the most sensitive domain controllers, Tier 1 for server admins, and Tier 2 for regular workstation admins, so that if a lower-tier account is compromised, attackers can't use it to climb up to more powerful systems. Instead of manually creating all the folders (organizational units), security groups, user accounts, permission rules, and group policies that a tiered setup requires, you describe everything you want in a single JSON configuration file. The framework reads that file and builds out the entire structure for you. You can run it again later and it will only change what's drifted from your intended configuration, leaving everything else untouched. A separate audit script checks whether your live environment still matches what the config file says it should. This is designed for enterprise IT administrators and security engineers who manage Active Directory at scale. For example, a security team rolling out tiering for the first time could use this to stand up the whole structure consistently, rather than relying on tribal knowledge or click-by-click manual work. It also integrates with Microsoft Sentinel for monitoring, so security operations teams get built-in detection rules without writing custom logic. You need to be a Domain Admin running PowerShell 7 or later, and currently both your machine and your Active Directory must be in English. The project is notably strict about contributions because it is a security tool. Any change must be discussed in an issue first and agreed upon before code is written, and pull requests without that prior agreement are simply closed. The maintainers are upfront that this is to prevent well-intentioned changes from accidentally weakening security boundaries. The codebase has extensive automated tests with 80% minimum coverage enforced by CI, and the framework supports "WhatIf" mode so you can preview exactly what would change before applying anything for real.

Copy-paste prompts

Prompt 1
Write a JSON configuration file for the Active Directory Tier Model that defines Tier 0 for domain controllers, Tier 1 for server admins, and Tier 2 for workstation admins with appropriate organizational units and security groups.
Prompt 2
Using the Active Directory Tier Model toolkit, how do I run the framework in WhatIf mode to preview changes before applying them to my live AD environment?
Prompt 3
Generate an audit script invocation for the Active Directory Tier Model that checks whether my live Active Directory still matches my JSON config file, and explain how to read the results.
Prompt 4
Help me set up Microsoft Sentinel integration with the Active Directory Tier Model so I get built-in detection rules for tier boundary violations.

Frequently asked questions

What is activedirectorytiermodel?

A Microsoft toolkit that automates setting up layered security tiers in Windows Active Directory using a JSON config file, so compromised lower-level accounts can't be used to reach more sensitive systems.

What language is activedirectorytiermodel written in?

Mainly PowerShell. The stack also includes PowerShell, JSON, Microsoft Sentinel.

Is activedirectorytiermodel actively maintained?

Active — commit in last 30 days (last push 2026-08-07).

What license does activedirectorytiermodel use?

No license is specified in the repository, so default copyright restrictions apply and you should contact Microsoft before using or modifying this code.

How hard is activedirectorytiermodel to set up?

Setup difficulty is rated hard, with roughly 1h+ to a first successful run.

Who is activedirectorytiermodel for?

Mainly ops devops.

Open on GitHub → Ask about another repo

This repo across BitVibe Labs

Verify against the repo before relying on details.