Passer au contenu principal

Installation de l'agent Kapsul par GPO

Cet article décris la procédure de déploiement automatisé de l'agent Serveur de Kabeen sur des serveurs Windows via une GPO Microsoft

Matthieu Bonnard avatar
Écrit par Matthieu Bonnard
Mis à jour il y a plus d’une semaine

Dans un environnement Active Directory, l’agent Kapsul peut être installé automatiquement sur les serveurs ou postes membres du domaine via une tâche planifiée Windows, créée et gérée par une GPO.

Le principe :

  1. Un script CMD vérifie si Kapsul est déjà installé (présence du service Windows).

  2. Si ce n’est pas le cas, il lance l’installateur en mode silencieux avec la clé API.

  3. La tâche planifiée exécute régulièrement ce script (compte SYSTEM), ce qui garantit un déploiement progressif et idempotent.

Préparer l’installateur

  1. Téléchargez l’installateur Windows de Kapsul kapsul-setup.exe depuis l'interface Kabeen.

  2. Copiez ce fichier dans un partage réseau accessible en lecture par les comptes ordinateurs du domaine, par exemple :

    \\SERVEUR-FICHIERS\deploiement\kapsul\kapsul-setup.exe

Créer le script d’installation (CMD)

Créez un fichier install-kapsul.cmd dans le même partage, par exemple :
\\SERVEUR-FICHIERS\deploiement\kapsul\install-kapsul.cmd

Collez le contenu suivant, en adaptant le chemin UNC et la clé d’API :

@echo off
setlocal enabledelayedexpansion

REM ============================================================
REM Script d'installation silencieuse de l'agent Kapsul
REM À utiliser via une tâche planifiée (déployée par GPO)
REM ============================================================

REM --- Paramètres à personnaliser ---
set "KAPSUL_SETUP_PATH=\\SERVEUR-FICHIERS\deploiement\kapsul\kapsul-setup.exe"
set "KAPSUL_API_KEY=VOTRE_CLE_API_KABEEN"

REM --- Vérifier si Kapsul est déjà installé (contrôle sur le service) ---
sc query "kapsul" >nul 2>&1
if %errorlevel%==0 (
echo [Kabeen] L'agent Kapsul semble déjà installé. Fin du script.
goto :EOF
)

REM --- Vérifier la présence de l'installateur ---
if not exist "%KAPSUL_SETUP_PATH%" (
echo [Kabeen] ERREUR : impossible de trouver l'installateur Kapsul : %KAPSUL_SETUP_PATH%
goto :EOF
)

echo [Kabeen] Lancement de l'installation silencieuse de Kapsul...

REM --- Installation silencieuse ---
"%KAPSUL_SETUP_PATH%" /SILENT /KEY=%KAPSUL_API_KEY%

REM --- Vérification basique après installation ---
sc query "kapsul" >nul 2>&1
if %errorlevel%==0 (
echo [Kabeen] Installation Kapsul OK.
) else (
echo [Kabeen] ATTENTION : le service Kapsul n'a pas été trouvé après installation.
)

endlocal
exit /b 0

Le script est idempotent : si le service kapsul existe déjà, il ne lance pas une nouvelle installation.

Créer la tâche planifiée via GPO

  1. Ouvrez la Console de gestion des stratégies de groupe (GPMC).

  2. Créez une nouvelle GPO (par ex. : Déploiement Kapsul - tâche planifiée) ou modifiez une GPO existante.

  3. Éditez la GPO et naviguez vers :

    Configuration ordinateur
    → Préférences
    → Paramètres du Panneau de configuration
    → Tâches planifiées

  4. Clic droit sur Tâches planifiéesNouveauTâche planifiée (au moins Windows 7).

    Onglet : Général
    Nom : Installer Kapsul
    Description : Installation silencieuse de l’agent Kapsul via script CMD
    Compte de sécurité : SYSTEM
    Cocher : Exécuter même si l’utilisateur n’est pas connecté
    Cocher : Exécuter avec les autorisations maximales
    Configurer pour : la version de Windows de vos serveurs (ex. Windows Server 2016).

    Onglet : Déclencheur
    Cliquez sur Nouveau… :
    Début de la tâche : Au démarrage
    Optionnel : ajouter un second déclencheur Toutes les 1 heure si vous voulez un rattrapage en continu (le script ne fera rien si Kapsul est déjà installé).

    Onglet : Action
    Action : Démarrer un programme
    Programme/script : cmd.exe
    Ajouter des arguments : /c "\\SERVEUR-FICHIERS\deploiement\kapsul\install-kapsul.cmd"

  5. Lier la GPO aux machines cibles et vérifier

Contrôle

  • La présence de la tâche planifiée Installer Kapsul dans le Planificateur de tâches.

  • La présence du service Kapsul dans la console des services Windows.

Avez-vous trouvé la réponse à votre question ?