Enregistrement de session dynamique
Auparavant, l’enregistrement de session commençait 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 des 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, VDA et Delivery Controller vers la version 7.18 ou ultérieure.
Activer ou désactiver l’enregistrement de session dynamique
Sur l’agent Session Recording, 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é, suivez les étapes suivantes :
- Une fois l’installation de Session Recording terminée, connectez-vous en tant qu’administrateur à la machine sur laquelle vous avez installé l’agent Session Recording.
- 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 Session Recording 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 entraîner de graves problèmes pouvant nécessiter la réinstallation de votre système d’exploitation. Citrix® ne peut garantir que les problèmes résultant d’une utilisation incorrecte de l’Éditeur du Registre pourront être résolus. Utilisez l’Éditeur du Registre à vos propres risques. Assurez-vous de sauvegarder le registre avant de le modifier.
Démarrer ou arrêter dynamiquement l’enregistrement à l’aide de commandes PowerShell dans les SDK Citrix
Vous pouvez utiliser la fonctionnalité d’enregistrement dynamique de session dans les environnements sur site et Citrix Cloud. Pour utiliser la fonctionnalité dans un environnement sur site, utilisez le SDK PowerShell Citrix Virtual Apps and Desktops™. Pour utiliser la fonctionnalité dans un environnement Citrix Cloud, utilisez le SDK PowerShell distant Citrix DaaS (anciennement SDK PowerShell distant Citrix Virtual Apps and Desktops).
Pour déterminer quel SDK installer et utiliser, tenez compte du Delivery Controller™ que vous avez spécifié lors de la création de votre stratégie d’enregistrement. Si vous cochez la case Citrix Cloud Controller pour enregistrer des sessions dans un environnement Citrix Cloud, vous devez valider vos informations d’identification Citrix Cloud.
Remarque :
N’installez pas le SDK PowerShell distant Citrix DaaS sur une machine Citrix Cloud Connector™. Vous pouvez installer le SDK PowerShell distant sur n’importe quelle machine jointe à un domaine au sein du même emplacement de ressources. Nous vous recommandons de ne pas exécuter les cmdlets de ce SDK sur les Cloud Connectors. Le fonctionnement du SDK n’implique pas les Cloud Connectors.
Le tableau suivant répertorie trois commandes PowerShell que les deux SDK Citrix fournissent pour l’enregistrement dynamique de session.
| 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 le statut 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’un support rapide, vous pouvez utiliser cette fonctionnalité pour démarrer dynamiquement l’enregistrement des sessions actives de l’utilisateur. Vous pouvez lire l’enregistrement en direct pour procéder au dépannage ultérieur. Vous pouvez effectuer les opérations suivantes :
-
(Pour le SDK PowerShell de Citrix Virtual Apps™ et Desktops uniquement) 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 le statut 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 \ UserADé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 $falseDémarre l’enregistrement de toutes les sessions de l’utilisateur UserA dans le domaine nommé DomainA et n’avertit pas UserA. Start-BrokerSessionRecording -Sessions $SessionObjectDémarre l’enregistrement de toutes les sessions dans l’objet nommé $SessionObject et avertit 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,…,uidnDémarre l’enregistrement des sessions UID1,UID2, … , etUIDn, 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 et poursuivez le dépannage.
Remarque :
Lorsque vous lisez un enregistrement Complete terminé par la commande
Stop-BrokerSessionRecording, la dernière section de la chronologie sur la barre de progression du lecteur peut apparaître en gris. De plus, 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\ UserAArrête l’enregistrement de toutes les sessions de l’utilisateur UserA dans le domaine nommé DomainA. Stop-BrokerSessionRecording -Sessions $SessionObjectArrête l’enregistrement de toutes les sessions dans le $SessionObject. Stop-BrokerSessionRecording -Sessions uid1,uid2,…,uidnArrête l’enregistrement des sessions UID1,UID2, … etUIDn.
Sur l’écran Journalisation de Citrix Studio, vous pouvez afficher les journaux résultants des commandes Start-BrokerSessionRecording et Stop-BrokerSessionRecording.
