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.

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

• Now select the desired role.

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

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

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

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

• 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).

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

• 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).

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.

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.

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

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

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

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.

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

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.

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

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

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

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.

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.

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. 

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

• Overwrite the default value if required (arrow).

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.

Automation

This option is not required for preinstalled actions.

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.