Input, output, and user feedback parameters

Subparameter

Description

-i <input_filename>

This subparameter specifies the name of an input file. The file type of the input file is .csv. You can use an input file to specify the parameters and values that you want the tool to use when it runs a command.

You can use an input file for any parameter that has command line options. Using an input file allows you to execute a command for several specified user accounts or server instances, instead of manually running a command for a single user or server instance at a time.

The first line of the input file is a comma-separated list of options that the columns represent. This list can be any non-empty subset of valid options in any order.

For Boolean options, such as -wrandom, a column value of 0 or FALSE (not case-sensitive) turns off the option. All other values, including the empty value, turn on the option.

Example

besuseradminclient -username admin -password password -add -i MyInputFile.csv

MyInputFile.csv contains the following information:

-b,-u,-group,-wrandom

BES1,USER1,GROUP1,0

BES1,USER2,GROUP1,false

BES1,USER3,GROUP1,FALSE

BES1,USER4,GROUP2

BES1,USER5,GROUP2,

BES1,USER6,GROUP2,1

BES1,USER7,GROUP2,true

BES1,USER8,GROUP2,TRUE

BES1,USER9,GROUP2,anything

In this example, the following results occur:

  • Users 1 to 3 are added to BES1 and assigned to GROUP1. An activation password is not generated and sent to the users (-wrandom set to 0 or false).
  • Users 4 to 9 are added to BES1 and assigned to GROUP2. An activation password is generated and sent to the users.

-o <output_filename>

This subparameter specifies the name of the output file that the tool generates.

-v <level>

This subparameter provides detailed or verbose feedback for the options that you specified, depending on the level set. The <level> can be one of the following:
  • TRACE: This level shows all method entries, arguments, return values, and exits, as well as messages of earlier levels.
  • DEBUG: This level displays messages about logical blocks within methods, as well as messages of earlier levels.
  • INFO: This level displays normal feedback messages to the user, as well as messages of earlier levels.
  • WARNING: This level displays exception messages, as well as messages of earlier levels.
  • ERROR: This level is not currently used.
  • FATAL: This level is not currently used.


Was this information helpful? Send us your comments.