Unsupported content

 

This version of the documentation is no longer supported. However, the documentation is available for your convenience. You will not be able to leave comments.

Add NSH Script - Script Options

<[^>]+?>","")"/>

<[^>]+?>","")" class="contextID">

The Script Options panel lets you provide identifying information for the Network Shell script. You can specify whether a script executes repeatedly, each time against a separate host, or the script executes once against multiple hosts. You can also specify that a script use the Perl interpreter.

Field definitions

Name

Identifying name

Description

Optional descriptive text

Save in

Folder where you want to store this object.

File location

Full path to the script (including host name for remote locations)

File encoding

Type of character encoding that is used for the script, such as UTF8 or UTF16

Script type

  • Execute the script separately against each host — The script executes repeatedly from the Application Server, each time running on a different server. This option uses the Network Shell runscript program, which can run the same script on multiple machines. The script uses environment variables local to the Application Server.
  • Execute the script once, passing the host list as a parameter to the script — The script executes once against many servers. If you select this option, you must create a parameter that has a default value of %h or %f. When you execute the script, the %h macro is replaced by a space-delimited list of host names. The %f macro is replaced by a file containing a list of host names. The script uses environment variables local to the Application Server.
  • Copy and execute the script against each host separately — The script is repeatedly copied to different servers and then executed on each of those servers. The script uses environment variables local to the server where the script is executed. After execution, the script is deleted. Use this option for scripts that do not use Network Shell.
  • Execute the script using the PERL interpreter, passing the host list as a parameter to the script — The script executes using the Perl interpreter. If you select this option, you must create a parameter that has a default value of %h or %f. When you execute the script, the %h macro is replaced by a space-delimited list of host names. The %f macro is replaced by a file containing a list of host names.

Note

If you define a script to use either of the first two options and you want to grant permission to run the script on Windows target servers by means of Windows user mapping, the appserver_protocol setting in the Application Server's secure file must be set to ssoproxy. For more information about Windows user mapping, see Creating automation principals. For more information about setting up a secure file, see Secure file overview.

Was this page helpful? Yes No Submitting... Thank you

Comments