55/461

## create-password-alias

creates a password alias

Synopsis

    create-password-alias [--help]
    aliasname

Description

The `create-password-alias` subcommand creates an alias for a password. An alias is a token of the form `${ALIAS=aliasname}`. The password that corresponds to the alias name is stored in an encrypted form.

The `create-password-alias` subcommand can be run interactively or noninteractively.

- When run interactively, the subcommand prompts the user for the alias password and to confirm the alias password.

- When run noninteractively, the subcommand reads the alias password from a file that is passed through the `--passwordfile` option of the asadmin(1M) utility. The file must contain an entry of the form `AS_ADMIN_ALIASPASSWORD=`alias-password, where alias-password is the alias password. The noninteractive form of this command is suitable for use in scripts.

This subcommand is supported in remote mode only.

Options

`--help`
`-?`

  Displays the help text for the subcommand.

Operands

aliasname

  Your choice of name for the password alias.

Examples

Example 1 Creating a Password Alias Interactively

  This example creates the password alias `jmspassword-alias` interactively.

      asadmin> create-password-alias jmspassword-alias
      Enter the alias password>
      Enter the alias password again>
      Command create-password-alias executed successfully.

Example 2 Creating a Password Alias Noninteractively

  This example uses the `--passwordfile` option of the `asadmin` utility to create the password alias `winuser` noninteractively.

      $ asadmin --passwordfile aspwfile.txt create-password-alias winuser
      Command create-password-alias executed successfully.

  The file `aspwfile.txt` contains the following entry to specify the alias password:

      AS_ADMIN_ALIASPASSWORD=sp@rky

Exit Status

0

  command executed successfully

1

  error in executing the command

See Also

delete-password-alias(1), list-password-aliases(1), update-password-alias(1)

asadmin(1M)