Enregistrement de session dynamique
Auparavant, l’enregistrement de session démarrait strictement au tout début des sessions qui respectaient les stratégies d’enregistrement et s’arrêtait strictement lorsque ces sessions prenaient fin.
À partir de la version 7.18, Citrix introduit la fonctionnalité d’enregistrement de session dynamique. Grâce à cette fonctionnalité, vous pouvez démarrer ou arrêter l’enregistrement d’une session spécifique, ou de sessions lancées par un utilisateur spécifique, à tout moment pendant les sessions.
Remarque :
Pour que la fonctionnalité fonctionne comme prévu, mettez à niveau Session Recording, le VDA et le Delivery Controller vers la version 7.18 ou ultérieure.
Activer ou désactiver l’enregistrement de session dynamique
Sur l’agent d’enregistrement de session, une valeur de registre est ajoutée pour activer ou désactiver la fonctionnalité. La valeur de registre est définie sur 1 par défaut, ce qui signifie que la fonctionnalité est activée par défaut.
Pour activer ou désactiver la fonctionnalité, procédez comme suit :
- Une fois l’installation de Session Recording terminée, connectez-vous en tant qu’administrateur à la machine sur laquelle vous avez installé l’agent d’enregistrement de session.
- Ouvrez l’Éditeur du Registre.
- Accédez à
HKEY_LOCAL_MACHINE\SOFTWARE\Citrix\SmartAuditor. - Définissez la valeur de DynamicControlAllowed sur 0 ou utilisez la valeur par défaut, 1. 1 : activer l’enregistrement dynamique 0 : désactiver l’enregistrement dynamique
- Redémarrez l’agent d’enregistrement de session pour que votre paramètre prenne effet. Si vous utilisez MCS ou PVS pour le déploiement, modifiez le paramètre sur votre image principale et effectuez une mise à jour pour que votre modification prenne effet.
Avertissement :
Toute modification incorrecte du registre peut générer des problèmes sérieux, pouvant vous obliger à réinstaller votre système d’exploitation. Citrix® ne peut garantir que les problèmes résultant d’une mauvaise utilisation de l’Éditeur du Registre puissent être résolus. Utilisez l’Éditeur du Registre à vos propres risques. Veillez à sauvegarder le registre avant de le modifier.
Démarrer ou arrêter dynamiquement l’enregistrement à l’aide de commandes PowerShell dans le SDK Citrix Broker
Le tableau suivant répertorie trois commandes PowerShell ajoutées dans le SDK Citrix Broker pour la fonctionnalité d’enregistrement dynamique de session. Pour plus d’informations sur le SDK Citrix Broker, consultez Citrix SDKs and APIs et Citrix Virtual Apps and Desktops SDK.
| Commande | Description |
|---|---|
| Start-BrokerSessionRecording | Permet de démarrer l’enregistrement d’une session active spécifique, d’une liste de sessions actives ou de sessions lancées par un utilisateur spécifique. Pour plus d’informations, exécutez Get-Help Start-BrokerSessionRecording pour consulter l’aide en ligne de la commande. |
| Stop-BrokerSessionRecording | Permet d’arrêter l’enregistrement d’une session active spécifique, d’une liste de sessions actives ou de sessions lancées par un utilisateur spécifique. Pour plus d’informations, exécutez Get-Help Stop-BrokerSessionRecording pour consulter l’aide en ligne de la commande. |
| Get-BrokerSessionRecordingStatus | Permet d’obtenir l’état d’enregistrement d’une session active spécifique. Pour plus d’informations, exécutez Get-Help Get-BrokerSessionRecordingStatus pour consulter l’aide en ligne de la commande. |
Par exemple, lorsqu’un utilisateur signale un problème et a besoin d’une assistance rapide, vous pouvez utiliser cette fonctionnalité pour démarrer dynamiquement l’enregistrement des sessions actives de l’utilisateur et relire l’enregistrement en direct pour poursuivre le dépannage. Vous pouvez effectuer les opérations suivantes :
-
Lancez PowerShell depuis la console Citrix Studio.
-
Utilisez la commande
Get-BrokerSessionpour obtenir toutes les sessions actives de l’utilisateur cible.
-
Utilisez la commande
Get-BrokerSessionRecordingStatuspour obtenir l’état d’enregistrement de la session spécifiée.
Remarque :
Le paramètre -Session ne peut accepter qu’un seul Uid de session à la fois.
-
Utilisez la commande
Start-BrokerSessionRecordingpour démarrer l’enregistrement. Par défaut, un message de notification apparaît pour informer les utilisateurs de l’activité d’enregistrement.Le tableau suivant présente les façons courantes d’utiliser la commande
Start-BrokerSessionRecording.Commande Description Start-BrokerSessionRecording -User DomainA \ UserA Démarre l’enregistrement de toutes les sessions de l’utilisateur UserA dans le domaine nommé DomainA et notifie UserA. Start-BrokerSessionRecording -User DomainA \ UserA -NotifyUser $false Démarre l’enregistrement de toutes les sessions de l’utilisateur UserA dans le domaine nommé DomainA et ne notifie pas UserA. Start-BrokerSessionRecording -Sessions $SessionObject Démarre l’enregistrement de toutes les sessions dans l’objet nommé $SessionObject et notifie l’utilisateur. Pour obtenir l’objet $SessionObject, exécutez $SessionObject=Get-BrokerSession –username UserA. Le nom d’un objet est précédé d’un signe dollar $. Pour plus d’informations, consultez l’étape 2 et l’aide en ligne de la commande.Start-BrokerSessionRecording -Sessions uid1,uid2,…,uidn Démarre l’enregistrement des sessions uid1, uid2, … , et uidn, et avertit les utilisateurs. -
Utilisez la commande
Get-BrokerSessionRecordingStatuspour obtenir l’état d’enregistrement de chaque session cible. L’état doit être SessionBeingRecorded. -
Lisez les enregistrements Live ou Complete dans le lecteur d’enregistrement de session et poursuivez le dépannage.
Remarque :
La dernière section de la chronologie sur la barre de progression du lecteur peut apparaître en gris lorsque vous lisez un enregistrement « Complete » terminé par la commande
Stop-BrokerSessionRecordinget que la dernière section de la session enregistrée est inactive. Ce n’est pas évident lorsque la session enregistrée a des activités constantes. -
Utilisez la commande
Stop-BrokerSessionRecordingpour arrêter l’enregistrement lorsque le problème signalé a été trié ou résolu.Le tableau suivant présente les façons courantes d’utiliser cette commande :
Commande Description Stop-BrokerSessionRecording -User DomainA \ UserA Arrête l’enregistrement de toutes les sessions de l’utilisateur UserA dans le domaine nommé DomainA. Stop-BrokerSessionRecording -Sessions $SessionObject Arrête l’enregistrement de toutes les sessions dans le $SessionObject. Stop-BrokerSessionRecording -Sessions uid1,uid2,…,uidn Arrête l’enregistrement des sessions uid1, uid2, … , et uidn.
Sur l’écran Journalisation de Citrix Studio, vous pouvez consulter les journaux résultants des commandes Start-BrokerSessionRecording et Stop-BrokerSessionRecording.
