Canned scripts

What are canned scripts?

Canned scripts are custom scripts created to be used in screen sharing and command shell sessions. These scripts are displayed in the interface as they are executed, running in the context of the logged-in user or the local system, depending on session elevation.

How are canned scripts useful?

Canned scripts allow representatives to automate tasks during remote sessions, enhancing efficiency and consistency. By running predefined scripts during screen sharing or command shell sessions, users can streamline troubleshooting or configuration tasks, while the scripts maintain proper context based on session elevation.

How do I access the Canned Scripts page?

1. Use a Chromium-based browser to sign in to your Privileged Remote Access URL.
   This URL is provided in the BeyondTrust welcome email and includes your site URL followed by /login.
2. From the left menu, click Console Settings.
   The Rep Console Settings page opens and displays by default.
3. At the top of the page, click Canned Scripts.
   The Canned Scripts page displays.

Team availability and categories filters

Filter your view by selecting a team or category from the dropdown lists.

Add new canned script, edit, delete

Create a new script, modify an existing script, or remove an existing script.

Add or edit canned script

Script name

Create a unique name to help identify this script. This name should help users locate the script they wish to run.

Description

Add a brief description to summarize the purpose of this script. This description is displayed on the prompt to confirm that the user wants to run the selected script.

Command sequence

Write the command sequence. Scripts must be written in command line format, similar to writing a batch file or shell script. Note that only the last line of the script may be interactive; you cannot prompt for input in the middle of the script.

Within the script, reference an associated resource file using "%RESOURCE_FILE%", making sure to include the quotation marks. Please note that the command sequence is case sensitive.

You can access the resource file's temporary directory using %RESOURCE_DIR%. When you run a script with an associated resource file, that file will be temporarily uploaded to the customer's computer.

Team availability

Select which teams should be able to use this item.

Categories

Select the category under which this item should be listed.

Resource file

You may select a resource file to be associated with this script.

Categories

Add category, delete

Create a new category or remove an existing category.

Resources

Choose and upload resource

Add any resource files you want to access from within your scripts. You may upload up to 100 MB to your resource file directory.

If you upload a resource file with the same name as an existing resource file, there is a prompt to confirm replacing the file.

• If you click YES, the updated resource file is uploaded and used for all applicable canned scripts.
• If you click NO, the file is not uploaded.

Delete

Remove an existing resource file.