Grundlegende Bereitstellungsagenten verwalten

Sie können Session Recording verwenden, um grundlegende Bereitstellungsagenten zu verwalten. Diese Funktion bietet eine einfache Methode zur Bereitstellung von Session Recording. Sie können diese Bereitstellungsmethode nutzen, um grundlegende Session Recording-Funktionen zu verwenden – aktive Sitzungen in MP4-Dateien aufzuzeichnen, ohne die Backend-Komponenten wie Session Recording Server, Player, Datenbanken und Konsolen bereitzustellen.

Installation

Der Session Recording Agent wird standardmäßig zusammen mit dem Citrix Virtual Delivery Agent (VDA) installiert.

• Neuinstallation: Bei der Installation oder dem Upgrade auf VDA-Version 2511 oder höher wird der Session Recording Agent installiert und arbeitet im Bereitstellungsmodus.

• Bestehende Installation: Wenn Sie bereits einen Session Recording Agent installiert haben, können Sie in den grundlegenden Bereitstellungsmodus wechseln, indem Sie den Agent auf Version 2511 oder höher aktualisieren und die Session Recording Server-Adresse in den Session Recording Agent-Eigenschaften auf localhost ändern.

Den grundlegenden Bereitstellungsagenten verwenden

Im grundlegenden Bereitstellungsmodus können Aufzeichnungen manuell von Endbenutzern oder Administratoren mithilfe des Citrix Virtual Desktop Assistant oder von PowerShell-Befehlen ausgelöst werden. Sie können auch durch Hotkeys oder dynamische Aufzeichnung ausgelöst werden.

Aufzeichnung mithilfe des Citrix Virtual Desktop Assistant starten oder beenden

Der Citrix Virtual Desktop Assistant wird standardmäßig in CVAD installiert. Er enthält eine integrierte Session Recording-Seite, die es Kunden ermöglicht, ihre aktiven virtuellen Desktopsitzungen manuell aufzuzeichnen. Diese Funktion ermöglicht es Kunden, Bildschirmaktivitäten als MP4-Videoclips zur Fehlerbehebung, Zusammenarbeit und Sitzungsüberprüfung zu erfassen.

Weitere Informationen finden Sie unter Citrix Virtual Desktop Assistant-Anwendung.

Aufzeichnung mithilfe von PowerShell-Befehlen starten oder beenden

Sowohl Endbenutzer als auch Administratoren können PowerShell-Befehle verwenden, um Aufzeichnungen zu verwalten.

Das Session Recording-Modul importieren

Bevor Sie Befehle ausführen, stellen Sie sicher, dass das erforderliche Modul importiert wurde.

Öffnen Sie PowerShell und importieren Sie das Modul, indem Sie Folgendes ausführen:

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

Verfügbare Befehle

Die folgende Tabelle listet drei PowerShell-Befehle auf, die eine vom Endbenutzer ausgelöste Sitzungs aufzeichnung ermöglichen.

Beispiel 1: Vom Endbenutzer ausgelöste Aufzeichnung

Endbenutzer können Aufzeichnungen für ihre aktuell aktive Sitzung auslösen, um Vorgänge dynamisch zu erfassen (z. B. zu Fehlerbehebungszwecken).

Der Benutzer kann die folgenden Schritte innerhalb der Sitzung ausführen:

1. Starten Sie PowerShell vom Sitzungsdesktop aus.

2. Importieren Sie das Modul wie im vorherigen Abschnitt beschrieben.
3. Verwenden Sie den Befehl Get-SessionRecording Status, um den Aufzeichnungsstatus zu überprüfen und sicherzustellen, dass die Sitzung nicht bereits aufgezeichnet wird.
4. Verwenden Sie den Befehl Start-SessionRecording, um die Aufzeichnung der Sitzung zu starten.

5. Verwenden Sie den Befehl Get-SessionRecordingStatus, um den Aufzeichnungsstatus zu überprüfen und sicherzustellen, dass die Sitzung aufgezeichnet wird. Der Status sollte Recording sein.

   

6. Reproduzieren Sie das Problem oder führen Sie die Vorgänge aus, die dokumentiert werden müssen.
7. Verwenden Sie den Befehl Stop-SessionRecording, um die Aufzeichnung zu beenden, sobald die Vorgänge abgeschlossen sind.
8. Suchen Sie die Aufzeichnungsdatei und fahren Sie mit der weiteren Fehlerbehebung fort. Standardmäßig befindet sich der Speicherpfad unter: % USE RPROFILE %\Videos\SessionRecordings, dies kann durch Konfigurieren der Einstellungen des grundlegenden Bereitstellungsagenten angepasst werden.

Hinweis:

Die Aufzeichnung wird automatisch beendet, wenn die Sitzungsdauer 30 Minuten oder die Dateigröße 60 MB erreicht.

Beispiel 2: Vom Administrator ausgelöste Aufzeichnung

Administratoren können Aufzeichnungen für bestimmte aktive Sitzungen auf dem Computer auslösen (z. B. um einem Benutzer bei der Fehlerbehebung zu helfen).

Der Administrator kann die folgenden Schritte auf dem Computer ausführen, der die Sitzung hostet:

1. Starten Sie PowerShell als Administrator.
2. Importieren Sie das Modul, wie im vorherigen Abschnitt beschrieben.

3. Rufen Sie die SessionID der Zielbenutzersitzung mit dem Befehl „query session“ ab. query session | Select-String "Active"

   

4. Verwenden Sie den Befehl Get-SessionRecordingStatus -SessionId <SessionID>, um den Aufnahmestatus zu überprüfen und sicherzustellen, dass die Sitzung nicht bereits aufgezeichnet wird. Der Status sollte wie folgt angezeigt werden:

   

5. Verwenden Sie den Befehl Start-SessionRecording -SessionId <SessionID>, um die Aufzeichnung der Sitzung zu starten.

6. Verwenden Sie den Befehl Get-SessionRecordingStatus -SessionId <SessionID>, um den Aufnahmestatus zu überprüfen und sicherzustellen, dass die Sitzung aufgezeichnet wird. Der Status sollte Recording sein.

7. Weisen Sie den Benutzer an, das Problem zu reproduzieren oder die Vorgänge auszuführen, die dokumentiert werden müssen.
8. Verwenden Sie Stop-SessionRecording -SessionId <SessionID>, um die Aufzeichnung zu beenden, sobald die Vorgänge abgeschlossen sind.
9. Suchen Sie die Aufzeichnungsdatei unter dem Zielbenutzerprofil, z. B.: C:\Users\user0\Videos\SessionRecordings und fahren Sie mit der weiteren Fehlerbehebung fort.

Aufzeichnung mit Hotkey starten oder stoppen

Endbenutzer können die Aufzeichnung auch über Tastenkombinationen (Hotkeys) steuern. Standardmäßig ist diese Funktion deaktiviert.

Hotkeys aktivieren

Um die Hotkey-Funktionalität zu aktivieren, gehen Sie auf der VDA-Maschine wie folgt vor:

Set-SessionRecordingConfiguration -PerMachine -EnableHotkeys $true

Dieser Befehl erfordert zur Ausführung ein lokales Administratorkonto.

Die Einstellung wird pro Maschine angewendet und tritt für nachfolgende aktive Sitzungen in Kraft.

Standard-Hotkeys

Nach der Aktivierung sind die Standard-Hotkeys:

• Aufnahme starten: STRG + UMSCHALT + F8
• Aufnahme stoppen: STRG + UMSCHALT + F9

Hinweis:

Standardmäßig befindet sich der Speicherpfad unter: %USERPROFILE%\Videos\SessionRecordings, dies kann durch Konfigurieren der Einstellungen des grundlegenden Bereitstellungs-Agenten angepasst werden.

Die Aufzeichnung wird automatisch beendet, wenn die Sitzungsdauer 30 Minuten erreicht oder die Dateigröße 60 MB beträgt.

Hotkeys anpassen

Wenn die Standard-Hotkeys mit anderen Anwendungen in Konflikt stehen, können Sie sie mit dem folgenden Befehl anpassen:

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

Hotkey-Regeln:

• Als letzte Taste können nur F1–F12 oder Großbuchstaben (A–Z) verwendet werden.
• Sie definieren nur die letzte Taste in der Kombination. Das Präfix STRG + UMSCHALT ist obligatorisch und wird automatisch angewendet.

Beispiel: Um den Start-Hotkey auf STRG + UMSCHALT + F1 festzulegen, geben Sie F1 als <hotkey> ein.

Aufzeichnung starten oder stoppen mit Dynamic Recording

Sie können Aufzeichnungen auch mithilfe von Dynamic Session Recording-Richtlinien auslösen. Weitere Informationen finden Sie unter Dynamic Session Recording.

Hinweis:

Standardmäßig befindet sich der Speicherpfad unter: %USERPROFILE%\Videos\SessionRecordings, dies kann durch Konfigurieren der Einstellungen des grundlegenden Bereitstellungsagenten angepasst werden.

Die Aufzeichnung wird automatisch beendet, wenn die Sitzungsdauer 30 Minuten oder die Dateigröße 60 MB erreicht.

Konfigurieren der Einstellungen des grundlegenden Bereitstellungsagenten

Sie können die Einstellungen für den grundlegenden Bereitstellungsagenten mithilfe von PowerShell-Befehlen anpassen. Diese Einstellungen werden auf Maschinen- oder Benutzerebene angewendet.

Voraussetzungen

Bevor Sie die Einstellungen konfigurieren, müssen Sie das erforderliche Modul in die PowerShell-Sitzung importieren.

1. Öffnen Sie PowerShell und navigieren Sie zum Installationsordner des Agenten: Ordner <SessionRecordingAgent installation path>\Bin.

   Zum Beispiel: cd "C:\Program Files\Citrix\SessionRecording\Agent\Bin\"

2. Importieren Sie das Modul, indem Sie Folgendes ausführen:

   import-module -DisableNameChecking.\EndUserInitiatedSRSnapin.dll

   

PowerShell-Konfigurationsbefehle

Die folgende Tabelle listet die PowerShell-Befehle zur Verwaltung der Sitzungsaufzeichnungskonfiguration auf:

Konfigurationseinstellungen

Die für den grundlegenden Bereitstellungsmodus verfügbaren Einstellungen sind wie folgt aufgeführt. Sie können das Set-SessionRecordingConfiguration-Cmdlet verwenden, um sie zu konfigurieren.

Fügen Sie den -PerMachine Switch-Parameter hinzu, um die Konfiguration auf dem Computer anzuwenden. Dies erfordert Administratorrechte. Wenn angegeben, gelten die Einstellungen auf Computerebene. Wenn weggelassen, gelten die Einstellungen auf Benutzerebene.

Hinweis:

Wenn Sie diese Einstellungen auf mehreren Ebenen anpassen, ist die Prioritätsreihenfolge: Sitzung > Benutzer > Maschine.

Beispielkonfiguration

Diese Beispiele veranschaulichen, wie verschiedene Benutzer Konfigurationen festlegen und wie der Agent die endgültige, effektive Einstellung bestimmt.

Beispiel 1: Administrator deaktiviert benutzergesteuerte Aufzeichnung

Ein lokaler Administrator (z. B. LocalAdmin) kann eine maschinenweite Richtlinie festlegen, um die Möglichkeit für alle Standardbenutzer zu deaktivieren, Aufzeichnungen manuell zu starten.

Set-SessionRecordingConfiguration -PerMachine -AllowUserTrigger $false

Erklärung: Dieser Befehl erfordert Administratorrechte (-PerMachine) und verhindert, dass Benutzer auf diesem VDA Start-SessionRecording verwenden können, unabhängig von ihren benutzerspezifischen Einstellungen.

Beispiel 2: Administrator legt maschinenweite Standardwerte fest

Der LocalAdmin legt den Standardspeicherort, die maximale Dauer und die maximale Größe für alle Benutzer auf dem VDA fest.

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

Erklärung: Dies legt die Konfiguration auf Maschinenebene fest. Für einen Standardbenutzer (z. B. User0) werden Aufzeichnungen nun standardmäßig in D:\SessionRecordings gespeichert und nach 120 Minuten oder 500 MB beendet, je nachdem, was zuerst eintritt.

Beispiel 3: Standardbenutzer überschreibt maschinenweite Standardwerte

Der Standardbenutzer (User0) speichert seine Dateien lieber lokal auf dem Laufwerk C und überschreibt damit die Einstellung des Administrators auf Maschinenebene.

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

Erklärung: Da dieser Befehl ohne den Schalter -PerMachine ausgeführt wird, gilt er auf Benutzerebene. Da Einstellungen auf Benutzerebene eine höhere Priorität haben als Einstellungen auf Maschinenebene, werden die Aufzeichnungen von User0 nun in C:\Users\User0\SessionRecordings gespeichert und nach 60 Minuten beendet.

Beispiel 4: Sitzungsspezifische Überschreibung

Während einer bestimmten Aufzeichnung muss User0 die Datei temporär auf einer Netzwerkfreigabe (\\fileshare\temp) speichern und die Dauer auf 15 Minuten begrenzen, wobei sowohl Benutzer- als auch Maschineneinstellungen überschrieben werden.

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

Erklärung: Parameter, die direkt an Start-SessionRecording übergeben werden, um eine sitzungsbezogene Überschreibung zu erstellen, die die absolut höchste Priorität hat und nur für diese einzelne Aufzeichnungsinstanz gültig ist. Die nächste Aufzeichnungssitzung wird auf die Benutzer- oder Maschinenkonfiguration zurückgesetzt.

Konfiguration prüfen

Verwenden Sie das Get-SessionRecordingConfiguration-Cmdlet, um die aktuell konfigurierten Werte und die endgültige effektive Einstellung anzuzeigen:

Get-SessionRecordingConfiguration

Erklärung: Dieser Befehl zeigt das Ergebnis der Anwendung der Hierarchie (Sitzung > Benutzer > Maschine) und liefert die Einstellungen, die derzeit für den Benutzer verwendet werden, der den Befehl ausführt.

Konfiguration löschen

Verwenden Sie das Clear-SessionRecordingConfiguration-Cmdlet, um benutzerdefinierte Einstellungen zu entfernen, damit der Agent auf die Konfiguration mit der nächsthöheren Priorität zurückgreifen kann.

• Spezifische Benutzereinstellungen löschen:

  Wenn User0 das Speichern von Dateien unter C:\Users\User0\SessionRecordings beenden und benutzerdefinierte Einstellungen auf die Standardeinstellung zurücksetzen möchte, würde er/sie Folgendes ausführen:

  Clear-SessionRecordingConfiguration -StoragePath - MaximumDurationInMinutes

Erklärung: Dies löscht die Werte StoragePath und MaximumDurationInMinutes aus dem Benutzerbereich.

• Alle maschinenweiten Konfigurationen löschen (Administratorrechte erforderlich):

  Clear-SessionRecordingConfiguration -PerMachine -ClearAll

Erläuterung: Dieser Befehl erfordert Administratorrechte (-PerMachine) und löscht alle benutzerdefinierten Konfigurationen, die auf Maschinenebene festgelegt wurden.

Agent-Bereitstellungstyp wechseln

Der Sitzungsaufzeichnungs-Agent unterstützt zwei verschiedene Bereitstellungsmodi:

• Basis-Bereitstellungsmodus: Dies ist eine schlanke Methode, um aktive Sitzungen lokal als MP4-Dateien aufzuzeichnen, ohne Backend-Komponenten bereitzustellen. Dieser Modus ist aktiv, wenn die Adresse des Sitzungsaufzeichnungsservers auf localhost festgelegt ist.
• Standard-Bereitstellungsmodus: Dies ist die traditionelle, zentral verwaltete Bereitstellung, bei der der Agent eine Verbindung zu einem Sitzungsaufzeichnungsserver herstellt. Dieser Modus bietet hohe Skalierbarkeit und erweiterte Funktionen. Dieser Modus ist aktiv, wenn die Adresse des Sitzungsaufzeichnungsservers auf den vollqualifizierten Domänennamen (FQDN) des Servers festgelegt ist.

Der Betriebsmodus wird durch den Wert Sitzungsaufzeichnungsserver bestimmt, der in den Eigenschaften des Sitzungsaufzeichnungs-Agents oder in der Windows-Registrierung konfiguriert ist.

Methode 1: Verwenden der Eigenschaften des Sitzungsaufzeichnungs-Agents

Sie können die Modi auf einem bestimmten VDA manuell wechseln.

1. Melden Sie sich am VDA an, auf dem der Sitzungsaufzeichnungs-Agent installiert ist.

2. Wählen Sie im Menü Start die Option Eigenschaften des Sitzungsaufzeichnungs-Agents.

3. Klicken Sie auf die Registerkarte Verbindungen.

4. Ändern Sie den Wert im Feld Sitzungsaufzeichnungsserver:
   1. Basis-Bereitstellungsmodus: Geben Sie localhost ein.
   2. Standard-Bereitstellungsmodus: Geben Sie den FQDN Ihres Sitzungsaufzeichnungsservers ein.
5. Klicken Sie auf OK, um die Änderungen zu speichern.

Methode 2: Verwenden der Windows-Registrierung oder Gruppenrichtlinie

Bei groß angelegten Bereitstellungen können Sie die Einstellung direkt in der Windows-Registrierung konfigurieren, die typischerweise über ein Gruppenrichtlinienobjekt (GPO) bereitgestellt wird.

• Registrierungsschlüssel: HKEY_LOCAL_MACHINE\SOFTWARE\Citrix\SmartAuditor\Agent\
• Wertname: SmAudServerName

• Wertdaten:

  • Für den grundlegenden Bereitstellungsmodus: Setzen Sie den Wert auf localhost.
  • Für den Standard-Bereitstellungsmodus: Setzen Sie den Wert auf den FQDN Ihres Session Recording Servers.

  Hinweis:

  Wichtige Überlegungen zum Moduswechsel

  • Der Session Recording-Agent liest den Konfigurationswert nur zu Beginn einer Sitzung. Jede Änderung des Bereitstellungsmodus wird bei der nächsten neuen Sitzung wirksam, die auf dem VDA gestartet wird.

  • Es wird dringend empfohlen, die Modi nicht zu wechseln, während aktive oder laufende Aufzeichnungssitzungen vorhanden sind. Warten Sie, bis alle aktiven Aufzeichnungen beendet sind, um Datenkonsistenzprobleme zu vermeiden.

Aufzeichnungsdateien verwalten

Session Recording bietet ein lokales Tool, SRAgentTool.exe, das Ihnen bei der Verwaltung von Aufzeichnungsdateien hilft. Das Tool bietet die folgenden Funktionen:

• Beschädigte MP4-Aufzeichnungen wiederherstellen: Repariert MP4-Dateien, die aufgrund abnormaler Situationen, wie z. B. eines unerwarteten Absturzes des Grafikprozesses, nicht abspielbar sind.

• Integrität von MP4-Aufzeichnungen überprüfen: Prüft, ob eine Aufzeichnungsdatei manipuliert wurde, um ihre Authentizität sicherzustellen.

Sie können auf das Tool im folgenden Verzeichnis zugreifen: Session RecordingAgent installation path>\Bin.

Nutzungshinweise anzeigen

Um die Hilfeinformationen und Nutzungshinweise für das Tool anzuzeigen, führen Sie den folgenden Befehl in PowerShell oder der Eingabeaufforderung aus:

.\SRAgentTool.exe --help

Oder

.\SRAgentTool.exe -h

Beschädigte Aufzeichnungen wiederherstellen

Wenn eine Aufzeichnungsdatei nicht abgespielt werden kann, verwenden Sie den Wiederherstellungsbefehl, um eine Reparatur zu versuchen. Befehl:

.\SRAgentTool.exe --recover <path_to_mp4>

Ausgabe:

• Erfolg: Das Tool zeigt Recover success an und den Pfad der neu wiederhergestellten Datei (typischerweise mit dem Suffix _recover.mp4).

  

• Keine Wiederherstellung erforderlich: Wenn die Datei bereits abspielbar ist, zeigt das Tool The file can play normally an, eine Wiederherstellung ist nicht nötig.

  

Aufzeichnungs-Integrität überprüfen

Um zu überprüfen, ob eine Aufzeichnungsdatei nicht geändert wurde, verwenden Sie den Validierungsbefehl, um ihre SHA512-Signatur zu prüfen.

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

Ausgabe:

• Gültig: Die SHA512-Signatur stimmt überein.

  

• Manipuliert: Die SHA512-Signatur stimmt nicht überein.

  

• Ungültige Datei: Die Datei ist keine gültige MP4-Datei.