动态会话录制功能
以前，会话录制严格在符合录制策略的会话刚开始时启动，并在这些会话结束时严格停止。
从 7.18 版本开始，Citrix 引入了动态会话录制功能。借助此功能，您可以在会话期间的任何时间开始或停止录制特定会话或特定用户启动的会话。
注意：
为使此功能按预期工作，请将会话录制、VDA 和交付控制器升级到 7.18 版或更高版本。
启用或禁用动态会话录制
在 Session Recording Agent 上，添加了一个注册表值用于启用或禁用此功能。此注册表值默认设置为 1，这意味着此功能默认处于启用状态。
要启用或禁用此功能，请执行以下操作：
- 在会话录制安装完成后，请使用管理员账户登录到安装了会话录制代理的计算机。
- 打开注册表编辑器。
- 浏览到
HKEY_LOCAL_MACHINE\SOFTWARE\Citrix\SmartAuditor。 - 将 DynamicControlAllowed 的值设置为 0 或使用默认值 1。 1：启用动态录制 0：禁用动态录制
- 重新启动 Session Recording Agent 以使您的设置生效。 如果您使用 MCS 或 PVS 进行部署，请在主映像上更改设置并执行更新以使您的更改生效。
警告：
不正确地编辑注册表可能导致严重问题，可能需要重新安装操作系统。Citrix® 无法保证能够解决因不正确使用注册表编辑器而导致的问题。请自行承担使用注册表编辑器的风险。编辑注册表之前，请务必备份注册表。
通过使用 Citrix Broker SDK 中的 PowerShell 命令，动态启动或停止录制
下表列出了在 Citrix Broker 开发工具包中为动态会话录制功能添加的三个 PowerShell 命令。有关 Citrix Broker 开发工具包的信息，请参阅 Citrix 开发工具包和 API 和 Citrix Virtual Apps and Desktops 开发工具包。
| 命令 | 详细信息 |
|---|---|
| 启动 Broker 会话录制 | 允许您开始录制特定的活动会话、活动会话列表或由特定用户启动的会话。有关详细信息，请运行 Get-Help Start-BrokerSessionRecording 以查看命令联机帮助。 |
| 停止 Broker 会话录制 | 允许您停止录制特定的活动会话、活动会话列表或由特定用户启动的会话。有关详细信息，请运行 Get-Help Stop-BrokerSessionRecording 以查看命令联机帮助。 |
| Get-BrokerSessionRecordingStatus | 允许您获取特定活动会话的录制状态。有关详细信息，请运行 Get-Help Get-BrokerSessionRecordingStatus 以查看命令联机帮助。 |
例如，当用户报告问题并需要及时支持时，您可以使用此功能动态开始录制用户的活动会话，并回放实时录制以进行后续故障排除。您可以执行以下操作：
-
Launch PowerShell from the Citrix Studio console.
-
使用
Get-BrokerSession命令获取目标用户的所有活动会话。
-
使用
Get-BrokerSessionRecordingStatus命令获取指定会话的录制状态。
注意：
-Session 参数一次只能接受一个会话 Uid。
-
使用
Start-BrokerSessionRecording命令开始录制。默认情况下，将显示通知消息以告知用户录制活动。下表显示了使用
Start-BrokerSessionRecording命令的常见方法。命令 详细信息 Start-BrokerSessionRecording -User DomainA \ UserA 开始录制名为 DomainA 的域中用户 UserA 的所有会话，并通知 UserA。 Start-BrokerSessionRecording -User DomainA \ UserA -NotifyUser $false 开始录制名为 DomainA 的域中用户 UserA 的所有会话，并且不通知 UserA。 Start-BrokerSessionRecording -Sessions $SessionObject 开始录制名为 $SessionObject 的对象中的所有会话并通知用户。要获取对象 $SessionObject，请运行 $SessionObject=Get-BrokerSession –username UserA。对象的名称以美元符号 $ 为前缀。有关详细信息，请参阅步骤 2 和命令联机帮助。Start-BrokerSessionRecording -Sessions uid1,uid2,…,uidn 开始录制会话 uid1、uid2、…、uidn，并通知用户。 -
使用
Get-BrokerSessionRecordingStatus命令获取每个目标会话的录制状态。该状态应为 SessionBeingRecorded。 -
在会话录制播放器中播放实时或完整录制，然后进行后续故障排除。
注意：
当您播放由
Stop-BrokerSessionRecording命令结束的“完整”录制，并且录制会话的最后一部分处于空闲状态时，播放器进度条上的时间线最后一部分可能会显示为灰色。当录制会话持续活动时，这一点不明显。 -
当报告的问题已分类或解决时，使用
Stop-BrokerSessionRecording命令停止录制。下表显示了使用此命令的常见方法：
命令 详细说明 Stop-BrokerSessionRecording -User DomainA \ UserA 停止录制名为 DomainA 的域中用户 UserA 的所有会话。 Stop-BrokerSessionRecording -Sessions $SessionObject 停止录制 $SessionObject 中的所有会话。 Stop-BrokerSessionRecording -Sessions uid1,uid2,…,uidn 停止录制会话 uid1、uid2、…、和 uidn。
在 Citrix Studio 的日志记录屏幕上，您可以查看 Start-BrokerSessionRecording 和 Stop-BrokerSessionRecording 命令生成的日志。
