Déployer l'Agent Cybernetics sur un parc Windows : installation silencieuse par GPO avec fichier transform MSI (.mst), script PowerShell, commandes msiexec avec Client ID et Clé API Agent.

🔑 PRÉREQUIS · Plan tous (1 agent en Freemium, 25 en Premium, illimité en Enterprise) · Rôle Administrateur

Menu utilisateur > Paramètres > API

Déploiement de l'Agent Cybernetics via les stratégies de groupe

Ce guide explique comment déployer silencieusement l'agent sur un parc Windows via les GPO de l'Active Directory.

Avant de commencer

Le Client ID et la Clé API Agent (Paramètres > API, depuis Cybernetics) ;
La console GPMC installée sur le contrôleur de domaine ;
Les droits d'administration sur le domaine ;
L'installateur .msi de l'agent (x86_64), à télécharger depuis l'onglet Installation de la carte Agent Cybernetics ;
Le script Generate-CyberneticsMst.ps1, fourni par le support, qui génère le fichier transform (.mst).

Le Client ID et la Clé API Agent se trouvent dans Menu utilisateur > Paramètres > API.

Paramètres > API : le Client ID et la Clé API Agent

le Client ID : l'identifiant de votre entreprise ;
la Clé API Agent : Générer la crée, Régénérer la remplace. Elle ne s'affiche qu'une fois : copiez-la aussitôt. Après régénération, les agents installés avec l'ancienne clé ne peuvent plus s'authentifier : redéployez-les avec la nouvelle.

1. Placer le MSI sur le réseau

Le fichier MSI doit être accessible depuis les machines clientes via un chemin UNC. Les commandes de cet article le nomment cybernetics-agent-{version}-windows.msi : adaptez-les au nom du fichier téléchargé.

2. Générer le fichier transform (.mst)

La GPO (Installation de logiciels) ne permet pas de passer des paramètres MSI directement. Il faut embarquer le Client ID et la Clé API Agent dans un fichier transform (.mst) via le script Generate-CyberneticsMst.ps1 fourni par Cybernetics.

3. Exécuter le script sur un appareil Windows

Avec PowerShell, exécuter :

$key = Read-Host "Clé API Agent" -AsSecureString

.\Generate-CyberneticsMst.ps1 `
    -MsiPath    "\\<votre_partage>\cybernetics-agent-{version}-windows.msi" `
    -CompanyId  "<COMPANY_ID>" `
    -AgentApiKey $key

Le fichier cybernetics.mst est généré dans le même dossier que le .msi.

4. Créer la GPO

Ouvrir Gestion des stratégies de groupe (gpmc.msc) ;
Clic droit sur l'OU cible → Créer un objet GPO dans ce domaine ;
Nommer la GPO (ex. : Deploiement Agent Cybernetics) ;
Clic droit sur la GPO → Modifier.

5. Configurer le package logiciel

Dans l'éditeur de stratégie de groupe :

Configuration ordinateur
  └── Stratégies
        └── Paramètres du logiciel
              └── Installation de logiciels

Clic droit → Nouveau > Package ;
Dans la boîte de dialogue, saisir manuellement le chemin UNC :
```
\\<votre_partage>\cybernetics-agent-{version}-windows.msi
```
Choisir le mode Avancé (pour pouvoir ajouter le transform) ;
Onglet Modifications → Ajouter → sélectionner cybernetics.mst via son chemin UNC :
```
\\<votre_partage>\cybernetics.mst
```
Valider.

L'agent s'installe au prochain démarrage des machines de l'OU avec les identifiants embarqués, sans interaction utilisateur.

6. Forcer l'application sur une machine de test

gpupdate /force

Puis redémarrer la machine. L'installation se déclenche avant l'écran de connexion.

Déploiement manuel de l'Agent Cybernetics

Exécuter l'une des deux commandes suivantes dans votre terminal Windows :

Sans transform

msiexec /i "cybernetics-agent-{version}-windows.msi" /quiet /norestart COMPANY_ID="<company-id>" AGENT_API_KEY="<api-key>"

Avec transform

msiexec /i "\\<votre_partage>\cybernetics-agent-{version}-windows.msi" TRANSFORMS="\\<votre_partage>\cybernetics.mst" /qn

Articles liés

Une question ? Nous contacter.