---
title: Manage scripts (ssoadm)
description: Use the ssoadm command's create-sub-cfg, get-sub-cfg, and delete-sub-cfg subcommands to manage AM scripts.
component: pingam
version: 8
page_id: pingam:am-scripting:manage-scripts-cli
canonical_url: https://docs.pingidentity.com/pingam/8/am-scripting/manage-scripts-cli.html
keywords: ["Scripts", "CLI (command line interface)"]
page_aliases: ["scripting-guide:manage-scripts-cli.adoc"]
---

# Manage scripts (ssoadm)

Use the `ssoadm` command's `create-sub-cfg`, `get-sub-cfg`, and `delete-sub-cfg` subcommands to manage AM scripts.

Create an AM script as follows:

1. Create a script configuration file, for example, `/path/to/myScriptConfigurationFile.txt`, containing the following:

   ```properties
   script-file=/path/to/myScriptFile.js
   language=JAVASCRIPT (1)
   name=My New Script
   context=AUTHENTICATION_TREE_DECISION_NODE (2)
   ```

   |       |                                                                                                                   |
   | ----- | ----------------------------------------------------------------------------------------------------------------- |
   | **1** | Specify either `JAVASCRIPT` or `GROOVY` as the script language.                                                   |
   | **2** | Specify a script context from one of the [supported contexts](manage-scripts-rest.html#supported-context-values). |

2. Run the `ssoadm create-sub-cfg` command.

   The `--datafile` argument references the script configuration file you created in the previous step:

   ```bash
   $ ssoadm \
   create-sub-cfg \
   --realm /myRealm \
   --adminid uid=amAdmin,ou=People,dc=am,dc=example,dc=com \
   --password-file /tmp/pwd.txt \
   --servicename ScriptingService \
   --subconfigname scriptConfigurations/scriptConfiguration \
   --subconfigid myScriptID \
   --datafile /path/to/myScriptConfigurationFile.txt
   Sub Configuration scriptConfigurations/scriptConfiguration was added to realm /myRealm
   ```

   To list the properties of a script, run the `ssoadm get-sub-cfg` command:

   ```bash
   $ ssoadm \
   get-sub-cfg \
   --realm /myRealm \
   --adminid uid=amAdmin,ou=People,dc=am,dc=example,dc=com \
   --password-file /tmp/pwd.txt \
   --servicename ScriptingService \
   --subconfigname scriptConfigurations/myScriptID
   createdBy=
   lastModifiedDate=
   lastModifiedBy=
   name=My New Script
   context=AUTHENTICATION_SERVER_SIDE
   description=
   language=JAVASCRIPT
   creationDate=
   script=…​Script output follows…​
   ```

   To delete a script, run the `ssoadm delete-sub-cfg` command:

   ```bash
   $ ssoadm \
   delete-sub-cfg \
   --realm /myRealm \
   --adminid uid=amAdmin,ou=People,dc=am,dc=example,dc=com \
   --password-file /tmp/pwd.txt \
   --servicename ScriptingService \
   --subconfigname scriptConfigurations/myScriptID
   Sub Configuration scriptConfigurations/myScriptID was deleted from realm /myRealm
   ```