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. Avec 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 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é, 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 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 :
La 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 puissent ê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 de session dynamique dans les environnements sur site et Citrix Cloud en utilisant respectivement le SDK PowerShell Citrix Virtual Apps and Desktops™ et le 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. Pour plus d’informations, consultez (/fr-fr/session-recording/2107/configure/policies.html#create-a-custom-recording-policy).
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 de session dynamique.
| 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 la fonctionnalité pour démarrer dynamiquement l’enregistrement des sessions actives de l’utilisateur et lire l’enregistrement en direct pour poursuivre le dépannage. Vous pouvez effectuer les opérations suivantes :
-
(Pour le SDK PowerShell de Citrix Virtual Apps™ et Desktops uniquement) Lancez PowerShell à partir de 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 s’affiche pour informer les utilisateurs de l’activité d’enregistrement.Le tableau suivant présente les méthodes courantes d’utilisation de 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 avertit 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 n’avertit pas UserA. Start-BrokerSessionRecording -Sessions $SessionObject Démarre l’enregistrement de toutes les sessions de 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,…,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 « Complet » 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 afficher les journaux résultants des commandes Start-BrokerSessionRecording et Stop-BrokerSessionRecording.
