Enregistrement de session déclenché par l’utilisateur final
Auparavant, l’enregistrement de session démarrait strictement en fonction des stratégies d’enregistrement configurées par les administrateurs. À partir de la version actuelle, l’enregistrement de session introduit la fonctionnalité d’enregistrement de session déclenché par l’utilisateur final. Grâce à cette fonctionnalité, les utilisateurs finaux peuvent démarrer ou arrêter l’enregistrement de leurs propres sessions à tout moment, offrant ainsi une plus grande flexibilité pour les besoins d’enregistrement à la demande.
Activer l’enregistrement déclenché par l’utilisateur final
Par défaut, l’enregistrement déclenché par l’utilisateur final est désactivé. Pour activer cette fonctionnalité, vous devez configurer une stratégie d’enregistrement dans la console de stratégie d’enregistrement de session. Pour plus d’informations sur la configuration de la stratégie personnalisée, consultez Créer une stratégie d’enregistrement personnalisée.
Démarrer ou arrêter l’enregistrement à l’aide de Citrix Virtual Desktop Assistant
Le Citrix Virtual Desktop Assistant, installé par défaut dans CVAD, fournit une page d’enregistrement de session intégrée qui permet aux utilisateurs d’enregistrer manuellement leurs sessions de bureau virtuel actives.
Démarrer l’enregistrement
Démarre la capture de la session actuelle. Un indicateur d’enregistrement s’affiche pour confirmer que l’enregistrement est en cours.
Arrêter l’enregistrement
Arrête l’enregistrement et enregistre automatiquement la session enregistrée sur le serveur d’enregistrement de session.
Démarrer ou arrêter l’enregistrement à l’aide de commandes PowerShell
Les utilisateurs finaux peuvent déclencher l’enregistrement via des commandes PowerShell après avoir importé le modèle requis.
Importer le module d’enregistrement de session
Avant d’exécuter les commandes d’enregistrement, vous devez importer le module nécessaire dans la session PowerShell. Ouvrez PowerShell et importez le module en exécutant :
Import-Module -DisableNameChecking 'C:\Program Files\Citrix\SessionRecording\Agent\Bin\EndUserInitiatedSRSnapin.dll'
Commandes disponibles
Le tableau suivant répertorie trois commandes PowerShell qui permettent l’enregistrement de session déclenché par l’utilisateur final.
| Commande | Description |
|---|---|
| Start-SessionRecording | Démarre l’enregistrement de la session active dans laquelle la commande est exécutée. Pour enregistrer une session active spécifique, utilisez le paramètre -SessionId <ID> (nécessite des privilèges d’administrateur local). Pour plus d’informations, exécutez Get-Help Start-SessionRecording pour consulter l’aide en ligne de la commande. |
| Stop-SessionRecording | Arrête l’enregistrement de la session active dans laquelle la commande est exécutée. Pour arrêter l’enregistrement d’une session active spécifique, utilisez le paramètre -SessionId <ID> (nécessite des privilèges d’administrateur local). Remarque : Les utilisateurs ne peuvent arrêter que les enregistrements qu’ils ont initiés. Ils ne peuvent pas arrêter les enregistrements déclenchés par un enregistrement dynamique ou basé sur une stratégie. Pour plus d’informations, exécutez Get-Help Stop-SessionRecording pour consulter l’aide en ligne de la commande. |
| Get-SessionRecordingStatus | Récupère le statut d’enregistrement de la session active dans laquelle la commande est exécutée. Pour obtenir le statut d’une session active spécifique, utilisez le paramètre -SessionId <ID>. Pour plus d’informations, exécutez Get-Help Get-SessionRecording Status pour consulter l’aide en ligne de la commande. |
Scénario 1 : Enregistrement déclenché par l’utilisateur final
Les utilisateurs finaux peuvent déclencher des enregistrements pour leur session active actuelle afin de capturer des opérations de manière dynamique (par exemple, à des fins de dépannage).
L’utilisateur peut effectuer les étapes suivantes au sein de la session :
- Lancez PowerShell depuis le bureau de la session.
- Importez le module comme décrit dans la section précédente.
- Utilisez la commande
Get-SessionRecordingStatuspour vérifier l’état de l’enregistrement, assurez-vous que la session n’est pas déjà en cours d’enregistrement. - Utilisez la commande
Start-SessionRecordingpour démarrer l’enregistrement de la session. - Utilisez la commande
Get-SessionRecordingStatuspour vérifier l’état de l’enregistrement, assurez-vous que la session est en cours d’enregistrement. L’état doit être Enregistrement. - Reproduisez le problème ou effectuez les opérations qui doivent être documentées.
- Utilisez la commande
Stop-SessionRecordingpour arrêter l’enregistrement une fois les opérations terminées. - Informez l’administrateur de lire les enregistrements en direct ou terminés et de procéder au dépannage de suivi.
Scénario 2 : Enregistrement déclenché par l’administrateur
Les administrateurs peuvent déclencher des enregistrements pour des sessions actives spécifiques sur la machine (par exemple, pour aider un utilisateur à résoudre un problème).
L’administrateur peut effectuer les étapes suivantes sur la machine hébergeant la session :
- Lancez PowerShell en tant qu’administrateur.
- Importez le module comme décrit dans la section précédente.
- Obtenez le
SessionIDde la session utilisateur cible en utilisant : query session | find “Active”. - Utilisez la commande
Get-SessionRecordingStatus -SessionId <SessionID>pour vérifier l’état de l’enregistrement et assurez-vous que la session n’est pas déjà enregistrée. - Utilisez la commande
Start-SessionRecording -SessionId <SessionID>pour démarrer l’enregistrement de la session. - Utilisez la commande
Get-SessionRecordingStatus -SessionId <SessionID>pour vérifier l’état de l’enregistrement et assurez-vous que la session est en cours d’enregistrement. L’état doit être Enregistrement. - Demandez à l’utilisateur de reproduire le problème ou d’effectuer les opérations qui doivent être documentées.
- Utilisez
Stop-SessionRecording -SessionId <SessionID>pour arrêter l’enregistrement une fois les opérations terminées. - Lisez les enregistrements En direct ou Complets et poursuivez le dépannage.
Démarrer ou arrêter l’enregistrement à l’aide de raccourcis clavier
Les utilisateurs finaux peuvent également contrôler l’enregistrement à l’aide de raccourcis clavier (Hotkeys). Par défaut, cette fonctionnalité est désactivée.
Activer les raccourcis clavier
Pour activer la fonctionnalité de raccourcis clavier, ajoutez une valeur DWORD nommée EnableHotKeys sous le chemin de registre : HKEY_LOCAL_MACHINE\SOFTWARE\Citrix\SmartAuditor\EndUserRecording
Définissez la valeur sur 1 sur la machine VDA.
Ce paramètre est appliqué par machine et prendra effet pour toutes les sessions actives ultérieures.
Raccourcis clavier par défaut
Une fois activés, les raccourcis clavier par défaut sont :
- Démarrer l’enregistrement : CTRL + MAJ + F8
- Arrêter l’enregistrement : CTRL + MAJ + F9
Personnaliser les raccourcis clavier
Si les raccourcis clavier par défaut entrent en conflit avec d’autres applications, ajoutez ou modifiez les valeurs REG_SZ suivantes sous :
HKEY_LOCAL_MACHINE\SOFTWARE\Citrix\SmartAuditor\EndUserRecording
- StartHotkey – spécifiez le nouveau raccourci clavier pour démarrer l’enregistrement
- StopHotkey – spécifiez le nouveau raccourci clavier pour arrêter l’enregistrement
Règles des raccourcis clavier
- Seules les touches F1–F12 ou les lettres majuscules (A–Z) peuvent être utilisées comme dernière touche.
- Vous ne définissez que la dernière touche de la combinaison. Le préfixe CTRL + SHIFT est obligatoire et appliqué automatiquement.
Exemple : Pour définir le raccourci clavier de démarrage sur CTRL + SHIFT + F5, définissez la valeur de StartHotkey sur F5.
