Druckserver und Admin-Konto eintragen
Druckserver in den Queries eintragen
Admin-Konto unter Credentials eintragen
Weitere Einstellungen ändern (optional)
Administrative Konten/Credentials
Admin-App öffnen
- Öffnen Sie die Admin-App über den Link http://<fqdn-scriptrunner-server>/ScriptRunner/admin in einem Web-Browser.
- Melden Sie sich mit den Zugangsdaten an, die sie während der Installation von ScriptRunner angelegt haben.
In der Admin-App stehen Ihnen eine Vielzahl von Funktionen zur Verfügung. Im Folgenden werden die, für die Nutzung mit ThinPrint wichtigsten Funktionen beschrieben. Weitere Informationen finden Sie in der Online-Hilfe von ScriptRunner. Öffnen Sie die Hilfe über die Aktionsleiste (unterer Pfeil).
Hinweis! In der ersten Version von ScriptRunner for ThinPrint werden in der Admin-App, bei der Umstellung der Sprache auf Deutsch (oberer Pfeil) nur die ScriptRunner-Komponenten ins Deutsche übersetzt. Die ThinPrint-Komponenten, also beispielsweise die Namen der Aktionen und die Beschreibungen innerhalb der Aktionen bleiben Englisch. In der Delegation-App werden hingegen sämtliche Komponenten beim Wechsel auf Deutsch in deutscher Sprache dargestellt.
Die Konfiguration von ScriptRunner for ThinPrint erfolgt im Wesentlichen in drei (weiter unten beschriebenen) Schritten:
- Das Festlegen von Rollen für Anwender bzw. Gruppen (Delegation).
- Das Eintragen der Druckserver (Agents) und das Hinzufügen der Zugangsdaten eines Admin-Kontos, dass Zugriff auf die Druckserver hat.
- Das Erstellen von Aktionen für diese Anwender bzw. Gruppen (Actions).
Eine Übersicht über alle vordefinierten Aktionen finden Sie ebenalls weiter unten. Abhängig vom gekauften Paket, können Sie auch eigene Aktionen erstellen. Hierfür stehen Ihnen eine Reihe von Skripten zur Verfügung. Sie können auch eigene Skripte verwenden. Außerdem erhalten Sie einen kurzen Überblick über weitere Optionen.
Vordefinierte Aktionen
In der 30tägigen Testversion stehen Ihnen alle 15 Aktionen zur Verfügung. Anschließend ist die Anzahl der Aktionen abhängig vom gekauften Paket:
- 1. Paket: Aktionen 1-5
- 2. Paket: Aktionen 1-10
- 3. Paket: Aktionen 1-15
Name der Aktion | Beschreibung |
01_Create new printer(s) | Anlegen von Druckerobjekten |
02_Enable driver free printing (V-Layer) | V-Layer aktivieren |
03_Disable driver free printing (V-Layer) | V-Layer deaktivieren |
04_Remove printer(s) | Löschen von Druckerobjeken |
05_Create new ThinPrint Port(s) | Anlegen neuer ThinPrint-Ports |
06_Install new driver | Installation neuer Druckertreiber |
07_Create printers via CSV file | Hinzufügen von Druckerobjekten via CSV-Datei |
08_Change printer properties | Ändern von Druckereigenschaften |
09_Remove print job | Entfernen von Druckaufträgen |
10_Free Action | Neue, eigene Aktion kann erstellt werden |
11_Query number of print jobs | Abfrage der Anzahl von Druckeraufträgen |
12_Query number of printers | Abfrage der Anzahl von Druckern |
13_Free Action | Neue, eigene Aktion kann erstellt werden |
14_Free Action | Neue, eigene Aktion kann erstellt werden |
15_Free Action | Neue, eigene Aktion kann erstellt werden |
Rollen festlegen (Delegation)
Fügen Sie zuerst Service-Desk-Anwender, Endanwender, Administrator-Gruppen bzw. einzelne Administratoren in der Konsole hinzu. So können Sie die Berechtigungen für die einzelnen Anwender bzw. Gruppen später in den Aktionen (Actions) festlegen.
- Wählen Sie in der linken Spalte den Menüpunkt Delegation.
- Klicken Sie danach in der Aktionsleiste auf Create (Pfeil).
- Wählen Sie jetzt die gewünschte Rolle aus (Beispiel im Screenshot).
- Vergeben Sie einen Anzeigenamen. Außerdem können Sie eine Beschreibung hinzufügen und eine Gruppenfarbe auswählen.
- Wählen Sie jetzt die Autorisierungsmethode aus (zum Beispiel Active Directory) und geben Sie dann den Namen der AD-Gruppe und der Domäne ein (linke Pfeile). Klicken Sie anschließend auf Validate (rechter Pfeil) und danach auf OK.
Sie finden die neu angelegte Rolle jetzt in der Übersicht.
Sie können die Admin-Gruppe dann später in einer Aktion auswählen, die Sie an diese Gruppe delegieren wollen.
Druckserver und Admin-Konto eintragen
Druckserver in die Queries eintragen
Tragen Sie als nächstes Ihre/n Druckserver (Agent/s) in die vorinstallierte Query ThinPrint Server ein. Diese Query ist Bestandteil aller vorinstallierten Aktionen.
- Wählen Sie in der linken Spalte den Menüpunkt Queries.
- Wählen Sie jetzt die Query ThinPrint Server aus (oberer Pfeil).
- Klicken Sie dann in der Aktionsleiste auf Edit (unterer Pfeil).
- Tragen Sie die Serveradressen der Druckserver in die Liste ein. Ändern Sie dafür die vorhandenen Einträge (oberer Pfeil) und fügen Sie mit Klick auf den Plus-Button ggf. weitere Einträge hinzu (unterer Pfeil).
Admin-Konto unter Credentials eintragen
Dieser Account wird benötigt, um auf den ScriptRunner-Server und den/die Druckserver zuzugreifen, wenn Sie die Aktion an andere Anwender/Admins delegieren.
- Wählen Sie in der linken Spalte den Menüpunkt Credentials.
- Wählen Sie den ThinPrint Account aus (oberer Pfeil) und klicken Sie anschließend auf Edit (unterer Pfeil).
- Geben Sie jetzt die Zugangsdaten von einem Account ein, der mindestens lokale Adminrechte auf dem Scriptrunner-Server, sowie lokale Adminrechte auf den Druckservern hat (siehe Pfeile).
Aktionen verwenden (Actions)
- Wählen Sie in der linken Spalte den Menüpunkt Actions.
- Wählen Sie jetzt eine der vorinstallierten Aktionen (oberer Pfeil) aus und klicken danach in der Aktionsleiste auf Edit (unterer Pfeil).
Für das folgende Beispiel wurde die Aktion Remove printer(s) ausgewählt.
Gehen Sie bei der Bearbeitung der Aktion folgendermaßen vor:
Parameter festlegen
Hinweis! Die vorinstallierten Aktionen sind so aufgebaut, dass sie ohne weitere Konfiguration verwendet werden können. Es muss lediglich der Servername (FQDN) von dem Server eingetragen werden, auf dem ScriptRunner installiert wurde (unterer Pfeil). Bei der Aktion Create new printer(s) kann außerdem optional ein Template-Server eingetragen werden.
Die voreingestellten Werte können bei Bedarf geändert werden:
- Wenn durch den Anwender/Admin später keine Änderungen an bestimmten Parametern vorgenommen werden sollen, aktivieren Sie jeweils die Checkbox Hide parameter from input form. Für den Anwender/Admin werden diese Parameter dann ausgeblendet (oberer Pfeil).
- Einige Parameter sind mit einer Query verknüpft. Alle vorinstallierten Aktionen beinhalten beispielsweise eine Query mit der Liste aller ThinPrint-Server. Die ThinPrint-Server müssen dafür zuvor in der Abfrage (Query) eingetragen worden sein (s. o. den Abschnitt Druckserver und Admin-Konto eintragen). Der Anwender/Admin kann dann später in der Delegate-App einen Server aus der Liste auswählen.
- Wenn Sie selbst Aktionen erstellen und diese mit einer Abfrage verknüpfen möchten, klicken Sie auf das orangene Icon (mittlerer Pfeil). Das gewünschte Abfrage-Element kann dann anschließend aus der Liste ausgewählt werden.
- Für den Anwender/Admin können Sie außerdem festlegen, ob dieser den ausgewählten Wert editieren darf (unterer Pfeil).
Aktion delegieren
Neben den Parametern muss in einer Aktion mindestens noch festgelegt werden, an wen die Aktion delegiert werden soll. Wechseln Sie dafür innerhalb einer Aktion in das letzte Fenster (siehe Pfeil).
- Wählen Sie hier aus, welche Anwender/Admins das Skript verwenden sollen (unterer Pfeil). Anwender/Admin müssen zuvor unter Delegation hinzugefügt worden sein.
- Setzen Sie ein Häkchen in die Checkbox Require the user to fill the 'Reason' field..., wenn der Anwender/Admin einen Grund (Reason) eintragen soll, aus dem das Skript ausgeführt wird (oberer Pfeil).
- Legen Sie einen Tab und eine Farbe (Color) (mittlerer Pfeil) für die Ansicht im Nutzerportal fest.
Weitere Einstellungen ändern (optional)
Im ersten Fenster können Sie den Anzeigenamen der Aktion ändern, Tags erstellen und/oder hinzufügen und eine Beschreibung ergänzen.
- Im Fenster Target (s. u.) müssen keine Änderungen vorgenommen werden. Hier kann der vordefinierte Local ThinPrint Host verwendet werden.
Bei vorinstallierten Aktionen, wie im Beispiel Remove printer(s) müssen an den Ausgabe- und Ausführungsoptionen für PowerShell keine Änderungen vorgenommen werden. Auch an dieser Stelle wird auf bereits vorinstallierte Skripte zurückgegriffen.
Im nächsten Fenster können Sie Optionen für Ergebnisse und Benachrichtigungen konfigurieren.
- Erstellen Sie im nächsten Schritt einen Zeitplan für die Ausführung Ihres Skripts.
Aktion ausführen
Soll die fertig konfigurierte Aktion von einem Anwender/Admin ausgeführt werden, der in der Aktion dafür festgelegt wurde (s. o.), muss dafür die Delegate-App verwendet werden.
Möchten Sie die Aktion selbst ausführen, markieren Sie die Aktion in der Übersicht (oberer Pfeil) und klicken anschließend in der Aktionsleiste auf Run (unterer Pfeil).
Verfügbare Skripte/Cmdlets
Im Folgenden erhalten Sie einen Überblick über alle vorinstallierten Skripte. Die Skripte stehen jeweils in deutscher und englischer Sprache zur Verfügung. Mit Hilfe dieser Skripte können Sie eigene Aktionen erstellen.
Sie finden die Skripte auf Ihrem Server unter C:\ProgramData\ScriptRunner\ScriptMgr. Dieser Pfad ist außerdem in den Einstellungen einsehbar. Dort können Sie auch weitere Skripte ablegen.
Skript-Name | Beschreibung |
Add-TPDriver | Hinzufügen von Druckerteibern |
Add-TPPrinter | Hinzufügen von Druckerobjekten |
Add-TPPrinterViaFile | Hinzufügen von Druckerobjekten via CSV-Datei |
Disable-TPVLayer | V-Layer deaktivieren |
Enable-TPVLayer | V-Layer aktivieren |
Get-TPPrinterCount | Anzahl von Druckern ermitteln |
Get-TPPrintJobCount | Anzahl von Druckeraufträgen ermitteln |
Remove-TPPrinters | Entfernen von Druckerobjeken |
Remove-TPPrintJob | Entfernen von Druckaufträgen |
Set-TPPrinterProperty | Setzen von Druckereigenschaften |
QUY_Get-NoVLayerPrintersMultiplePS.ps1 | Abfrage der Nicht-V-Layer-Drucker von verschiedenen Druckservern |
QUY_Get-PrtMPrinterDrivers.ps1 | Abfrage der Druckertreiber |
QUY_Get-PrtMPrinterDriversMultiplePS.ps1 | Abfrage der Druckertreiber von verschiedenen Druckservern |
QUY_Get-PrtMPrinters.ps1 | Abfrage der Druckerobjekte |
QUY_Get-PrtMPrintersMultiplePS.ps1 | Abfrage der Druckerobjekte von verschiedenen Druckservern |
QUY_Get-PrtMPrintJobs.ps1 | Abfrage der Druckaufträge |
QUY_Get-TPOGPrintersMultiplePS.ps1 | Abfrage der TPOG-Drucker von verschiedenen Druckservern |
QUY_Get-TPPrinterPortsMultiplePS.ps1 | Abfrage der ThinPrint-Druckerports von verschiedenen Druckservern |
Darüberhinaus finden Sie hier noch einige Bibliothekskripte.
Weitere Optionen
Es stehen noch eine Reihe weiterer Optionen zur Verfügung, die im Folgenden nur kurz beschrieben werden. Weiterführende Informationen hierzu finden Sie in der ScriptRunner-Hilfe. Öffnen Sie die Hilfe über den Button in der Aktionsleiste.
Queries
- Wählen Sie in der linken Spalte den Menüpunkt Queries.
Eine Beschreibung, wie Sie die vorkonfigurierte Query ThinPrint Servers bearbeiten, finden Sie im Abschnitt Druckserver und Admin-Konto eintragen (s. o.). An allen anderen vorinstallierten Queries müsse keine Änderungen vorgenommen werden. Die Queries sind Bestandteil der vorinstallierten Aktionen.
In der, in unserem Beispiel verwendeten Aktion Remove printer(s) ist der Parameter $PrinterName mit einer vorinstallierten Query belegt. Diese Abfrage ruft alle, auf dem Druckserver (Agent) vorhandenen Druckerobjekte ab und listet sie auf. So dass der Anwender/Admin später die Druckerobjekte aus der Liste auswählen und löschen kann.
Zielsysteme/Targets
Die Zielsysteme sind bereits vorkonfiguriert. Hier müssen keine Änderungen vorgenommen werden. Verwenden Sie immer den Local ThinPrint Host in Ihren Aktionen (oberer Pfeil). Ändern können Sie ggf. die Zugangsdaten (Credentials) für die direkte, lokale Ausführung auf dem ScriptRunner-Server.
- Klicken Sie hierfür in der Aktionsleiste auf Edit (unterer Pfeil).
- Überschreiben Sie den Default-Wert bei Bedarf (Pfeil).
Administrative Konten/Credentials
Hier können Sie die Zugangsdaten für ScriptRunner for ThinPrint bearbeiten und weitere Accounts erstellen. Eine Beschreibung, wie Sie den vorkonfigurierten ThinPrint Account bearbeiten, finden Sie im Abschnitt Druckserver und Admin-Konto eintragen (s. o.).
- Mit Klick auf Create in der Aktionsleiste, können Sie auch einen neuen Account erstellen.
- Legen Sie danach einen Anzeigenamen fest und geben Sie Benutzername und Passwort ein.
Automation
Diese Option wird für vorinstallierte Aktionen nicht benötigt.
Einstellungen/Settings
Hier erhalten Sie einen Überblick über Ihren Lizenzstatus, Tag-Einstellungen und den Pfad zur ScriptRunner-Bibliothek. Außerdem können Sie Ihre internen Support-Informationen hinterlegen. Diese Informationen werden den Benutzern der Delegate-App als Supportdaten angezeigt.