Session Recording

Voir PDF

Installer, mettre à niveau et désinstaller

August 1, 2026

Contributeur:

C C

Cet article contient les sections suivantes :

Liste de contrôle d’installation

Vous installez les composants Session Recording à l’aide des fichiers suivants :

Broker_PowerShellSnapIn_x64.msi
SessionRecordingAdministrationx64.msi
SessionRecordingAgentx64.msi
SessionRecordingPlayer.msi
SessionRecordingWebPlayer.msi

Avant de commencer l’installation, complétez cette liste :

✔	Étape
	Installez les prérequis avant de commencer l’installation. Consultez Configuration système requise et Utiliser les scripts Citrix pour installer les prérequis des rôles et fonctionnalités Windows.
	Sélectionnez les machines sur lesquelles vous souhaitez installer chaque composant d’enregistrement de session. Assurez-vous que chaque ordinateur répond aux exigences matérielles et logicielles du ou des composants à installer.
	Utilisez les informations d’identification de votre compte Citrix pour accéder à la page de téléchargement de Citrix Virtual Apps and Desktops™ et télécharger le fichier produit. Décompressez le fichier.
	Pour utiliser le protocole TLS pour la communication entre les composants d’enregistrement de session, installez les certificats corrects dans votre environnement.
	Installez tous les correctifs requis pour les composants d’enregistrement de session. Les correctifs sont disponibles auprès du Support Citrix.
	Configurez Director pour créer et activer les stratégies d’enregistrement de session. Pour plus d’informations, consultez Configurer Director pour utiliser le serveur d’enregistrement de session.

Remarque :

Nous vous recommandons de diviser les applications publiées en groupes de mise à disposition (Delivery Groups) distincts en fonction de vos stratégies d’enregistrement. Le partage de session pour les applications publiées peut entrer en conflit avec la stratégie active si les applications se trouvent dans le même groupe de mise à disposition. L’enregistrement de session fait correspondre la stratégie active à la première application publiée qu’un utilisateur ouvre. À partir de la version 7.18, vous pouvez utiliser la fonctionnalité d’enregistrement de session dynamique pour démarrer ou arrêter l’enregistrement des sessions à tout moment pendant les sessions. Cette fonctionnalité peut aider à atténuer le problème de conflit avec la stratégie active. Pour plus d’informations, consultez Enregistrement de session dynamique.

Si vous prévoyez d’utiliser Machine Creation Services™ (MCS) ou Provisioning Services, préparez un QMId unique. Le non-respect de cette consigne peut entraîner des pertes de données d’enregistrement.

SQL Server exige que le protocole TCP/IP soit activé, que le service SQL Server Browser soit en cours d’exécution et que l’authentification Windows soit utilisée.

Pour utiliser HTTPS, configurez les certificats de serveur pour TLS/HTTPS.

Assurez-vous que les utilisateurs sous Local Users and Groups > Groups > Users disposent d’une autorisation d’écriture pour le dossier C:\windows\Temp.

Utiliser les scripts Citrix pour installer les prérequis des rôles et fonctionnalités Windows

Pour que l’enregistrement de session fonctionne correctement, utilisez les scripts Citrix suivants pour installer les prérequis des rôles et fonctionnalités Windows nécessaires avant d’installer l’enregistrement de session :

InstallPrereqsforSessionRecordingAdministration.ps1

 <#
 .Synopsis
     Installs Prereqs for Session Recording Administration
 .Description
     Supports Windows Server 2012 R2, Windows Server 2016, Windows Server 2019.
     Install below windows feature on this machine:
     -Application Development
     -Security - Windows Authentication
     -Management Tools - IIS 6 Management Compatibility
            IIS 6 Metabase Compatibility
            IIS 6 WMI Compatibility
            IIS 6 Scripting Tools
            IIS 6 Management Console
     -Microsoft Message Queuing (MSMQ), with Active Directory integration disabled, and MSMQ HTTP support enabled.
 #>
 function AddFeatures($featurename)
 {
     try
     {
         $feature=Get-WindowsFeature | ? {$_.DisplayName -eq $featurename -or $_.Name -eq $featurename}
         Add-WindowsFeature $feature
     }
     catch
     {
         Write-Host "Addition of Windows feature $featurename failed"
         Exit 1
     }
     Write-Host "Addition of Windows feature $featurename succeeded"
 }

 $system= gwmi win32_operatingSystem | select name

 if (-not (($system -Like '*Microsoft Windows Server 2012 R2*') -or ($system -Like '*Microsoft Windows Server 2016*') -or ($system -Like '*Microsoft Windows Server 2019*')))
 {
     Write-Host("This is not a supported server platform. Installation aborted.")
     Exit
 }

 # Start to install Windows feature
 Import-Module ServerManager

 AddFeatures('Web-Asp-Net45') #ASP.NET 4.5
 AddFeatures('Web-Mgmt-Console') #IIS Management Console
 AddFeatures('Web-Windows-Auth') # Windows Authentication
 AddFeatures('Web-Metabase') #IIS 6 Metabase Compatibility
 AddFeatures('Web-WMI') #IIS 6 WMI Compatibility
 AddFeatures('Web-Lgcy-Scripting')#IIS 6 Scripting Tools
 AddFeatures('Web-Lgcy-Mgmt-Console') #IIS 6 Management Console
 AddFeatures('MSMQ-HTTP-Support') #MSMQ HTTP Support
 AddFeatures('web-websockets') #IIS Web Sockets
 AddFeatures('NET-WCF-HTTP-Activation45') #http activate
 <!--NeedCopy-->

InstallPrereqsforSessionRecordingAgent.ps1

 <#
 .Synopsis
     Installs Prereqs for Session Recording Agent
 .Description
     Supports Windows Server 2012 R2, Windows Server 2016,  Windows Server 2019, Windows 7, Windows 8, Windows 8.1 and Windows 10.
     Install below windows feature on this machine:
     -Microsoft Message Queuing (MSMQ), with Active Directory integration disabled, and MSMQ HTTP support enabled.
 #>
 function AddFeatures($featurename)
 {
     try
     {
         $feature=Get-WindowsFeature | ? {$_.DisplayName -eq $featurename -or $_.Name -eq $featurename}
         Add-WindowsFeature $feature
     }
     catch
     {
         Write-Host "Addition of Windows feature $featurename failed"
         Exit 1
     }
     Write-Host "Addition of Windows feature $featurename succeeded"
 }

 # Start to install Windows feature
 $system= gwmi win32_operatingSystem | select name

 if (-not (($system -Like '*Microsoft Windows Server 2012 R2*') -or ($system -Like '*Microsoft Windows Server 2016*') -or ($system -Like '*Microsoft Windows Server 2019*')-or ($system -Like '*Microsoft Windows 7*')-or ($system -Like '*Microsoft Windows 8*')-or ($system -Like '*Microsoft Windows 10*')))
 {
     Write-Host("This is not a supported platform. Installation aborted.")
     Exit
 }

 if ($system -Like '*Microsoft Windows Server*')
 {
     Import-Module ServerManager
     AddFeatures('MSMQ') #Message Queuing
     AddFeatures('MSMQ-HTTP-Support')#MSMQ HTTP Support
 }
 else
 {
     try
     {
         if($system -Like '*Microsoft Windows 7*')
         {
             dism /online /enable-feature /featurename:IIS-WebServerRole /featurename:IIS-WebServer /featurename:IIS-IIS6ManagementCompatibility /featurename:IIS-Metabase /featurename:IIS-ManagementConsole /featurename:IIS-ApplicationDevelopment /featurename:IIS-NetFxExtensibility /featurename:IIS-ISAPIExtensions /featurename:IIS-CommonHttpFeatures /featurename:IIS-DefaultDocument /featurename:IIS-DirectoryBrowsing /featurename:IIS-HttpErrors /featurename:IIS-HttpRedirect /featurename:IIS-StaticContent /featurename:IIS-HealthAndDiagnostics /featurename:IIS-RequestMonitor /featurename:IIS-Performance /featurename:IIS-HttpCompressionStatic /featurename:IIS-Security /featurename:IIS-RequestFiltering /featurename:IIS-LoggingLibraries /featurename:IIS-HttpTracing
             dism /online /enable-feature /featurename:MSMQ-Container
             dism /online /enable-feature /featurename:MSMQ-Server
             dism /online /enable-feature /featurename:MSMQ-HTTP
         }
         else
         {
             dism /online /enable-feature /featurename:MSMQ-HTTP /all
         }
     }
     catch
     {
         Write-Host "Addition of Windows feature MSMQ HTTP Support failed"
         Exit 1
     }
     write-Host "Addition of Windows feature MSMQ HTTP Support succeeded"
 }
 <!--NeedCopy-->

Pour installer les prérequis des rôles et fonctionnalités Windows, suivez les étapes suivantes :

Sur la machine où vous prévoyez d’installer les composants d’administration de l’enregistrement de session :
1. Assurez-vous que la stratégie d’exécution est définie sur RemoteSigned ou Unrestricted dans PowerShell.
```
Set-ExecutionPolicy RemoteSigned

```
2. Démarrez une invite de commandes en tant qu’administrateur et exécutez la commande powershell.exe -file InstallPrereqsforSessionRecordingAdministration.ps1.
  
  Le script affiche les fonctionnalités ajoutées avec succès, puis s’arrête.
3. Une fois le script exécuté, assurez-vous que la stratégie d’exécution est définie sur une valeur appropriée en fonction de la politique de votre entreprise.
Sur la machine où vous prévoyez d’installer le composant Agent d’enregistrement de session :
1. Assurez-vous que la politique d’exécution est définie sur RemoteSigned ou Unrestricted dans PowerShell.
```
Set-ExecutionPolicy RemoteSigned

```
2. Démarrez une invite de commandes en tant qu’administrateur et exécutez la commande powershell.exe -file InstallPrereqsforSessionRecordingAgent.ps1.
  
  Le script affiche les fonctionnalités ajoutées avec succès, puis s’arrête.
3. Une fois le script exécuté, assurez-vous que la politique d’exécution est définie sur une valeur appropriée en fonction de la politique de l’entreprise.

Installer les composants d’administration de l’enregistrement de session

Nous vous recommandons d’installer les composants d’administration de l’enregistrement de session, l’agent d’enregistrement de session et le lecteur d’enregistrement de session sur des serveurs distincts.

Les composants d’administration de l’enregistrement de session incluent la base de données d’enregistrement de session, le serveur d’enregistrement de session et la console de stratégie d’enregistrement de session. Vous pouvez choisir le composant à installer sur un serveur.

Installez Broker_PowerShellSnapIn_x64.msi.

Important :

Pour utiliser la console de stratégie d’enregistrement de session, vous devez avoir installé le composant logiciel enfichable Broker PowerShell (Broker_PowerShellSnapIn_x64.msi). Localisez le composant logiciel enfichable sur l’ISO Citrix Virtual Apps and Desktops (\layout\image-full\x64\Citrix Desktop Delivery Controller) et suivez les instructions pour l’installer manuellement. Le non-respect de cette consigne peut entraîner une erreur.
Démarrez l’invite de commandes Windows en tant qu’administrateur, puis exécutez la commande msiexec /i SessionRecordingAdministrationx64.msi ou double-cliquez sur le fichier .msi.
Dans l’interface utilisateur d’installation, cliquez sur Suivant et acceptez le contrat de licence.
Sur l’écran Configuration de l’administration de l’enregistrement de session, sélectionnez les composants d’administration de l’enregistrement de session que vous souhaitez installer.

Remarque :

L’installation de tous les composants d’administration de l’enregistrement de session sur un seul serveur est acceptable pour une preuve de concept. Cependant, pour un environnement de production étendu, nous vous recommandons d’installer la console de stratégie d’enregistrement de session sur un serveur distinct, et le serveur d’enregistrement de session, sa journalisation d’administrateur et sa base de données sur un autre serveur distinct. La journalisation de l’administrateur est une sous-fonctionnalité facultative du serveur d’enregistrement de session. Sélectionnez le serveur d’enregistrement de session avant de pouvoir sélectionner la journalisation de l’administrateur.

Installer la base de données d’enregistrement de session

Remarque :

La base de données d’enregistrement de session n’est pas une base de données réelle. C’est un composant responsable de la création et de la configuration des bases de données requises dans l’instance Microsoft SQL Server pendant l’installation. L’enregistrement de session prend en charge trois solutions pour la haute disponibilité des bases de données basées sur Microsoft SQL Server. Pour plus d’informations, consultez Haute disponibilité de la base de données.

Vous pouvez déployer la base de données d’enregistrement de session sur Azure SQL Managed Instance, sur SQL Server sur des machines virtuelles Azure (VM) et sur AWS RDS. Pour plus d’informations, consultez Déployer la base de données d’enregistrement de session sur Azure SQL Managed Instance ou sur AWS RDS et Déployer la base de données d’enregistrement de session sur SQL Server sur des machines virtuelles Azure.

Il existe généralement trois types de déploiements pour la base de données d’enregistrement de session et Microsoft SQL Server :

Déploiement 1 : Installez le serveur d’enregistrement de session et la base de données d’enregistrement de session sur la même machine, et Microsoft SQL Server sur une machine distante. (Recommandé)
Déploiement 2 : Installez le serveur d’enregistrement de session, la base de données d’enregistrement de session et Microsoft SQL Server sur la même machine.
Déploiement 3 : Installez le serveur d’enregistrement de session sur une machine et installez la base de données d’enregistrement de session et Microsoft SQL Server sur une autre machine. (Non recommandé)

Sur la page Configuration de la base de données et du serveur, spécifiez le nom de l’instance et le nom de la base de données d’enregistrement de session, ainsi que le compte d’ordinateur du serveur d’enregistrement de session. Cliquez sur Suivant.
- Nom de l’instance : Si l’instance de base de données n’est pas une instance nommée telle que vous l’avez configurée lors de la configuration de l’instance, vous pouvez utiliser uniquement le nom d’ordinateur du serveur SQL. Si vous avez nommé l’instance, utilisez nom-ordinateur\nom-instance comme nom d’instance de base de données. Pour déterminer le nom de l’instance de serveur que vous utilisez, exécutez select @@servername sur le serveur SQL. La valeur renvoyée est le nom exact de l’instance de base de données. Si votre serveur SQL est configuré pour écouter sur un port personnalisé (autre que le port par défaut 1433), définissez le port d’écoute personnalisé en ajoutant une virgule au nom de l’instance. Par exemple, tapez DXSBC-SRD-1,2433 dans la zone de texte Nom de l’instance, où 2433, après la virgule, indique le port d’écoute personnalisé.
- Nom de la base de données : Saisissez un nom de base de données personnalisé dans la zone de texte Nom de la base de données ou utilisez le nom de base de données par défaut prédéfini dans la zone de texte. Cliquez sur Tester la connexion pour tester la connectivité à l’instance SQL Server et la validité du nom de la base de données.
  
  Important:
  
  Un nom de base de données personnalisé doit contenir uniquement des caractères A-Z, a-z, 0–9 et des traits de soulignement, et ne peut pas dépasser 123 caractères.
  - Vous devez disposer des autorisations de rôle de serveur securityadmin et dbcreator de la base de données. Si vous ne disposez pas de ces autorisations, vous pouvez:
    - Demandez à l’administrateur de base de données d’attribuer les autorisations pour l’installation. Une fois l’installation terminée, les autorisations de rôle de serveur securityadmin et dbcreator ne sont plus nécessaires et peuvent être supprimées en toute sécurité.
    - Ou, pendant l’installation msi, une boîte de dialogue vous invite à saisir les informations d’identification d’un administrateur de base de données disposant des autorisations de rôle de serveur securityadmin et dbcreator. Saisissez les informations d’identification correctes, puis cliquez sur OK pour poursuivre l’installation.
    L’installation crée la base de données d’enregistrement de session et ajoute le compte d’ordinateur du serveur d’enregistrement de session en tant que db_owner.
- Compte d’ordinateur du serveur d’enregistrement de session :
  - Déploiements 1 et 2 : Saisissez localhost dans la zone de texte Compte d’ordinateur du serveur d’enregistrement de session.
  - Déploiement 3 : Saisissez le nom de la machine hébergeant le serveur d’enregistrement de session au format domaine\nom-ordinateur. Le compte d’ordinateur du serveur d’enregistrement de session est le compte utilisateur permettant d’accéder à la base de données d’enregistrement de session.
  Remarque :
  
  Les tentatives d’installation des composants d’administration de l’enregistrement de session peuvent échouer avec le code d’erreur 1603 lorsqu’un nom de domaine est défini dans la zone de texte Compte d’ordinateur du serveur d’enregistrement de session. Pour contourner ce problème, saisissez localhost ou nom de domaine NetBIOS\nom-machine dans la zone de texte Compte d’ordinateur du serveur d’enregistrement de session. Pour obtenir le nom de domaine NetBIOS, exécutez $env:userdomain dans PowerShell ou echo %UserDomain% dans une invite de commandes sur la machine où le serveur d’enregistrement de session est installé.
Suivez les instructions pour terminer l’installation.

Installer le serveur d’enregistrement de session

Sélectionnez Serveur d’enregistrement de session et Journalisation de l’administrateur d’enregistrement de session.
Remarque :
- La journalisation de l’administrateur d’enregistrement de session est une sous-fonctionnalité facultative du serveur d’enregistrement de session. Sélectionnez le serveur d’enregistrement de session avant de pouvoir sélectionner la journalisation de l’administrateur d’enregistrement de session.
- Nous vous recommandons d’installer la journalisation de l’administrateur d’enregistrement de session en même temps que le serveur d’enregistrement de session. Si vous ne souhaitez pas activer la fonctionnalité de journalisation de l’administrateur, vous pouvez la désactiver sur une page ultérieure.
Sur la page Configuration de la base de données et du serveur, spécifiez les paramètres.
- Nom de l’instance : Tapez le nom de votre serveur SQL dans la zone de texte Nom de l’instance. Si vous utilisez une instance nommée, tapez nom-ordinateur\nom-instance ; sinon, tapez uniquement nom-ordinateur. Si votre serveur SQL est configuré pour écouter sur un port personnalisé (autre que le port par défaut 1433), définissez le port d’écoute personnalisé en ajoutant une virgule au nom de l’instance. Par exemple, tapez DXSBC-SRD-1,2433 dans la zone de texte Nom de l’instance, où 2433, après la virgule, indique le port d’écoute personnalisé.
- Nom de la base de données : Tapez un nom de base de données personnalisé dans la zone de texte Nom de la base de données ou utilisez le nom de base de données par défaut CitrixSessionRecording qui est prédéfini dans la zone de texte. Vous devez disposer des autorisations de rôle de serveur securityadmin et dbcreator pour la base de données. Si vous ne disposez pas de ces autorisations, vous pouvez :
  - Demander à l’administrateur de la base de données d’attribuer les autorisations pour l’installation. Une fois l’installation terminée, les autorisations de rôle de serveur securityadmin et dbcreator ne sont plus nécessaires et peuvent être supprimées en toute sécurité.
  - Ou, pendant l’installation du fichier msi, une boîte de dialogue vous invite à saisir les informations d’identification d’un administrateur de base de données disposant des autorisations de rôle de serveur securityadmin et dbcreator. Saisissez les informations d’identification correctes, puis cliquez sur OK pour poursuivre l’installation.
- Après avoir saisi le nom d’instance et le nom de base de données corrects, cliquez sur Tester la connexion pour tester la connectivité à la base de données d’enregistrement de session.
- Tapez le compte d’ordinateur du serveur d’enregistrement de session, puis cliquez sur Suivant.
Sur la page Configuration de la journalisation d’administration, spécifiez les configurations pour la fonctionnalité de journalisation d’administration.
- La base de données de journalisation est installée sur l’instance SQL Server : Cette zone de texte n’est pas modifiable. Le nom de l’instance SQL Server de la base de données de journalisation d’administration est automatiquement récupéré à partir du nom d’instance que vous avez saisi sur la page Configuration de la base de données et du serveur.
- Nom de la base de données de journalisation : Pour installer la fonctionnalité de journalisation d’administration de l’enregistrement de session, saisissez un nom de base de données personnalisé pour la base de données de journalisation d’administration dans cette zone de texte ou utilisez le nom de base de données par défaut CitrixSessionRecordingLogging qui est prédéfini dans la zone de texte.
  
  Remarque:
  
  Le nom de la base de données de journalisation d’administration doit être différent du nom de la base de données d’enregistrement de session défini dans la zone de texte Nom de la base de données sur la page précédente Configuration de la base de données et du serveur.
- Utiliser le nom de base de données par défaut : La sélection de cette option utilise le nom de base de données de journalisation par défaut.
- Activer le service de journalisation : Par défaut, la fonctionnalité de journalisation d’administration est activée. Vous pouvez la désactiver en décochant la case.
- Activer le blocage obligatoire : Par défaut, le blocage obligatoire est activé. Les fonctionnalités normales peuvent être bloquées si la journalisation échoue. Vous pouvez désactiver le blocage obligatoire en décochant la case.
Cliquez sur Suivant et poursuivez pour terminer l’installation.

Remarque :

L’installation par défaut du serveur d’enregistrement de session utilise HTTPS/TLS pour sécuriser les communications. Si TLS n’est pas configuré dans le site Internet Information Services (IIS) par défaut du serveur d’enregistrement de session, utilisez HTTP. Pour ce faire, annulez la sélection de SSL dans la console de gestion IIS en accédant au site du broker d’enregistrement de session, en ouvrant les paramètres SSL et en désactivant la case à cocher Exiger SSL.

Installer l’agent d’enregistrement de session

Installez l’agent d’enregistrement de session sur la machine VDA ou VDI sur laquelle vous souhaitez enregistrer des sessions.

Sur la page Configuration de l’agent d’enregistrement de session : Si vous avez installé le serveur d’enregistrement de session à l’avance, saisissez le nom d’ordinateur de la machine sur laquelle vous avez installé le serveur d’enregistrement de session ainsi que les informations de protocole et de port pour la connexion au serveur d’enregistrement de session. Si vous n’avez pas encore installé l’enregistrement de session, vous pouvez modifier ces informations ultérieurement dans les Propriétés de l’agent d’enregistrement de session.
Suivez les instructions pour terminer l’installation.

Remarque :

Lorsque Machine Creation Services (MCS) ou Provisioning Services (PVS) crée plusieurs VDA avec l’image principale configurée et Microsoft Message Queuing (MSMQ) installé, ces VDA peuvent avoir le même QMId dans certaines conditions. Ce cas peut entraîner divers problèmes, par exemple :

Les sessions peuvent ne pas être enregistrées même si l’accord d’enregistrement est accepté.

Le serveur d’enregistrement de session pourrait ne pas être en mesure de recevoir les signaux de déconnexion de session et, par conséquent, les sessions pourraient toujours être en statut en direct.

Pour contourner ce problème, créez un QMId unique pour chaque VDA, la méthode différant selon les méthodes de déploiement.

Aucune action supplémentaire n’est requise si les VDA de système d’exploitation à session unique avec l’agent d’enregistrement de session installé sont créés avec PVS 7.7 ou version ultérieure et MCS 7.9 ou version ultérieure en mode bureau statique, c’est-à-dire, par exemple, configurés pour rendre toutes les modifications persistantes avec un vDisk personnel séparé ou le disque local de votre VDA.

Pour les VDA de système d’exploitation multi-session créés avec MCS ou PVS et les VDA de système d’exploitation à session unique configurés pour ignorer toutes les modifications lorsqu’un utilisateur se déconnecte, utilisez le script GenRandomQMID.ps1 pour modifier le QMId au démarrage du système. Modifiez la stratégie de gestion de l’alimentation pour vous assurer qu’un nombre suffisant de VDA sont en cours d’exécution avant les tentatives de connexion des utilisateurs.

Pour utiliser le script GenRandomQMID.ps1, procédez comme suit :

1. Assurez-vous que la stratégie d’exécution est définie sur RemoteSigned ou Unrestricted dans PowerShell.
Set-ExecutionPolicy RemoteSigned
2. Créez une tâche planifiée, définissez le déclencheur au démarrage du système et exécutez-la avec le compte SYSTEM sur la machine d’image principale PVS ou MCS.

3. Ajoutez la commande en tant que tâche de démarrage.
powershell .exe -file C:\\GenRandomQMID.ps1
Résumé du script GenRandomQMID.ps1 :

Supprimez l’ID QM actuel du registre.

Ajoutez SysPrep = 1 à HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\MSMQ\Parameters.

Arrêtez les services associés, y compris CitrixSmAudAgent et MSMQ.

Pour générer un ID QM aléatoire, démarrez les services qui se sont arrêtés précédemment.

Exemple GENRANDOMQMID.PS1 :

# Remove old QMId from registry and set SysPrep flag for MSMQ

Remove-Itemproperty -Path HKLM:Software\Microsoft\MSMQ\Parameters\MachineCache -Name QMId -Force

Set-ItemProperty -Path HKLM:Software\Microsoft\MSMQ\Parameters -Name "SysPrep" -Type DWord -Value 1

# Get dependent services

$depServices = Get-Service -name MSMQ -dependentservices | Select -Property Name

# Restart MSMQ to get a new QMId

Restart-Service -force MSMQ

# Start dependent services

if ($depServices -ne $null) {

    foreach ($depService in $depServices) {

        $startMode = Get-WmiObject win32_service -filter "NAME = '$($depService.Name)'" | Select -Property StartMode

        if ($startMode.StartMode -eq "Auto") {

            Start-Service $depService.Name
        }
}

}
<!--NeedCopy-->

Installez le lecteur d’enregistrement de session et le lecteur Web

Installez le lecteur d’enregistrement de session sur le serveur d’enregistrement de session ou sur des postes de travail du domaine. Installez le lecteur Web uniquement sur le serveur d’enregistrement de session.

Double-cliquez sur SessionRecordingPlayer.msi et SessionRecordingWebPlayer.msi et suivez les instructions pour terminer l’installation.

Automatiser l’installation

L’enregistrement de session prend en charge l’installation silencieuse avec des options. Écrivez un script qui utilise l’installation silencieuse et exécutez les commandes pertinentes.

Automatiser l’installation des composants d’administration de l’enregistrement de session

Installez l’ensemble complet des composants d’administration de l’enregistrement de session à l’aide d’une seule commande

Par exemple, l’une des commandes suivantes installe l’ensemble complet des composants d’administration de l’enregistrement de session et crée un fichier journal pour capturer les informations d’installation.

msiexec /i "c:\SessionRecordingAdministrationx64.msi" ADDLOCAL="SsRecServer,PolicyConsole,SsRecLogging,StorageDatabase" DATABASEINSTANCE="WNBIO-SRD-1" DATABASENAME="CitrixSessionRecording" LOGGINGDATABASENAME="CitrixSessionRecordingLogging" DATABASEUSER="localhost" /q /l*vx "yourinstallationlog"
<!--NeedCopy-->

msiexec /i "SessionRecordingAdministrationx64.msi" ADDLOCAL="SsRecServer,PolicyConsole,SsRecLogging,StorageDatabase" DATABASEINSTANCE="CloudSQL" DATABASENAME="CitrixSessionRecording" LOGGINGDATABASENAME="CitrixSessionRecordingLogging" AZURESQLSERVICESUPPORT="1" AZUREUSERNAME="CloudSQLAdminName" AZUREPASSWORD="CloudSQLAdminPassword" /q /l*vx "c:\WithLogging.log"
<!--NeedCopy-->

Remarque :

Le fichier SessionRecordingAdministrationx64.msi se trouve sur l’ISO de Citrix Virtual Apps and Desktops sous \layout\image-full\x64\Session Recording.

Où :

ADDLOCAL fournit les fonctionnalités que vous pouvez sélectionner. Vous pouvez sélectionner plusieurs options. SsRecServer est le serveur d’enregistrement de session. PolicyConsole est la console de stratégie d’enregistrement de session. SsRecLogging est la fonctionnalité de journalisation de l’administrateur. StorageDatabase est la base de données d’enregistrement de session. La journalisation de l’administrateur (SsRecLogging) est une sous-fonctionnalité facultative du serveur d’enregistrement de session. Sélectionnez le serveur d’enregistrement de session avant de pouvoir sélectionner la fonctionnalité de journalisation de l’administrateur.
DATABASEINSTANCE est le nom d’instance de la base de données d’enregistrement de session. Par exemple, .\SQLEXPRESS,computer-name\SQLEXPRESS,computer-name ou tcp:srt-sql-support.public.ca7b16b60789.database.windows.net,3342 si vous utilisez Azure SQL Managed Instance.
DATABASENAME est le nom de la base de données d’enregistrement de session.
LOGGINGDATABASENAME est le nom de la base de données de journalisation de l’administrateur.
AZURESQLSERVICESUPPORT détermine si le SQL cloud est pris en charge. Pour utiliser le SQL cloud, définissez-le sur 1.
DATABASEUSER est le compte d’ordinateur du serveur d’enregistrement de session.
AZUREUSERNAME est le nom d’administrateur SQL cloud.
AZUREPASSWORD est le mot de passe administrateur SQL cloud.
/q spécifie le mode silencieux.
/l*v spécifie la journalisation détaillée.
yourinstallationlog est l’emplacement de votre fichier journal d’installation.

Créer une image maître pour le déploiement du serveur d’enregistrement de session

Vous disposez peut-être déjà de la base de données d’enregistrement de session et de la base de données de journalisation de l’administration issues d’un déploiement existant. Pour de tels scénarios, vous pouvez désormais ignorer les vérifications de base de données lors de l’installation des composants d’administration de l’enregistrement de session à l’aide de SessionRecordingAdministrationx64.msi. Vous pouvez créer facilement une image maître pour déployer le serveur d’enregistrement de session sur de nombreuses autres machines. Après avoir déployé le serveur sur les machines cibles à l’aide de l’image maître, exécutez une commande sur chaque machine pour vous connecter à la base de données d’enregistrement de session et à la base de données de journalisation de l’administration existantes. Ce support d’image maître facilite le déploiement et minimise l’impact potentiel des erreurs humaines. Il s’applique uniquement aux nouvelles installations et se compose des étapes suivantes :

Démarrez une invite de commandes et exécutez une commande similaire à la suivante :
```
msiexec /i "SessionRecordingAdministrationx64.msi" ADDLOCAL="SsRecServer,PolicyConsole,SsRecLogging,StorageDatabase" DATABASEINSTANCE="sqlnotexists" DATABASENAME="CitrixSessionRecording2" LOGGINGDATABASENAME="CitrixSessionRecordingLogging2" DATABASEUSER="localhost" /q /l*vx "c:\WithLogging.log" IGNOREDBCHECK="True"

```
Cette commande installe les composants d’administration de l’enregistrement de session sans configurer ni tester la connectivité à la base de données d’enregistrement de session et à la base de données de journalisation de l’administration.

Définissez le paramètre IGNOREDBCHECK sur True et utilisez des valeurs aléatoires pour DATABASEINSTANCE, DATABASENAME et LOGGINGDATABASENAME.
Créez une image maître sur la machine que vous utilisez.
Déployez l’image maître sur d’autres machines pour le déploiement du serveur d’enregistrement de session.
Sur chacune des machines, exécutez des commandes similaires à la suivante :
```
.\SsRecUtils.exe -modifydbconnectionpara DATABASEINSTANCE DATABASENAME LOGGINGDATABASENAME

iisreset /noforce

```
Les commandes connectent le serveur d’enregistrement de session installé précédemment à une base de données d’enregistrement de session et à une base de données de journalisation de l’administration existantes.

Le fichier SsRecUtils.exe se trouve dans \Citrix\SessionRecording\Server\bin\. Définissez les paramètres DATABASEINSTANCE, DATABASENAME et LOGGINGDATABASENAME selon vos besoins.

Conserver les bases de données lors de la désinstallation des composants d’administration de l’enregistrement de session

Avec KEEPDB défini sur True, la commande suivante conserve la base de données d’enregistrement de session et la base de données de journalisation de l’administration lors de la désinstallation des composants d’administration de l’enregistrement de session :

msiexec /x "SessionRecordingAdministrationx64.msi" KEEPDB="True"
<!--NeedCopy-->

Automatiser l’installation du lecteur d’enregistrement de session et du lecteur web

Par exemple, les commandes suivantes installent respectivement le lecteur d’enregistrement de session et le lecteur web.

msiexec /i "c:\SessionRecordingPlayer.msi" /q /l*\vx "yourinstallationlog"
<!--NeedCopy-->

msiexec /i "c:\SessionRecordingWebPlayer.msi" /q /l*vx "yourinstallationlog"
<!--NeedCopy-->

Remarque :

Le fichier SessionRecordingPlayer.msi se trouve sur l’ISO Citrix Virtual Apps and Desktops sous \layout\image-full\x86\Session Recording.

Le fichier SessionRecordingWebPlayer.msi se trouve sur l’ISO Citrix Virtual Apps and Desktops sous \layout\image-full\x64\Session Recording.

Où :

/q spécifie le mode silencieux.
/l*v spécifie la journalisation détaillée.
yourinstallationlog est l’emplacement de votre fichier journal d’installation.

Automatiser l’installation de l’agent d’enregistrement de session

Par exemple, la commande suivante installe l’agent d’enregistrement de session et crée un fichier journal pour capturer les informations d’installation.

Pour les systèmes 64 bits :

msiexec /i SessionRecordingAgentx64.msi /q /l*vx yourinstallationlog SESSIONRECORDINGSERVERNAME=yourservername
SESSIONRECORDINGBROKERPROTOCOL=yourbrokerprotocol SESSIONRECORDINGBROKERPORT=yourbrokerport
<!--NeedCopy-->

Remarque :

Le fichier SessionRecordingAgentx64.msi se trouve sur l’ISO Citrix Virtual Apps and Desktops sous \layout\image-full\x64\Session Recording.

Pour les systèmes 32 bits :

msiexec /i SessionRecordingAgent.msi /q /l*vx yourinstallationlog SESSIONRECORDINGSERVERNAME=yourservername
SESSIONRECORDINGBROKERPROTOCOL=yourbrokerprotocol SESSIONRECORDINGBROKERPORT=yourbrokerport
<!--NeedCopy-->

Remarque :

Le fichier SessionRecordingAgent.msi se trouve sur l’ISO Citrix Virtual Apps and Desktops sous \layout\image-full\x86\Session Recording.

Où :

yourservername est le nom NetBIOS ou le FQDN de la machine hébergeant le serveur d’enregistrement de session. S’il n’est pas spécifié, cette valeur est par défaut localhost.
yourbrokerprotocol est HTTP ou HTTPS que l’agent d’enregistrement de session utilise pour communiquer avec le broker d’enregistrement de session. S’il n’est pas spécifié, cette valeur est par défaut HTTPS.
yourbrokerport est le numéro de port que l’agent d’enregistrement de session utilise pour communiquer avec le broker d’enregistrement de session. S’il n’est pas spécifié, cette valeur est par défaut zéro, ce qui indique à l’agent d’enregistrement de session d’utiliser le numéro de port par défaut pour le protocole sélectionné : 80 pour HTTP ou 443 pour HTTPS.
/q spécifie le mode silencieux.
/l*v spécifie la journalisation détaillée.
yourinstallationlog est l’emplacement de votre fichier journal d’installation.

Mettre à niveau l’enregistrement de session

Vous pouvez mettre à niveau certaines de vos déploiements vers des versions ultérieures sans avoir à configurer de nouvelles machines ou de nouveaux sites. Vous pouvez effectuer une mise à niveau à partir de la dernière CU de Session Recording 7.15 LTSR, et de toute version ultérieure, vers la dernière version de Session Recording.

Remarque :

Lorsque vous mettez à niveau l’administration de l’enregistrement de session de 7.6 vers 7.13 ou une version ultérieure et que vous choisissez Modifier dans l’administration de l’enregistrement de session pour ajouter le service de journalisation de l’administrateur, le nom de l’instance SQL Server n’apparaît pas sur la page Configuration de la journalisation de l’administrateur. Le message d’erreur suivant apparaît lorsque vous cliquez sur Suivant : Échec du test de connexion à la base de données. Veuillez saisir le nom correct de l’instance de base de données. Pour contourner ce problème, ajoutez l’autorisation de lecture pour les utilisateurs localhost au dossier de registre SmartAuditor Server suivant : HKEY_LOCAL_MACHINE\SOFTWARE\Citrix\SmartAuditor\Server.

Vous ne pouvez pas effectuer de mise à niveau à partir d’une version Technical Preview.

Exigences, préparation et limitations

Utilisez l’interface graphique ou l’interface de ligne de commande du programme d’installation de Session Recording pour mettre à niveau les composants de Session Recording sur la machine où vous avez installé les composants.
Avant toute activité de mise à niveau, sauvegardez la base de données nommée CitrixSessionRecording dans l’instance SQL Server. De cette façon, vous pourrez la restaurer si des problèmes sont découverts après la mise à niveau de la base de données.
En plus d’être un utilisateur de domaine, vous devez être un administrateur local sur les machines où vous mettez à niveau les composants de Session Recording.
Si le serveur d’enregistrement de session et la base de données d’enregistrement de session ne sont pas installés sur le même serveur, vous devez disposer de l’autorisation de rôle de base de données pour mettre à niveau la base de données d’enregistrement de session. Sinon, vous pouvez :
- Demandez à l’administrateur de la base de données d’attribuer les autorisations de rôle de serveur securityadmin et dbcreator pour la mise à niveau. Une fois la mise à niveau terminée, les autorisations de rôle de serveur securityadmin et dbcreator ne sont plus nécessaires et peuvent être supprimées en toute sécurité.
- Ou, utilisez le fichier SessionRecordingAdministrationx64.msi pour la mise à niveau. Pendant la mise à niveau msi, une boîte de dialogue vous invite à saisir les informations d’identification d’un administrateur de base de données qui dispose des autorisations de rôle de serveur securityadmin et dbcreator. Saisissez les informations d’identification correctes, puis cliquez sur OK pour poursuivre la mise à niveau.
Si vous ne prévoyez pas de mettre à niveau tous les agents d’enregistrement de session en même temps, l’agent d’enregistrement de session 7.6.0 (et versions ultérieures) est compatible avec la dernière version (actuelle) du serveur d’enregistrement de session. Cependant, certaines nouvelles fonctionnalités et corrections de bogues pourraient ne pas prendre effet.
Toutes les sessions démarrées pendant la mise à niveau du serveur d’enregistrement de session ne sont pas enregistrées.
L’option Ajustement graphique dans les propriétés de l’agent d’enregistrement de session est activée par défaut après une nouvelle installation ou une mise à niveau pour rester compatible avec le mode de redirection de composition de bureau. Vous pouvez désactiver cette option manuellement après une nouvelle installation ou une mise à niveau.
La fonctionnalité de journalisation de l’administrateur n’est pas installée après la mise à niveau de l’enregistrement de session à partir d’une version précédente où la fonctionnalité n’est pas disponible. Pour ajouter la fonctionnalité, modifiez l’installation après la mise à niveau.
S’il y a des sessions d’enregistrement en direct lorsque le processus de mise à niveau démarre, il y a peu de chances que l’enregistrement puisse être terminé.
Examinez la séquence de mise à niveau suivante afin de pouvoir planifier et atténuer les pannes potentielles.

Séquence de mise à niveau

Lorsque la base de données d’enregistrement de session et le serveur d’enregistrement de session sont installés sur des serveurs différents, arrêtez manuellement le service Session Recording Storage Manager sur le serveur d’enregistrement de session. Ensuite, mettez d’abord à niveau la base de données d’enregistrement de session.
Via le Gestionnaire des services Internet (IIS), assurez-vous que le broker d’enregistrement de session est en cours d’exécution. Mettez à niveau le serveur d’enregistrement de session. Si la base de données d’enregistrement de session et le serveur d’enregistrement de session sont installés sur le même serveur, la base de données d’enregistrement de session est également mise à niveau.
Le service d’enregistrement de session est automatiquement remis en ligne une fois la mise à niveau du serveur d’enregistrement de session terminée.
Mettez à niveau l’agent d’enregistrement de session (sur l’image principale).
Mettez à niveau la console de stratégie d’enregistrement de session avec ou après le serveur d’enregistrement de session.
Mettre à niveau le lecteur d’enregistrement de session.

Déployer la base de données d’enregistrement de session sur les services de base de données SQL cloud

Cette section décrit comment déployer la base de données d’enregistrement de session sur Azure SQL Managed Instance, sur AWS RDS et sur SQL Server sur des machines virtuelles Azure.

Déployer la base de données d’enregistrement de session sur Azure SQL Managed Instance ou sur AWS RDS

Conseil :

Vous pouvez également exécuter une seule commande similaire à la suivante pour déployer la base de données d’enregistrement de session sur Azure SQL Managed Instance ou sur AWS RDS. Pour plus d’informations, consultez la section précédente Automatiser l’installation de cet article.

msiexec /i "SessionRecordingAdministrationx64.msi" ADDLOCAL="SsRecServer,PolicyConsole,SsRecLogging,StorageDatabase" DATABASEINSTANCE="CloudSQL" DATABASENAME="CitrixSessionRecording" LOGGINGDATABASENAME="CitrixSessionRecordingLogging" AZURESQLSERVICESUPPORT="1" AZUREUSERNAME="CloudSQLAdminName" AZUREPASSWORD="CloudSQLAdminPassword" /q /l*vx "c:\WithLogging.log"
<!--NeedCopy-->

Créez une instance Azure SQL Managed ou créez une instance SQL Server via la console Amazon RDS.
(Pour Azure SQL uniquement) Notez les chaînes Serveur qui apparaissent dans le panneau des propriétés. Ces chaînes sont le nom d’instance de la base de données d’enregistrement de session. Pour un exemple, consultez la capture d’écran suivante.
(Pour AWS RDS uniquement) Notez les informations Point de terminaison et Port. Nous les utilisons comme nom d’instance de votre base de données, au format <Point de terminaison, Port>.
Exécutez SessionRecordingAdministrationx64.msi pour installer la base de données d’enregistrement de session.

Cochez la case Activer SQL cloud et renseignez le nom d’utilisateur et le mot de passe de l’administrateur SQL cloud. Effectuez les autres configurations requises.

Remarque : Si vous modifiez le mot de passe de l’administrateur SQL cloud, vous devez mettre à jour le mot de passe dans les Propriétés du serveur d’enregistrement de session. Lorsque vous ouvrez les Propriétés du serveur d’enregistrement de session, un message d’erreur apparaît. Cliquez sur OK pour continuer, sélectionnez l’onglet Base de données cloud et saisissez le nouveau mot de passe de l’administrateur SQL cloud. Redémarrez le service Citrix Session Recording Analytics, le service Citrix Session Recording Storage Manager et le service IIS.

Mettre à jour le mot de passe administrateur de SQL cloud(/fr-fr/session-recording/2104/media/updating-cloud-sql-admin-password.png)

Migrer une base de données locale vers une instance gérée SQL cloud

Migrez votre base de données locale conformément à https://docs.microsoft.com/fr-fr/data-migration/ ou https://docs.aws.amazon.com/prescriptive-guidance/latest/patterns/migrate-an-on-premises-microsoft-sql-server-database-to-amazon-rds-for-sql-server.html.
Pour que l’enregistrement de session fonctionne correctement après la migration, exécutez SsRecUtils.exe sur le serveur d’enregistrement de session.

C:\Program Files\Citrix\SessionRecording\Server\bin\SsRecUtils.exe -modifyazuredbconnectionpara {Database Instance} {Session Recording Database Name} {Session Recording Logging Database Name} {AzureAdminName}{AzureAdminPassword} iisreset /noforce
Sur le serveur d’enregistrement de session, redémarrez le service Citrix Session Recording Analytics, le service Citrix Session Recording Storage Manager et le service IIS.

Migrer une base de données de production d’une instance gérée Azure SQL vers une base de données locale

Migrez la base de données conformément à https://docs.microsoft.com/fr-fr/data-migration/.
Pour que l’enregistrement de session fonctionne correctement après la migration, exécutez SsRecUtils.exe sur le serveur d’enregistrement de session.

C:\Program Files\Citrix\SessionRecording\Server\bin\SsRecUtils.exe -modifydbconnectionpara {Database Instance} {Session Recording Database Name} {Session Recording Logging Database Name} iisreset /noforce
Sur le serveur d’enregistrement de session, redémarrez le service Citrix Session Recording Analytics, le service Citrix Session Recording Storage Manager et le service IIS.

Déployer la base de données d’enregistrement de session sur SQL Server sur des machines virtuelles Azure

Sur SQL Server sur des machines virtuelles Azure, vous pouvez déployer la base de données d’enregistrement de session.

Découvrez une machine virtuelle Azure SQL.
Configurez la machine virtuelle et ajoutez-la au domaine où vous installez les composants d’enregistrement de session.
Utilisez le FQDN de la VM comme nom d’instance lors de l’installation de la base de données d’enregistrement de session. Remarque : Lorsque vous utilisez SessionRecordingAdministrationx64.msi pour l’installation, décochez la case Activer SQL cloud.
Suivez les instructions pour terminer l’installation.

Désinstaller l’enregistrement de session

Pour supprimer les composants d’enregistrement de session d’un serveur ou d’un poste de travail, utilisez l’option de désinstallation ou de suppression de programmes disponible dans le Panneau de configuration de Windows. Pour supprimer la base de données d’enregistrement de session, vous devez disposer des mêmes autorisations de rôle SQL Server securityadmin et dbcreator que lors de son installation.

Pour des raisons de sécurité, la base de données de journalisation de l’administrateur n’est pas supprimée après la désinstallation des composants.

La version officielle de la documentation de ce produit est en anglais. Toute version dans une langue autre que l’anglais est fournie uniquement à titre indicatif et peut inclure du contenu traduit automatiquement. Pour en savoir plus, veuillez consulter la clause de non-responsabilité relative à la traduction automatique sur Cloud Software Group home.

Installer, mettre à niveau et désinstaller

August 1, 2026

Contributeur:

C C

August 1, 2026

Contributeur:

C C

Dans cet article

Liste de contrôle d’installation
Utiliser les scripts Citrix pour installer les prérequis des rôles et fonctionnalités Windows
Installer les composants d’administration de l’enregistrement de session
Installer l’agent d’enregistrement de session
Installez le lecteur d’enregistrement de session et le lecteur Web
Automatiser l’installation
Mettre à niveau l’enregistrement de session
Déployer la base de données d’enregistrement de session sur les services de base de données SQL cloud
Désinstaller l’enregistrement de session