⚡ PowerShell Active Directory Bulk User Onboarding

📌 Project Overview

This project demonstrates enterprise administrative automation using PowerShell to provision Active Directory (AD) user accounts from structured external CSV data files.

Automating bulk user creation minimizes human error, standardizes organizational attribute formatting, and saves hours of Tier 1/2 IT support desk labor.

---

🛠️ Key Technologies & Skills Demonstrated

• Scripting Language: PowerShell 5.1 / Active Directory Module
• Identity Management: Active Directory Domain Services (AD DS)
• Error Handling & Safeguards: Existential checking, duplicate prevention, and exception catching
• Auditing: Structured transaction logging (OnboardingLog.txt)

---

📂 Repository File Structure

├── scripts/
│   └── New-ADUserOnboarding.ps1   # Main PowerShell onboarding automation script
├── images/
│   ├── 01-powershell-execution.png
│   ├── 02-ad-users-created.png
│   └── 03-duplicate-handling.png
├── users.csv                       # Sample input CSV data template
└── README.md                       # Documentation page

⚙️ How It Works

1. Data Parsing: Reads identity parameters (FirstName, LastName, Username, Department, OUPath) from users.csv.

2. Duplicate Check: Runs Get-ADUser against SamAccountName. If the user exists, the script logs a warning and gracefully skips execution.

3. Account Creation: If unique, uses New-ADUser to bind the account to designated Organizational Units (OUs), enforces temporary passwords, and sets ChangePasswordAtLogon = $true.

4. Audit Log: Writes timestamps and status flags ([SUCCESS], [SKIP], [ERROR]) to OnboardingLog.txt.

📸 Execution & Proof of Work

1. PowerShell Script Execution

2. Active Directory Verification (dsa.msc)

3. Duplicate Handling Safeguard