Administrar agentes de implementación básicos

Puede usar Grabación de sesiones para administrar agentes de implementación básicos. Esta función proporciona un método ligero para implementar Grabación de sesiones. Puede usar este método de implementación para utilizar las funcionalidades básicas de Grabación de sesiones: grabar sesiones activas en archivos MP4 sin implementar los componentes de back-end, como los servidores de Grabación de sesiones, el reproductor, las bases de datos y las consolas.

Instalación

El agente de Grabación de sesiones se instala junto con el Citrix Virtual Delivery Agent (VDA) de forma predeterminada.

• Nueva instalación: Al instalar o actualizar a la versión 2511 o posterior de VDA, el agente de Grabación de sesiones se instala y funciona en modo de implementación.

• Instalación existente: Si ya tiene un agente de Grabación de sesiones instalado, puede cambiar al modo de implementación básico actualizando el agente a la versión 2511 o posterior y cambiando la dirección del servidor de Grabación de sesiones a localhost en las propiedades del agente de Grabación de sesiones.

Usar el agente de implementación básico

En el modo de implementación básico, las grabaciones pueden ser activadas manualmente por los usuarios finales o los administradores mediante comandos de PowerShell. También pueden ser activadas por teclas de acceso rápido o grabación dinámica.

Iniciar o detener la grabación mediante comandos de PowerShell

Tanto los usuarios finales como los administradores pueden usar comandos de PowerShell para administrar las grabaciones.

Importar el módulo de Grabación de sesiones

Antes de ejecutar cualquier comando, asegúrese de que el módulo necesario esté importado.

Abra PowerShell e importe el módulo ejecutando:

Import-Module -DisableNameChecking 'C:\Program Files\Citrix\SessionRecording\Agent\Bin\EndUserInitiatedSRSnapin.dll'

Comandos disponibles

La siguiente tabla enumera tres comandos de PowerShell que permiten la grabación de sesiones activada por el usuario final.

Ejemplo 1: Grabación activada por el usuario final

Los usuarios finales pueden activar grabaciones para su sesión activa actual para capturar operaciones dinámicamente (por ejemplo, para fines de solución de problemas).

El usuario puede realizar los siguientes pasos dentro de la sesión:

1. Inicie PowerShell desde el escritorio de la sesión.

2. Importe el módulo como se describe en la sección anterior.
3. Utilice el comando Get-SessionRecording Status para comprobar el estado de la grabación y asegurarse de que la sesión no se esté grabando ya.
4. Utilice el comando Start-SessionRecording para iniciar la grabación de la sesión.

5. Utilice el comando Get-SessionRecordingStatus para comprobar el estado de la grabación y asegurarse de que la sesión se esté grabando. El estado debe ser Recording.

   

6. Reproduzca el problema o realice las operaciones que deban documentarse.
7. Utilice el comando Stop-SessionRecording para detener la grabación una vez que las operaciones hayan finalizado.
8. Busque el archivo de grabación y continúe con la solución de problemas de seguimiento. De forma predeterminada, la ruta de almacenamiento es: % USE RPROFILE %\Videos\SessionRecordings, esto se puede personalizar configurando los ajustes básicos del agente de implementación.

Nota:

La grabación se detendrá automáticamente cuando la duración de la sesión alcance los 30 minutos o el tamaño del archivo alcance los 60 MB.

Ejemplo 2: Grabación iniciada por el administrador

Los administradores pueden iniciar grabaciones para sesiones activas específicas en la máquina (por ejemplo, para ayudar a un usuario con la solución de problemas).

El administrador puede realizar los siguientes pasos en la máquina que aloja la sesión:

1. Inicie PowerShell como administrador.
2. Importe el módulo como se describe en la sección anterior.

3. Obtenga el SessionID de la sesión del usuario de destino utilizando el comando query session. query session | Select-String "Active"

   

4. Utilice el comando Get-SessionRecordingStatus -SessionId <SessionID> para comprobar el estado de la grabación, asegúrese de que la sesión no se esté grabando ya. El estado debería mostrarse como se indica a continuación:

   

5. Utilice el comando Start-SessionRecording -SessionId <SessionID> para iniciar la grabación de la sesión.

6. Utilice el comando Get-SessionRecordingStatus -SessionId <SessionID> para comprobar el estado de la grabación, asegúrese de que la sesión se esté grabando. El estado debería ser Recording.

7. Indique al usuario que reproduzca el problema o que realice las operaciones que deban documentarse.
8. Utilice Stop-SessionRecording -SessionId <SessionID> para detener la grabación una vez que las operaciones se hayan completado.
9. Busque el archivo de grabación en el perfil del usuario de destino, como: C:\Users\user0\Videos\SessionRecordings y continúe con la solución de problemas de seguimiento.

Iniciar o detener la grabación mediante una tecla de acceso rápido

Los usuarios finales también pueden controlar la grabación mediante teclas de acceso rápido (Hotkeys). Por defecto, esta función está deshabilitada.

Habilitar teclas de acceso rápido

Para habilitar la funcionalidad de teclas de acceso rápido, en la máquina VDA:

Set-SessionRecordingConfiguration -PerMachine -EnableHotkeys $true

Este comando requiere una cuenta de administrador local para ejecutarse.

La configuración se aplica por máquina y tendrá efecto en las sesiones activas posteriores.

Atajos predeterminados

Una vez habilitadas, las teclas de acceso rápido predeterminadas son:

• Iniciar grabación: CTRL + SHIFT + F8
• Detener grabación: CTRL + SHIFT + F9

Nota:

Por defecto, la ruta de almacenamiento está en: %USERPROFILE%\Videos\SessionRecordings, esto se puede personalizar Configurando los ajustes básicos del agente de implementación.

La grabación se detendrá automáticamente cuando la duración de la sesión alcance los 30 minutos, o el tamaño del archivo alcance los 60 MB.

Personalizar teclas de acceso rápido

Si las teclas de acceso rápido predeterminadas entran en conflicto con otras aplicaciones, puede personalizarlas utilizando el siguiente comando:

Set-SessionRecordingConfiguration -PerMachine -StartHotKey <hotkey> -StopHotKey <hotkey>

Reglas de atajos:

• Solo se pueden usar F1–F12 o letras mayúsculas (A–Z) como última tecla.
• Solo se define la última tecla de la combinación. El prefijo CTRL + SHIFT es obligatorio y se aplica automáticamente.

Ejemplo: Para establecer la tecla de acceso rápido de inicio en CTRL + SHIFT + F1, debe introducir F1 como la <hotkey>.

Iniciar o detener la grabación mediante la grabación dinámica

También puede activar grabaciones mediante las directivas de Grabación dinámica de sesiones. Para obtener más información, consulte Grabación dinámica de sesiones.

Nota:

De forma predeterminada, la ruta de almacenamiento es: %USERPROFILE%\Videos\SessionRecordings, esto se puede personalizar mediante Configuración de los ajustes básicos del agente de implementación.

La grabación se detendrá automáticamente cuando la duración de la sesión alcance los 30 minutos o el tamaño del archivo alcance los 60 MB.

Configuración de los ajustes básicos del agente de implementación

Puede personalizar la configuración del agente de implementación básico mediante comandos de PowerShell. Estos ajustes se aplican a nivel de máquina o de usuario.

Requisitos previos

Antes de configurar los ajustes, debe importar el módulo necesario en la sesión de PowerShell.

1. Abra PowerShell y navegue hasta la carpeta de instalación del agente: carpeta <SessionRecordingAgent installation path>\Bin.

   Por ejemplo: cd "C:\Program Files\Citrix\SessionRecording\Agent\Bin\"

2. Importe el módulo ejecutando:

   import-module -DisableNameChecking.\EndUserInitiatedSRSnapin.dll

   

Comandos de configuración de PowerShell

La siguiente tabla enumera los comandos de PowerShell para administrar la configuración de la grabación de sesiones:

Parámetros de configuración

Los parámetros disponibles para el modo de implementación básico se enumeran a continuación. Puede usar el cmdlet Set-SessionRecordingConfiguration para configurarlos.

Agregue el parámetro de modificador -PerMachine para aplicar la configuración en la máquina. Esto requiere privilegios de administrador. Si se especifica, la configuración se aplica a nivel de máquina. Si se omite, la configuración se aplica a nivel de usuario.

Nota:

Si personaliza esta configuración en varios niveles, el orden de prioridad es: Sesión > Usuario > Máquina.

Ejemplo de configuración

Estos ejemplos ilustran cómo los diferentes usuarios configuran los ajustes y cómo el agente determina el ajuste final y efectivo.

Ejemplo 1: El administrador deshabilita la grabación iniciada por el usuario

Un administrador local (por ejemplo, LocalAdmin) puede establecer una política para toda la máquina que deshabilite la capacidad de todos los usuarios estándar para iniciar grabaciones manualmente.

Set-SessionRecordingConfiguration -PerMachine -AllowUserTrigger $false

Explicación: Este comando requiere privilegios administrativos (-PerMachine) e impide que cualquier usuario de este VDA utilice Start-SessionRecording, independientemente de su configuración a nivel de usuario.

Ejemplo 2: El administrador establece los valores predeterminados de toda la máquina

El LocalAdmin establece la ubicación de almacenamiento predeterminada, la duración máxima y el tamaño máximo para todos los usuarios del VDA.

Set-SessionRecordingConfiguration -PerMachine -StoragePath "D:\SessionRecordings"-MaximumDurationInMinutes 120 - MaximumSizeInMegabytes 500

Explicación: Esto establece la configuración a nivel de máquina. Para un usuario estándar (por ejemplo, User0), las grabaciones ahora se guardarán de forma predeterminada en D:\SessionRecordings y se detendrán después de 120 minutos o 500 MB, lo que ocurra primero.

Ejemplo 3: El usuario estándar anula la configuración predeterminada de la máquina

El usuario estándar (User0) prefiere guardar sus archivos localmente en la unidad C:, anulando la configuración a nivel de máquina del administrador.

Set-SessionRecordingConfiguration -StoragePath "C:\Users\User0\ SessionRecordings" -MaximumDurationInMinutes 60

Explicación: Dado que este comando se ejecuta sin el modificador -PerMachine, se aplica a nivel de usuario. Debido a que la configuración a nivel de usuario tiene una prioridad más alta que la configuración a nivel de máquina, las grabaciones de User0 ahora se guardarán en C:\Users\User0\SessionRecordings y se detendrán después de 60 minutos.

Ejemplo 4: Anulación específica de la sesión

Durante una grabación específica, User0 necesita guardar temporalmente el archivo en un recurso compartido de red (\\fileshare\temp) y limitar la duración a 15 minutos, anulando tanto la configuración de usuario como la de máquina.

Start-SessionRecording -StoragePath "\\fileshare\temp" - MaximumDurationInMinutes 15

Explicación: Los parámetros se pasan directamente a Start-SessionRecording para crear una anulación a nivel de sesión, que tiene la prioridad más alta y solo es válida para esa única instancia de grabación. La siguiente sesión de grabación volverá a la configuración de usuario o de máquina.

Comprobación de la configuración

Utilice el cmdlet Get-SessionRecordingConfiguration para ver los valores configurados actualmente y la configuración efectiva final:

Get-SessionRecordingConfiguration

Explicación: Este comando muestra el resultado de aplicar la jerarquía (Sesión > Usuario > Máquina), proporcionando la configuración actualmente en uso para el usuario que ejecuta el comando.

Borrar configuración

Utilice el cmdlet Clear-SessionRecordingConfiguration para eliminar la configuración personalizada, permitiendo que el agente vuelva a la configuración de mayor prioridad.

• Borrar la configuración específica del usuario:

  Si User0 quiere dejar de guardar archivos en C:\Users\User0\SessionRecordings y revertir la configuración personalizada a la predeterminada, ejecutaría:

  Clear-SessionRecordingConfiguration -StoragePath - MaximumDurationInMinutes

Explicación: Esto borra los valores StoragePath y MaximumDurationInMinutes del ámbito de usuario.

• Borrar todas las configuraciones a nivel de máquina (requiere privilegios de administrador):

  Clear-SessionRecordingConfiguration -PerMachine -ClearAll

Explicación: Este comando requiere privilegios administrativos (-PerMachine) y borra todas las configuraciones personalizadas establecidas a nivel de máquina.

Cambiar el tipo de implementación del agente

El agente de grabación de sesiones admite dos modos de implementación distintos:

• Modo de implementación básico: Proporciona un método ligero para grabar sesiones activas localmente como archivos MP4 sin implementar componentes de back-end. Este modo está activo cuando la dirección del servidor de grabación de sesiones se establece en localhost.
• Modo de implementación estándar: Es la implementación tradicional y administrada centralmente donde el agente se conecta a un servidor de grabación de sesiones. Este modo ofrece alta escalabilidad y funciones avanzadas. Este modo está activo cuando la dirección del servidor de grabación de sesiones se establece en el nombre de dominio completo (FQDN) del servidor.

El modo operativo se determina por el valor de Session Recording Server configurado en las propiedades del agente de grabación de sesiones o en el registro de Windows.

Método 1: Uso de las propiedades del agente de grabación de sesiones

Puede cambiar los modos manualmente en un VDA específico.

1. Inicie sesión en el VDA donde está instalado el agente de grabación de sesiones.

2. En el menú Inicio, elija Propiedades del agente de grabación de sesiones.

3. Haga clic en la ficha Conexiones.

4. Modifique el valor en el campo Session Recording Server:
   1. Modo de implementación básico: Introduzca localhost.
   2. Modo de implementación estándar: Introduzca el FQDN de su servidor de grabación de sesiones.
5. Haga clic en Aceptar para guardar los cambios.

Método 2: Uso del Registro de Windows o la Directiva de grupo

Para implementaciones a gran escala, puede configurar la opción directamente en el Registro de Windows, normalmente implementada a través de un objeto de directiva de grupo (GPO).

• Clave del Registro: HKEY_LOCAL_MACHINE\SOFTWARE\Citrix\SmartAuditor\Agent\
• Nombre del valor: SmAudServerName

• Datos del valor:

  • Para el modo de implementación básico: Establezca el valor en localhost.
  • Para el modo de implementación estándar: Establezca el valor en el FQDN de su servidor de grabación de sesiones.

  Nota:

  Consideraciones clave para el cambio de modo

  • El agente de grabación de sesiones lee el valor de configuración solo al inicio de una sesión. Cualquier cambio en el modo de implementación surtirá efecto en la siguiente sesión nueva iniciada en el VDA.

  • Se recomienda encarecidamente que no cambie de modo mientras haya sesiones de grabación activas o en curso. Espere a que todas las grabaciones activas se detengan para evitar problemas de coherencia de los datos.

Administrar archivos de grabación

La grabación de sesiones proporciona una herramienta local, SRAgentTool.exe, para ayudarle a administrar los archivos de grabación. La herramienta ofrece las siguientes funciones:

• Recuperar grabaciones MP4 dañadas: Repara archivos MP4 que no se pueden reproducir debido a situaciones anómalas, como un bloqueo inesperado del proceso gráfico.

• verificar la integridad de la grabación MP4: Comprueba si un archivo de grabación ha sido manipulado para garantizar su autenticidad.

Puede acceder a la herramienta en el siguiente directorio: <Session RecordingAgent installation path>\Bin.

Ver instrucciones de uso

Para ver la información de ayuda y las instrucciones de uso de la herramienta, ejecute el siguiente comando en PowerShell o el símbolo del sistema:

.\SRAgentTool.exe --help

O

.\SRAgentTool.exe -h

Recuperar grabaciones dañadas

Si un archivo de grabación no se puede reproducir, utilice el comando de recuperación para intentar una reparación. Comando:

.\SRAgentTool.exe --recover <path_to_mp4>

Salida:

• Éxito: La herramienta muestra Recuperación correcta y la ruta del archivo recién recuperado (normalmente con el sufijo _recover.mp4).

  

• No se necesita recuperación: Si el archivo ya se puede reproducir, la herramienta muestra El archivo se puede reproducir normalmente, no es necesario recuperarlo.

  

verificar la integridad de la grabación

Para verificar que un archivo de grabación no ha sido modificado, utilice el comando de validación para comprobar su firma SHA512.

Comando: .\SRAgentTool.exe --valid <path_to_mp4>

Salida:

• Válido: La firma sha512 coincide correctamente.

  

• Manipulado: La firma sha512 no coincide.

  

• Archivo no válido: El archivo no es un archivo mp4 legal.