The Script library is where you keep the scripts you run on your devices. Upload a .sh, .py or .ps1 script once and run it on any compatible device.

Overview

Supported script types:

Each script is capped at 1 MiB.

How to use

Open the Script library

1. In the Factorial IT console, open Device Management.
2. Select the Scripts tab.
3. Select the Script library sub-tab. Each row shows a script's name, type and actions.

Add a script

1. Click Add a script.
2. Provide the script in one of two ways:
   • Drag and drop a .sh, .py or .ps1 file onto the upload area. The name, platform and contents are filled in for you.
   • Fill in the fields by hand: choose a platform, type a name ending in the right extension, and paste the script into the editor.
3. Click Save.

The Platform selector controls the extension. Changing the platform rewrites the extension in the name. Typing a name that ends in a matching extension changes the platform. Both fields can be edited freely; they only stay linked when the other one leaves no doubt.

Edit a script

1. On the script's row, open the actions menu and select Edit.
2. Change the script in the editor.
3. Click Save. The button stays disabled until you change something.

Only the contents can be edited. The name and platform are locked, because renaming would change the script type. To rename a script or change its type, delete it and create a new one.

Download a script

On the script's row, open the actions menu and select Download. The file keeps its original name and extension.

Delete a script

1. On the script's row, open the actions menu and select Delete.
2. Confirm in the dialogue.

Earlier runs stay in each device's script history, because Factorial IT keeps the name and contents used at the time. Runs that had not finished yet are marked cancelled.

Validation rules

Before saving, Factorial IT checks that:

• The name ends in .sh, .py or .ps1.
• The contents are 1 MiB or less.
• A .py script begins with a python shebang, for example:

  #!/usr/bin/env python3
  print("Hello from Factorial IT")

• A .sh script that declares a shebang uses a supported interpreter, such as #!/bin/bash or #!/usr/bin/env bash.

If a check fails, Save stays disabled and the field at fault explains why.

Permissions

Without the right permission, the action is still shown but disabled, and a tooltip tells you why.

Troubleshooting and FAQ

Troubleshooting

Save is disabled when adding a script. A validation rule failed. Read the message under the field: usually a wrong extension, a missing python shebang, an unsupported shell, or a file over 1 MiB.

Save is disabled when editing a script. You have not changed the contents yet.

I cannot rename a script. Name and platform are locked. Delete the script and add it again with the new name.

An action is greyed out. You are missing MDM_READ or MDM_WRITE. Hover over it to see which.

FAQ

1. Which platforms can run scripts from the library?
   macOS and Linux with .sh and .py, and Windows with .ps1.
    
2. What happens to past runs when I delete a script?
   They stay in each device's script history with the name and contents used at the time. Runs that had not finished are cancelled.
    
3. How big can a script be?
   Up to 1 MiB.
    
4. Can I change a script's platform after saving it?
   No. Delete it and create a new one.