Enregistrement de session 2104

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 que cette fonctionnalité 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 valeur de registre est ajoutée pour activer ou désactiver cette fonctionnalité. La valeur de registre est définie par défaut sur 1, ce qui signifie que la fonction 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 du 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 l’Éditeur du Registre. 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 les SDK Citrix

Vous pouvez utiliser la fonctionnalité d’enregistrement de session dynamique dans les environnements locaux et Citrix Cloud à l’aide du SDK PowerShell Citrix Virtual Apps and Desktops et du SDK PowerShell Remote Citrix Virtual Apps and Desktops, respectivement.

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 sélectionnez l’option Citrix Cloud Controller pour enregistrer les sessions dans un environnement Citrix Cloud, vous devez valider vos informations d’identification Citrix Cloud. Pour plus d’informations, consultez la section Créer une stratégie d’enregistrement personnalisée.

Créer une requête au Controller

Remarque :

N’installez pas le SDK PowerShell Remote sur une machine Citrix Cloud Connector. Vous pouvez installer le SDK Remote PowerShell sur n’importe quelle machine appartenant au domaine dans le même emplacement de ressources. Nous vous recommandons de ne pas exécuter les applets de commande de ce SDK sur les Cloud Connector. Le fonctionnement du SDK n’implique pas les Cloud Connector.

Le tableau suivant répertorie trois commandes PowerShell que les deux SDK Citrix fournissent pour la fonctionnalité d’enregistrement de session dynamique.

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 afficher 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 afficher 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 afficher 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 actif pour procéder au dépannage. Vous pouvez effectuer les opérations suivantes :

  1. (Pour le SDK PowerShell Citrix Virtual Apps and Desktops uniquement) Lancez PowerShell à partir de la console Citrix Studio.

    Lancer PowerShell

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

    Exécuter Get-BrokerSession

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

    Exécuter Get-BrokerSessionRecordingStatus

    Remarque :

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

  4. Utilisez 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 indique les méthodes courantes d’utilisation de 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 –username UserA. 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. Utiliser 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 Citrix Studio, vous pouvez afficher les journaux des commandes Start-BrokerSessionRecording et Stop-BrokerSessionRecording.

Écran de journalisation Studio

Enregistrement de session dynamique