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 à la fin de ces sessions.
À 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 ou plusieurs sessions spécifiques 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 en utilisant des 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 cette fonctionnalité dans un environnement sur site, utilisez le SDK PowerShell de Citrix Virtual Apps and Desktops™. Pour utiliser cette fonctionnalité dans un environnement Citrix Cloud, utilisez le SDK PowerShell distant de 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.
Créer une requête vers le contrôleur(/fr-fr/session-recording/2201/media/create-query-to-ddc.png)
Remarque :
N’installez pas le SDK PowerShell distant 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’une assistance rapide, vous pouvez utiliser la fonctionnalité pour démarrer dynamiquement l’enregistrement des sessions actives de l’utilisateur. Vous pouvez lire l’enregistrement en direct pour poursuivre le dépannage. Vous pouvez effectuer les opérations suivantes :
-
(Uniquement pour le SDK PowerShell de Citrix Virtual Apps™ et Desktops) 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 peut accepter 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 avertit 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’informe pas UserA. Start-BrokerSessionRecording -Sessions $SessionObjectDémarre l’enregistrement de toutes les sessions dans l’objet nommé $SessionObject et informe 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 informe les utilisateurs. -
Utilisez la commande
Get-BrokerSessionRecordingStatuspour obtenir l’état d’enregistrement de chaque session cible. L’état doit être SessionBeingRecorded. -
Relisez 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.
