Konfiguration¶
Das Modul KillSession enthält alle Konfigurationsmöglichkeiten für diese Erweiterung. Unten findest du das vollständige Schema sowie detaillierte Erklärungen zu den einzelnen Werten – inklusive einer Beispielkonfiguration.
Das Konfigurationsschema¶
Module
KillSession
Die Gruppe terminateSession¶
Über die optionale Gruppe terminateSession kannst du das verwendete Kommando zum Beenden einer Session anpassen. Diese Einstellung ist nur in Ausnahmefällen erforderlich.
1<Group name="taskList">
2 <Value name="program">logoff_wrapper.exe</Value>
3 <Value name="arguments">/SERVER:{computer} {sessionId}</Value>
4 <Value name="timeout">600</Value>
5</Group>
Warnung
Änderungen an diesen Einstellungen können zu unerwartetem Verhalten führen. Bitte kontaktiere den EducateIT Support, bevor du die Konfiguration anpasst.
Der Wert program¶
Mit dem optionalen Wert program überschreibst du das Standardkommando. Du kannst entweder einen absoluten Pfad zu einer ausführbaren Datei angeben oder den Programmnamen, sofern dieser im Systempfad (PATH) gefunden wird. Wird kein Wert angegeben, verwendet der Assistent standardmäßig logoff.exe.
1<Group name="taskList">
2 <Value name="program">logoff_wrapper.exe</Value>
3 <Value name="arguments">/SERVER:{computer} {sessionId}</Value>
4</Group>
Der Wert arguments¶
Mit dem optionalen Wert arguments legst du fest, welche Parameter dem Kommando übergeben werden. Ohne Angabe wird automatisch /SERVER:{computer} {sessionId} verwendet.
Du kannst die folgenden Platzhalter nutzen:
{computer}– wird durch den Computernamen oder die IP-Adresse ersetzt{sessionId}– wird durch die numerische Session-ID ersetzt
1<Group name="taskList">
2 <Value name="program">logoff_wrapper.exe</Value>
3 <Value name="arguments">/SERVER:{computer} {sessionId}</Value>
4</Group>
Der Wert timeout¶
Mit dem optionalen Wert timeout legst du fest, wie lange (in Sekunden) das Kommando maximal ausgeführt werden darf. Nach Ablauf der Zeit wird es vom Assistenten beendet. Gültige Werte liegen zwischen 10 und 3600 Sekunden. Standardwert ist 120 Sekunden.
1<Group name="taskList">
2 <Value name="timeout">600</Value>
3</Group>
Die Gruppe listSession¶
Mit der optionalen Gruppe listSession steuerst du, wie der Assistent Informationen über bestehende Sessions auf dem Zielserver abruft. Standardmäßig wird dafür der Windows-Befehl query.exe verwendet.
Du kannst diese Einstellung bei Bedarf anpassen – zum Beispiel, wenn du ein Wrapper-Tool einsetzt oder zusätzliche Parameter übergeben möchtest.
1<Group name="listSession">
2 <Value name="program">query_wrapper.exe</Value>
3 <Value name="arguments">session /SERVER:{computer} {sessionId}</Value>
4</Group>
Warnung
Änderungen an diesen Einstellungen können zu unerwartetem Verhalten führen. Bitte kontaktiere den EducateIT Support, bevor du Anpassungen vornimmst.
Der Wert program¶
Mit dem optionalen Wert program legst du fest, welches Programm zur Abfrage der Session-Informationen verwendet wird. Standardmäßig nutzt der Assistent query.exe.
Du kannst entweder den vollständigen Pfad zu einem ausführbaren Programm angeben oder den Programmnamen, sofern dieser über den Systempfad (PATH) gefunden wird.
1<Group name="listSession">
2 <Value name="program">query_wrapper.exe</Value>
3 <Value name="arguments">session /SERVER:{computer} {sessionId}</Value>
4</Group>
Der Wert arguments¶
Mit dem optionalen Wert arguments definierst du die Argumente, die dem Programm übergeben werden. Wird kein Wert angegeben, verwendet der Assistent standardmäßig session /SERVER:{computer} {sessionId}.
Folgende Platzhalter stehen zur Verfügung:
{computer}– wird durch den Computernamen oder die IP-Adresse ersetzt{sessionId}– wird durch die numerische Session-ID oder den Benutzernamen ersetzt
1<Group name="listSession">
2 <Value name="program">query_wrapper.exe</Value>
3 <Value name="arguments">session /SERVER:{computer} {sessionId}</Value>
4</Group>
Der Wert timeout¶
Mit dem optionalen Wert timeout bestimmst du, wie lange (in Sekunden) das Kommando maximal ausgeführt werden darf. Wird diese Zeit überschritten, beendet der Assistent den Vorgang automatisch. Der Wert muss zwischen 10 und 3600 Sekunden liegen. Standardmäßig gilt ein Timeout von 120 Sekunden.
1<Group name="listSession">
2 <Value name="timeout">600</Value>
3</Group>
Der Wert sessionLogOffTimeOut¶
Mit dem Wert sessionLogOffTimeOut legst du das Zeitlimit in Sekunden fest, innerhalb dessen eine Sitzung nach dem Abmeldebefehl als beendet gelten muss. Wird dieses Zeitlimit überschritten, zeigt der Assistent eine Fehlermeldung an und beendet den Vorgang mit einem Fehlerstatus.
Standardmäßig beträgt das Zeitlimit 120 Sekunden. Der Mindestwert liegt bei 60 Sekunden.
<Module name="KillSession">
<Value name="sessionLogOffTimeOut">600</Value>
</Module>
Beispielkonfiguration¶
Die folgende Konfiguration zeigt das Minimalbeispiel für das Modul KillSession – ohne zusätzliche Anpassungen. In diesem Fall werden alle Standardwerte verwendet.
KillSession¶<?xml version="1.0" encoding="UTF-8" ?>
<Configuration
version="1"
xmlns="http://educateit.ch/software/BlueStone/Configuration/1">
<Module name="KillSession">
</Module>
</Configuration>
