Enregistrement de session dynamique

Auparavant, l’enregistrement de session commençait strictement au tout début des sessions qui répondaient aux stratégies d’enregistrement et s’arrêtait strictement à la fin de ces sessions.

À partir de la version 7.18, Citrix introduit l’enregistrement de session dynamique. Grâce à cette fonctionnalité, vous pouvez démarrer ou arrêter l’enregistrement d’une session ou de sessions spécifiques qu’un utilisateur spécifique lance, à tout moment au cours des sessions.

Remarque :

Pour qu’elle fonctionne comme prévu, mettez à niveau l’enregistrement de session, le VDA et le Delivery Controller vers la version 7.18 ou une version ultérieure.

Désactiver ou activer l’enregistrement de session dynamique

Sur l’agent d’enregistrement de session, une clé de registre est ajoutée pour activer ou désactiver cette fonctionnalité. La clé est définie par défaut sur 1, ce qui signifie qu’après l’installation ou la mise à niveau vers la version 7.18, la fonctionnalité est activée par défaut.

Pour activer ou désactiver la fonctionnalité, procédez comme suit :

  1. Une fois l’installation de l’enregistrement de session terminée, connectez-vous en tant qu’administrateur à la machine sur laquelle vous avez installé l’agent d’enregistrement de session.
  2. Ouvrez l’éditeur de registre.
  3. Accédez à HKEY_LOCAL_MACHINE\SOFTWARE\Citrix\SmartAuditor.
  4. 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
  5. 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 vos modifications prennent effet.

Avertissement :

La modification incorrecte du Registre peut entraîner des problèmes graves pouvant nécessiter de réinstaller votre système d’exploitation. Citrix ne peut garantir la possibilité de résoudre les problèmes provenant d’une mauvaise utilisation de l’Éditeur du Registre. Vous assumez l’ensemble des risques liés à l’utilisation de cet outil. Veillez à faire une copie de sauvegarde de votre registre avant de le modifier.

Démarrer ou arrêter dynamiquement l’enregistrement à l’aide des commandes PowerShell dans le Citrix Broker SDK

Le tableau suivant répertorie trois commandes PowerShell ajoutées au SDK Citrix Broker pour la fonctionnalité d’enregistrement de session dynamique. Pour plus d’informations sur le Citrix Broker SDK, consultez Kits de développement (SDK) et API et Citrix.Broker.Admin.V2.

Commande Description
Start-BrokerSessionRecording Permet de commencer à enregistrer une session active spécifique, une liste de sessions actives ou des 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 d’enregistrer une session active spécifique, une liste de sessions actives ou des 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 nécessite une assistance immédiate, vous pouvez utiliser cette fonctionnalité pour démarrer dynamiquement l’enregistrement des sessions actives de l’utilisateur et visionner l’enregistrement en direct pour procéder au dépannage. Vous pouvez effectuer les opérations suivantes :

  1. Lancer PowerShell à partir de la console Citrix Studio.

    image localisée

  2. Utiliser la commande Get-BrokerSession pour obtenir toutes les sessions actives de l’utilisateur cible.

    image localisée

  3. Utiliser la commande Get-BrokerSessionRecordingStatus pour obtenir l’état d’enregistrement de la session spécifiée.

    image localisée

    Remarque :

    Le paramètre -Session ne peut accepter qu’un seul UID de session à la fois.

  4. Utiliser la commande Start-BrokerSessionRecording pour démarrer l’enregistrement. Par défaut, un message de notification apparaît pour informer les utilisateurs que la session est enregistrée. 

    Le tableau suivant présente les manières courantes d’utiliser la commande Start-BrokerSessionRecording.

    Commande Description
    Start-BrokerSessionRecording -User DomainA \ UserA Lance l’enregistrement de toutes les sessions de l’utilisateur UserA dans le domaine appelé DomainA et notifie UserA.
    Start-BrokerSessionRecording -User DomainA \ UserA -NotifyUser $false Lance l’enregistrement de toutes les sessions de l’utilisateur UserA dans le domaine appelé DomainA et ne notifie pas UserA.
    Start-BrokerSessionRecording -Sessions $SessionObject Lance l’enregistrement de toutes les sessions de l’objet appelé $SessionObject et notifie l’utilisateur. Pour obtenir l’objet $SessionObject, exécutez $SessionObject=Get-BrokerSession –usernameUserA. Le nom d’un objet est préfixé d’un signe de dollar $. Pour plus d’informations, voir Étape 2 et l’aide en ligne de la commande.
    Start-BrokerSessionRecording -Sessions uid1,uid2,…,uidn Lance l’enregistrement des sessions uid1, uid2, … et uidn et notifie les utilisateurs.
  5. Utilisez la commande Get-BrokerSessionRecordingStatus pour obtenir l’état d’enregistrement de chaque session cible. L’état est censé être SessionBeingRecorded.

  6. Visionnez les enregistrements Actif ou Terminé dans le lecteur d’enregistrement de session et procédez au dépannage.

    Remarque :

    La dernière section de la chronologie de la barre de progression du lecteur peut apparaître grisée lorsque vous visionnez un enregistrement « Terminé » qui a été arrêté par la commande Stop-BrokerSessionRecording et que la dernière section de la session enregistrée est inactive. Il est difficile de savoir quand la session enregistrée a des activités constantes.

  7. Utilisez la commande Stop-BrokerSessionRecording pour arrêter l’enregistrement lorsque le problème signalé a été trié ou résolu.

    Le tableau suivant indique les méthodes courantes d’utilisation de cette commande :

    Commande Description
    Stop-BrokerSessionRecording -User DomainA \ UserA Arrête l’enregistrement de toutes les sessions de l’utilisateur UserA dans le domaine appelé DomainA.
    Stop-BrokerSessionRecording -Sessions $SessionObject Arrête l’enregistrement de toutes les sessions dans $SessionObject.
    Stop-BrokerSessionRecording -Sessions uid1,uid2,…,uidn Arrête l’enregistrement des sessions uid1, uid2, … et uidn.

Dans l’écran Journalisation de Studio Citrix, vous pouvez afficher les journaux des commandes Start-BrokerSessionRecording et Stop-BrokerSessionRecording.

image localisée