pf 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. Sign into app.beyondtrust.io.
   The BeyondTrust Home page displays.
2. From the main menu, click Privileged Remote Access > Console Settings.
   The Console Settings page opens and the Access Console Settings tab displays by default.
3. Click the Canned Scripts tab.
   The Canned Scripts tab 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.