Grundlegende Bereitstellungs-Agents verwalten

Sie können Session Recording verwenden, um grundlegende Bereitstellungs-Agents zu verwalten. Diese Funktion bietet eine einfache Methode zur Bereitstellung von Session Recording. Sie können diese Bereitstellungsmethode verwenden, um grundlegende Session Recording-Funktionen zu nutzen – 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-Serveradresse in den Session Recording-Agent-Eigenschaften auf localhost ändern.

Grundlegenden Bereitstellungs-Agent verwenden

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

Aufzeichnung mit PowerShell-Befehlen starten oder beenden

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

Session Recording-Modul importieren

Stellen Sie vor dem Ausführen von Befehlen 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 aktuelle 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 Aufnahmestatus 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 Aufnahmestatus 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 zu dokumentierenden Vorgänge aus.
7. Verwenden Sie den Stop-SessionRecording Befehl, 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 erreicht 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 Get-SessionRecordingStatus -SessionId <SessionID> Befehl, um den Aufnahmestatus zu überprüfen, stellen Sie sicher, dass die Sitzung noch nicht 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 Aufzeichnung 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 ein lokales Administratorkonto zur Ausführung.

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

Standard-Hotkeys

Nach der Aktivierung sind die Standard-Hotkeys:

• Aufzeichnung starten: STRG + UMSCHALT + F8
• Aufzeichnung beenden: STRG + UMSCHALT + F9

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 erreicht oder die Dateigröße 60 MB erreicht.

Hotkeys anpassen

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

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

Hotkey-Regeln:

• Nur F1–F12 oder Großbuchstaben (A–Z) können als letzte Taste 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 beenden 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 Switch-Parameter -PerMachine hinzu, um die Konfiguration auf dem Computer anzuwenden. Dies erfordert Administratorrechte. Wenn angegeben, gelten die Einstellungen auf Computerebene. Wenn weggelassen, gelten die Einstellungen auf der 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 allen Standardbenutzern die Möglichkeit zu nehmen, Aufzeichnungen manuell zu starten.

Set-SessionRecordingConfiguration -PerMachine -AllowUserTrigger $false

Erläuterung: Dieser Befehl erfordert Administratorrechte (-PerMachine) und verhindert, dass ein Benutzer auf diesem VDA Start-SessionRecording verwenden kann, unabhängig von seinen benutzerspezifischen Einstellungen.

Beispiel 2: Administrator legt maschinenweite Standardeinstellungen 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

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

Beispiel 3: Standardbenutzer überschreibt maschinenweite Standardeinstellungen

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

Erläuterung: 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 unter C:\Users\User0\ SessionRecordings gespeichert und nach 60 Minuten beendet.

Beispiel 4: Sitzungsspezifische Außerkraftsetzung

Während einer bestimmten Aufzeichnung muss User0 die Datei vorübergehend auf einer Netzwerkfreigabe (\\fileshare\temp) speichern und die Dauer auf 15 Minuten begrenzen, wobei sowohl Benutzer- als auch Maschineneinstellungen außer Kraft gesetzt werden.

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

Erläuterung: Parameter, die direkt an Start-SessionRecording übergeben werden, um eine sitzungsspezifische Außerkraftsetzung 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 gelten, der den Befehl ausführt.

Konfiguration löschen

Verwenden Sie das Clear-SessionRecordingConfiguration-Cmdlet, um benutzerdefinierte Einstellungen zu entfernen, sodass 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 in 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

Erklärung: 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:

• Basisbereitstellungsmodus: Dies bietet eine einfache Methode, um aktive Sitzungen lokal als MP4-Dateien aufzuzeichnen, ohne Backend-Komponenten bereitzustellen. Dieser Modus ist aktiv, wenn die Adresse des Sitzungsaufzeichnungsservers auf localhost eingestellt ist.
• Standardbereitstellungsmodus: 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 eingestellt ist.

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

Methode 1: Verwenden der Eigenschaften des Sitzungsaufzeichnungs-Agenten

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

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-Agenten.

3. Klicken Sie auf die Registerkarte Verbindungen.

4. Ändern Sie den Wert im Feld Sitzungsaufzeichnungsserver:
   1. Basisbereitstellungsmodus: Geben Sie localhost ein.
   2. Standardbereitstellungsmodus: 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

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

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

• Wertdaten:

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

  Hinweis:

  Wichtige Überlegungen für den Moduswechsel

  • Der Session Recording-Agent liest den Konfigurationswert nur beim Start 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, mit dem Sie Aufzeichnungsdateien verwalten können. 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.

• MP4-Aufzeichnungsintegrität überprüfen: Überprüft, ob eine Aufzeichnungsdatei manipuliert wurde, um ihre Authentizität sicherzustellen.

Sie können das Tool im folgenden Verzeichnis aufrufen: 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 gibt den Pfad der neu wiederhergestellten Datei an (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.

  

Aufzeichnungsintegritä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 erfolgreich überein.

  

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

  

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