ℹ️ À savoir · En bref
WEM remplace les scripts d'ouverture de session et une bonne partie des GPO utilisateur : un agent installé sur le VDA applique, pendant et après l'ouverture de session, des actions (lecteurs, imprimantes, raccourcis, registre…) selon des règles, et optimise les ressources de la machine.
L'agent garde un cache local : il continue d'appliquer la dernière configuration même si l'infrastructure WEM est injoignable.
Objectifs de la fiche
- Comprendre l'architecture du service WEM et le rôle de l'agent.
- Construire une configuration : actions, affectations, filtres.
- Régler l'optimisation système et la sécurité des sessions.
- Dépanner un agent (mode Basic, cache, journaux).
Architecture
| WEM service (Citrix Cloud) | WEM sur site | |
|---|---|---|
| Console | Console web dans Citrix Cloud (Gérer › WEM) | Console web et console d'administration historique |
| Infrastructure | Hébergée par Citrix (base Azure SQL) | Serveurs d'infrastructure + base SQL Server à toi |
| Lien avec l'agent | HTTPS via les Cloud Connectors (ou inscription de l'agent) | Ports 8286 (agent) et 8285 (synchro du cache) |
| Mises à jour | Gérées par Citrix | À planifier (infrastructure, base, agents) |
L'agent comprend un service machine (Citrix WEM Agent Host Service) et un agent de session lancé à l'ouverture et à la reconnexion. Il fonctionne sur VDA mono et multisession, et sur postes physiques Windows.
Relier l’agent à l’infrastructure
| Méthode | Détail |
|---|---|
| Stratégie de groupe | Importer les modèles ADMX « Agent Group Policies », puis renseigner Citrix Cloud Connectors (ou « Discover Citrix Cloud Connector from CVAD service ») |
| Ligne de commande | Cloud=1 CloudConnectorList=cc1.corp.local,cc2.corp.local à l'installation |
| Inscription (enrollment) | Installer avec « Skip Configuration » puis inscrire l'agent depuis la console |
| Ensemble de configuration | Dans la console, Objets d'annuaire : lier les machines, OU ou groupes de machines à un ensemble de configuration |
⚠️ Piège
Une installation neuve démarre en mode Basic (déploiement « de base » : optimisations par défaut, aucune connexion à l'infrastructure). Tant que l'agent ne reçoit pas sa configuration de connexion, il y reste.
Symptôme typique : journal « WEM Agent Service » avec BasicMode: 1. Vérifier que les ADMX WEM sont importés et appliqués sur l'OU des VDA, ou forcer le type avec la stratégie Override Agent Deployment Type.
Construire la configuration
| Brique | Rôle | Exemple |
|---|---|---|
| Action | Ce qu'on applique | Lecteur H: vers \\fs\home\%username%, imprimante, raccourci, valeur de registre, variable d'environnement, fichier INI |
| Groupe d'actions | Regrouper des actions pour les affecter d'un coup | « Socle Compta » : 2 lecteurs + 3 raccourcis + 1 imprimante |
| Affectation | Lier une action à un utilisateur ou un groupe AD | GG-Compta reçoit « Socle Compta » |
| Filtre (règle + conditions) | Condition supplémentaire évaluée sur la session | Seulement si le client est dans le site AD « Lille » ou si le nom du poste commence par TC- |
💡 Astuce
Affecte aux groupes, jamais aux utilisateurs un par un, et garde peu de filtres réutilisables (« Site Lille », « Client léger », « Session multisession »).
L'assistant de modélisation (Modeling Wizard) et les rapports de l'agent montrent ce qu'un utilisateur recevra : à consulter avant d'accuser WEM.
Optimisation système
| Réglage | Effet |
|---|---|
| Protection contre les pics CPU | Baisse la priorité d'un processus qui dépasse un seuil (ex. 70 % pendant 15 s) pour protéger les autres sessions |
| Optimisation de la mémoire | Libère la mémoire de travail des processus inactifs depuis un certain temps |
| Priorité d'E/S | Donne une priorité d'entrées-sorties par processus |
| Déconnexion rapide (fast logoff) | Ferme visuellement la session tout de suite, le nettoyage se fait en arrière-plan |
| Optimisation multisession | Baisse la priorité des sessions déconnectées sur les serveurs multisession |
| Citrix Optimizer | Applique des modèles d'optimisation de Windows depuis WEM |
Sécurité et profils
- Contrôle des applications : règles d'autorisation par chemin, éditeur ou hachage (basées sur AppLocker), avec un mode audit pour tester.
- Élévation de privilèges : lancer une application précise en administrateur sans donner de droits d'administration à l'utilisateur.
- Gestion des processus : listes blanches / noires de processus par utilisateur ou groupe.
- Profils : WEM sait configurer Citrix Profile Management (voir CTX-02) ; garde une seule source de configuration par paramètre (WEM ou GPO ou stratégie Studio).
Dépanner un agent
commandes utiles
# Forcer la récupération de la configuration (sur le VDA, en administrateur)
cd "C:\Program Files (x86)\Citrix\Workspace Environment Management Agent"
.\AgentCacheUtility.exe -RefreshCache # recharge le cache depuis l'infrastructure
.\AgentCacheUtility.exe -RefreshSettings # actualise les paramètres de l'agent
.\AgentCacheUtility.exe -Reinitialize # réinitialise complètement le cache
# Vérifier le mode et la connexion
Get-WinEvent -LogName "WEM Agent Service" -MaxEvents 30 |
Where-Object Message -match "BasicMode|CloudAgent|Connector" |
Select-Object TimeCreated, Message
| Symptôme | Cause probable | Parade |
|---|---|---|
| Agent en mode Basic | Aucune configuration de connexion reçue (ADMX absent, mauvaise OU) | Importer les ADMX WEM, vérifier gpresult, Override Agent Deployment Type |
| Modification de console ignorée | Cache de l'agent pas encore actualisé | Actualiser depuis la console ou AgentCacheUtility -RefreshCache |
| Action non appliquée | Pas d'affectation ou filtre faux | Modélisation, vérifier groupes et conditions |
| Machine non visible dans la console | Machine non liée à un ensemble de configuration | Objets d'annuaire : ajouter la machine ou son OU |
| Paramètre qui « revient » | Même réglage poussé aussi par GPO ou Studio | Une seule source de vérité par paramètre |
🔷 En contexte Citrix
Sur des VDA MCS non persistants, place le cache de l'agent sur un disque persistant (ou accepte sa reconstruction au démarrage) et laisse l'agent dans l'image maître sans configuration propre à une machine.
Une modernisation classique : remplacer les scripts d'ouverture de session (lecteurs, imprimantes) par des actions WEM filtrées par site, puis mesurer le gain dans Monitor (CTX-03).
À retenir
- Agent + cache local ; infrastructure hébergée par Citrix dans le service WEM.
- Action → affectation (groupe) → filtre : les trois doivent être vrais.
- Machines liées à un ensemble de configuration via les objets d'annuaire.
- Installation neuve = mode Basic tant que la connexion n'est pas configurée.
- Une seule source de configuration par paramètre (WEM, GPO ou Studio).
Auto-évaluation
Q1. Ton agent affiche BasicMode: 1 alors que les Cloud Connectors sont renseignés dans le registre. Que vérifies-tu ?
→ Que les ADMX WEM sont importés et appliqués sur l'OU des VDA (clé de stratégie attendue par l'agent), avec gpresult ; sinon forcer le type avec Override Agent Deployment Type, puis redémarrer le service.
Q2. Un lecteur réseau ne s'affiche que pour certains utilisateurs du même groupe. Piste ?
→ Le filtre de l'affectation : une condition (site AD, nom du client…) est fausse pour eux. Le vérifier avec l'assistant de modélisation.
Q3. À quoi sert la protection contre les pics CPU ?
→ À baisser la priorité d'un processus qui consomme trop longtemps trop de CPU pour préserver les autres sessions d'un serveur multisession.
Q4. Pourquoi l'agent continue-t-il de fonctionner pendant une panne des Cloud Connectors ?
→ Il applique la dernière configuration stockée dans son cache local.