🐙 CephaloShell

Console interactive et modulaire en PowerShell pour l'administration Active Directory et le diagnostic réseau.
Centralisation des tâches courantes d'administration système (AD, WSUS, LAPS, Remote Shell, WoL) au sein d'une interface CLI dynamique.

---

🎯 Aperçu & Objectif

CephaloShell est un outil CLI PowerShell conçu pour simplifier et accélérer l'administration quotidienne des infrastructures Active Directory et réseaux locaux.

Il évite la saisie répétitive de commandes PowerShell complexes en proposant un menu interactif structuré, habillé d'une mascotte en ASCII Art. L'outil permet de gérer les objets AD, d'exécuter des actions à distance sur les postes, de diagnostiquer le réseau et d'effectuer la maintenance WSUS/GPO en quelques touches.

⠀⠀⠀⠀⠀⠀⢀⣀⣠⣀⣀⡀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀
⠀⠀⠀⠀⣠⣾⣿⣿⣿⣿⣿⣿⣷⣦⡀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀
⠀⠀⠀⢠⣿⣿⣿⣿⣿⣿⣿⣿⣿⣿⣷⡀⠀⠀⠀⣠⣶⣾⣷⣶⣄⠀⠀⠀⠀⠀
⠀⠀⠀⢸⣿⣿⣿⣿⣿⣿⣿⣿⣿⣿⣿⣧⠀⠀⢰⣿⠟⠉⠻⣿⣿⣷⠀⠀⠀⠀
⠀⠀⠀⠈⣿⣿⣿⣿⣿⣿⣿⣿⣿⣿⣿⠿⢷⣄⠘⠿⠀⠀⠀⢸⣿⣿⡆⠀⠀⠀
⠀⠀⠀⠀⠈⠿⣿⣿⣿⣿⣿⣀⣸⣿⣷⣤⣴⠟⠀⠀⠀⠀⢀⣼⣿⣿⠁⠀⠀⠀
⠀⠀⠀⠀⠀⠀⠈⠙⣛⣿⣿⣿⣿⣿⣿⣿⣿⣦⣀⣀⣀⣴⣾⣿⣿⡟⠀⠀⠀⠀
⠀⠀⠀⢀⣠⣴⣾⣿⣿⣿⣿⣿⣿⣿⣿⣿⣿⣿⣿⣿⡿⠟⠋⣠⣤⣀⠀⠀
⠀⠀⣴⣿⣿⣿⠿⠟⠛⠛⢛⣿⣿⣿⣿⣿⣿⣧⡈⠉⠁⠀⠀⠀⠈⠉⢻⣿⣧⠀
⠀⣼⣿⣿⠋⠀⠀⠀⠀⢠⣾⣿⣿⠟⠉⠻⣿⣿⣿⣦⣄⠀⠀⠀⠀⠀⣸⣿⣿⠃
⠀⣿⣿⡇⠀⠀⠀⠀⠀⣿⣿⡿⃁⠀⠀⠀⠈⠛⢿⣿⣿⣿⣿⣶⣿⣿⣿⡿⠋⠀
⠀⢿⣿⣧⡀⠀⣶⣄⠘⣿⣿⡇⠀⠀⠀⣸⣿⡇⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀
⠀⠈⠻⣿⣿⣿⣿⠏⠀⢻⣿⣿⣄⠀⠀⠀⣸⣿⡇⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀
⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠻⣿⣿⣿⣶⣾⣿⣿⠃⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀
⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠈⠙⠛⠛⠛⠋⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀

---

✨ Fonctionnalités clés

🛡️ Administration Active Directory (AD)

• Gestion des Utilisateurs : Recherche avec sélection interactive, consultation des détails et groupes, réinitialisation de mot de passe, verrouillage/déverrouillage, déplacement d'OU.
• Gestion des Ordinateurs : Inspection du poste, session à distance, mise à jour des GPO à distance (Invoke-GPUpdate), consultation du mot de passe administrateur local via LAPS (Get-AdmPwdPassword).
• Gestion des Groupes : Export CSV des membres (<NomGroupe>-members.csv), ajout/suppression de membres, déplacement d'OU.
• Santé de l'AD : Contrôle rapide du statut de réplication inter-DC (repadmin /replsum).

🌐 Diagnostics & Réseau

• Outillage diagnostic : Tests de connectivité (Ping, DNS, tracert, nslookup), balayage de sous-réseau IP (/24).
• Administration distante : Console à distance via Invoke-Command et exécution de commandes ciblées.
• Wake-on-LAN (WoL) : Envoi de paquets magiques (Magic Packets) UDP pour le démarrage de postes à distance via adresse MAC.

🔄 Maintenance Systèmes & GPO

• Réinitialisation client WSUS : Arrêt des services, purge de SoftwareDistribution, suppression du SusClientId, réenregistrement et génération automatique des journaux d'événements (Get-WindowsUpdateLog).
• Mise à jour GPO : Force l'exécution de gpupdate /force en local ou sur machine distante.

---

🚀 Installation & Prérequis

Prérequis

• OS : Windows 10 / 11 ou Windows Server
• Environnement : PowerShell 5.1 ou PowerShell 7+
• Modules PowerShell :
  • Module ActiveDirectory (inclus dans RSAT)
  • Module LAPS (optionnel, uniquement pour la lecture du mot de passe admin local)
• Privilèges : Exécution recommandée en tant qu'Administrateur (nécessaire pour la gestion AD, les sessions distantes et l'arrêt de services).

Installation

# Cloner le dépôt
git clone [https://github.com/CyberPoulpe/CephaloShell.git](https://github.com/CyberPoulpe/CephaloShell.git)
cd CephaloShell

# Débloquer le script si nécessaire
Unblock-File -Path .\CephaloShell.ps1

---

💡 Utilisation

1. Lancement du script (console Administrateur) :

   .\CephaloShell.ps1

2. Navigation : Entrez le numéro correspondant à l'action souhaitée. Saisissez q à tout moment pour revenir au menu précédent ou quitter.
3. Recherche AD interactive : Tapez simplement le début d'un nom d'utilisateur ou de groupe ; en cas de multiples correspondances, un choix numéroté est proposé automatiquement.

---

🛡️ Sécurité & Avertissement

L'utilisation de cet outil nécessite des privilèges d'administration sur le domaine ou la machine locale. L'utilisateur est responsable des actions exécutées sur le réseau. Testez toujours les fonctions de maintenance dans un environnement contrôlé avant déploiement en production.

---

📄 Licence & Contact

• Licence : MIT — voir LICENSE
• Auteur : CyberPoulpe
• GitHub : @CyberPoulpe