Open navigation

Configuring the Admin app

Opening the Admin app

Pre-defined actions

Defining roles (Delegation)

Entering print server and admin account

Entering print servers in the queries

Entering admin account under Credentials

Using Actions

Setting parameters

Delegate action

Changing other settings (optional)

Executing an action

Available scripts/cmdlets

Further options

Queries

Targets

Credentials

Automation

Settings



Opening the Admin app

  • Open the Admin app in a web browser via the link http://<fqdn-scriptrunner-server>/ScriptRunner/admin.
  • Log in, using the login credentials you created during the ScriptRunner installation.

Configuring the Admin app of ScriptRunner for ThinPrint: signing in

There are a variety of features available to you in the Admin app. The following describes the most important features for use with ThinPrint. You can find more information in the ScriptRunner online help. Open the help via the action bar (arrow).

Note! In the first version of the Admin app for ScriptRunner for ThinPrint, when the language is changed to German, only the ScriptRunner-components are translated into German. The ThinPrint components, such as the names of the actions and the descriptions within the actions for example, are in English. When you switch to German in the Delegation app, however, all components are displayed in German.

Configuring the Admin app of ScriptRunner for ThinPrint: Dashboard

Configuring ScriptRunner for ThinPrint is carried out in basically three steps (described below):

  1. Setting the roles for users or groups (Delegation).
  2. Entering the print servers (agents) and adding the credentials of an admin account that has access to the print servers.
  3. Creating actions for these users or groups (Actions).

You will find an overview of all predefined actions (below). Depending on the purchased package, you can also create your own actions. There are a range of scripts available for this purpose. You can also use your own scripts. You will also get a short overview of further options.


Pre-defined actions

In the 30-day trial version, all 15 actions are available to you. Afterwards, the number of promotions depends on the bundle purchased:

  • bundle: actions 1-5
  • bundle: actions 1-10
  • bundle: actions 1-15

Available actions:

  1. Create new printer(s)
  2. Enable driver free printing (V-Layer)
  3. Disable driver free printing (V-Layer)
  4. Remove printer(s)
  5. Create new ThinPrint Port(s)
  6. Install new driver
  7. Create printers via CSV file
  8. Change printer properties
  9. Remove print job
  10. Free Action
  11. Query number of print jobs
  12. Query number of printers
  13. Free Action
  14. Free Action
  15. Free Action


Defining roles (Delegation)

First add service desk users, end users, administrator groups or individual administrators to the console. This will let you set the permissions for the individual users or groups later in the Actions.

  • In the left column, select the menu item Delegation.
  • Then click on Create in the action bar (arrow).

Configuring the Admin app of ScriptRunner for ThinPrint: Delegation

  • Now select the desired role.

Configuring the Admin app of ScriptRunner for ThinPrint: selecting a Role

  • Assign a display name. You can also add a description and select a group color.

Configuring the Admin app of ScriptRunner for ThinPrint: group or account properties

  • Now select the authorization method (for example Active Directory) and enter the name of the AD group and the domain. Now click on Verify and then on OK.

Configuring the Admin app of ScriptRunner for ThinPrint: assigning authorized group or account

You will now find the newly created role in the overview. 

Configuring the Admin app of ScriptRunner for ThinPrint: Delegation

You can then later select the admin group in an action that you want to delegate to that group.


Entering print server and admin account

Entering print servers in the queries

Next enter your print server(s) (Agent(s)) in the preinstalled ThinPrint Server. This query is a component of all preinstalled actions

  • In the left column, select the menu item Queries.
  • Now select the query ThinPrint Server (upper arrow).
  • Then click on Edit in the action bar (lower arrow).

Configuring the Admin app of ScriptRunner for ThinPrint: Queries

  • Enter the server addresses of the print servers into the list. To do so, change the existing entries (upper arrow) and, if needed, click on the plus button to insert further entries (lower arrow).

Configuring the Admin app of ScriptRunner for ThinPrint: listing Query entries


Entering admin account under Credentials

This account is required to access the ScriptRunner server and print server(s) when you delegate the action to other users/admins.

  • In the left column, select the menu item Credentials.
  • Select the ThinPrint Account (upper arrow) and then click on Edit (lower arrow).

Configuring the Admin app of ScriptRunner for ThinPrint: Credentials

  • Now enter the login data for an account that has at least local Admin rights on the Scriptrunner server, as well as local Admin rights on the print servers (arrow).

Configuring the Admin app of ScriptRunner for ThinPrint: credential properties


Using Actions

  • Select the menu item Actions in the left column.
  • Now select one of the preinstalled actions (upper arrow) and then click on Edit in the action bar (lower arrow).

For the following example, the action Remove printer(s) has been selected.

Configuring the Admin app of ScriptRunner for ThinPrint: using Actions

Edit the action as follows: 


Setting parameters

Note! The preinstalled actions are set up in such a way that they are ready to with no further configuration. Only the server name (FQDN) of the server on which ScriptRunner was installed needs to be entered. Additionally, for the Add printer action, a template server can optionally be added.

Configuring the Admin app of ScriptRunner for ThinPrint: parameter values

The default values can be changed if required:

  • If certain parameters ought not to be altered later by the user/admin, check the checkbox Do not display parameters on the input form. These parameters will then be grayed out for the user/admin (upper arrow).
  • Some parameters are linked to a Query. For example, all preinstalled actions contain a Query with the list of all ThinPrint servers. Therefore, the ThinPrint servers must be entered in the query beforehand (see Entering print server and admin account, above). Then the user/admin can select a server from the list later in the Delegation App.
  • If you create actions yourself and want to link them to a query, click on the orange icon (middle arrow). The desired query element can then be selected from the list.
  • You can then additionally specify whether the user/admin is permitted to edit the selected values (lower arrow).

Configuring the Admin app of ScriptRunner for ThinPrint:  assigning parameter values


Delegate action

In addition to the parameters in an action, it must at least be specified to whom the action should be delegated. To do this, switch to the last window inside an action (arrow).

Configuring the Admin app of ScriptRunner for ThinPrint: selecting Delegate Action

  • Select here which users/admins should use the script (lower arrow). Users/admins must have been added beforehand under Delegation.
  • Place a cross in the checkbox For this action at start up, if the user/admin should enter a reason for the script to be run (upper arrow).
  • Specify a tab and a color (middle arrow) for the display in the user portal.

Configuring the Admin app of ScriptRunner for ThinPrint: delegating an Action


Changing other settings (optional)

In the first window you can change the display name of the action, create and/or add tags and add a description.

Configuring the Admin app of ScriptRunner for ThinPrint: Action properties

  • No changes need to be made in the Target window (see below). The predefined Local ThinPrint Host can be used here.

Configuring the Admin app of ScriptRunner for ThinPrint: selecting Targets

For preinstalled actions, such as Remove printer in the example, no changes need to be made to the PowerShell output and execution options. Preinstalled scripts are used here also.

Configuring the Admin app of ScriptRunner for ThinPrint: PowerShell options

 In the next window you can configure the options for results and notifications. 

Configuring the Admin app of ScriptRunner for ThinPrint: setting result options and notifications

  • In the next step, create a schedule for the execution of your script.

Configuring the Admin app of ScriptRunner for ThinPrint: defining a schedule


Executing an action

If a fully configured action is to be executed by a user/admin who is specified in the action to do so (see above), the Delegate app must be used.

If you want to execute the action yourself, highlight the action in the overview (upper arrow) and then click on Execute in action bar (lower arrow).

Configuring the Admin app of ScriptRunner for ThinPrint: Actions


Available scripts/cmdlets

The following will give you an overview of all the available scripts. The scripts are available in both German and English. You can use these scripts to create your own actions.

The scripts are located on your server under C:\ProgramData\ScriptRunner\ScriptMgr. This path is also displayed in the settings. You can also store other scripts there.

Skript nameDescription
Add-TPDriverAdding printer drivers
Add-TPPrinterAdding printer objects
Add-TPPrinterViaFileAdding printer objects via CSV file
Disable-TPVLayerDisable V-Layer
Enable-TPVLayerEnable V-Layer
Get-TPPrinterCountGet the number of printers
Get-TPPrintJobCountGet the number of print jobs
Remove-TPPrintersRemoving printer objects
Remove-TPPrintJobRemoving print jobs
Set-TPPrinterPropertySetting printer properties
QUY_Get-NoVLayerPrintersMultiplePS.ps1Query the non-V-Layer printers from different print servers
QUY_Get-PrtMPrinterDrivers.ps1

Query the printer drivers

QUY_Get-PrtMPrinterDriversMultiplePS.ps1Query the printer drivers from different print servers
QUY_Get-PrtMPrinters.ps1Query the printer objects
QUY_Get-PrtMPrintersMultiplePS.ps1Query the printer objects from different print servers
QUY_Get-PrtMPrintJobs.ps1Query the print jobs
QUY_Get-TPOGPrintersMultiplePS.ps1Query the TPOG printer from different print servers
QUY_Get-TPPrinterPortsMultiplePS.ps1Query the ThinPrint printer ports from different print servers

Furthermore you will find some library scripts here.


Further options

There are a range of further options available, which are described briefly in the following. You can find more information on these in the ScriptRunner help. Open the help with the button in the action bar. 


Queries

  • In the left column, select the menu item Queries.

A description of how to edit the preconfigured query ThinPrint Servers can be found in the Entering print server and admin account section (above). For all other preinstalled queries, no changes need to be made. The queries are part of the pre-installed actions.

Configuring the Admin app of ScriptRunner for ThinPrint: Queries

In the Remove printer(s) action used in our example, the parameter $PrinterName is also provided with a preinstalled Query. This query retrieves all the printer objects present on the print server (Agent) and lists them. Thus, the user/admin can later select and delete the printer objects from the list. 

Configuring the Admin app of ScriptRunner for ThinPrint: assigning parameter values


Targets

The target systems have already been preconfigured. No changes need to be made here. Always use the Local ThinPrint Host in your Actions (upper arrow). If required, you can change the credentials for direct, local execution on the ScriptRunner server.

  • To do this, click on Edit in the action bar (lower arrow).

Configuring the Admin app of ScriptRunner for ThinPrint: Targets

  • Overwrite the default value if required (arrow).

Configuring the Admin app of ScriptRunner for ThinPrint: target properties


Credentials

Here you can edit the login data for ScriptRunner for ThinPrint and create additional accounts. You will find a description of how to edit the preconfigured ThinPrint Account here. in the Entering print server and admin account section (above).

  • You can also click on Create in the action bar to create a new account.
  • Then specify a display name and enter a user name and password.

Configuring the Admin app of ScriptRunner for ThinPrint: Credentials


Automation

This option is not required for preinstalled actions.


Settings

Configuring the Admin app of ScriptRunner for ThinPrint: further settings

You will get an overview here of your license status, tag settings and the path to the ScriptRunner library. You can also store your internal support information here. This information is displayed as support data to the users of the Delegate app.

Did you find it helpful? Yes No

Send feedback
Sorry we couldn't be helpful. Help us improve this article with your feedback.