<!--Arbortext, Inc., 1988-2007, v.4002-->
<!DOCTYPE REFENTRY PUBLIC "-//Sun Microsystems//DTD SolBook 3.5//EN" [
<!ENTITY options-common SYSTEM "options-common.sgm">
<!ENTITY synopsis-common SYSTEM "synopsis-common.sgm">
<!ENTITY % commonents SYSTEM "common.ent">
%commonents;
]>
<refentry id="create-password-alias-1">
<!-- @(#)create-password-alias.1 1.9 07/04/25 SMI; -->
<refmeta><refentrytitle>create-password-alias</refentrytitle><manvolnum>1
</manvolnum>
<refmiscinfo class="date">30 Jan 2007</refmiscinfo>
<refmiscinfo class="sectdesc">&man1
;</refmiscinfo>
<refmiscinfo class="software">&software;</refmiscinfo>
<refmiscinfo class="arch">generic</refmiscinfo>
<refmiscinfo class="copyright">Copyright (c) 2007, Sun Microsystems, Inc.
All Rights Reserved</refmiscinfo>

</refmeta>
<refnamediv><indexterm><primary>create-password-alias</primary></indexterm><indexterm><primary>
creates a password alias</primary></indexterm>
<refname>create-password-alias</refname><refpurpose>creates a password alias
</refpurpose></refnamediv>
<refsynopsisdiv><title></title>
<synopsis><command>create-password-alias</command> &synopsis-common; <replaceable>aliasname</replaceable></synopsis></refsynopsisdiv>
<refsect1 role="description"><title></title>
<para>This command creates an alias for  password so that this can be used  in domain.xml, inplace of providing actual password in <filename>
domain.xml</filename>. An alias is a token of the form <literal>${ALIAS=password-alias-password}
</literal>. The password corresponding to the alias name is stored in an encrypted
form. The <command>create-password-alias</command> command takes both a secure
interactive form (in which the user is prompted for all information) and a
more script-friendly form, in which the password is propagated on the command
line.</para>
<para>This command is supported in remote mode only.</para>
</refsect1>
<refsect1 role="options"><title></title>
<variablelist termlength="medium">&options-common;
</variablelist></refsect1>
<refsect1 role="operands"><title></title>
<variablelist termlength="medium">
<varlistentry><term><option>aliasname</option></term><listitem>
<para>The name of the alias password as it appears in <filename>domain.xml
</filename> file.</para>
</listitem></varlistentry>
</variablelist></refsect1>
<refsect1 role="examples"><title></title>
<example>
<title>Using create-password-alias command in interactive mode</title>
<screen>asadmin> <userinput>create-password-alias --user admin --passwordfile /home/password.txt 
--interactive=true jmspassword-alias</userinput>
Please enter the alias password>
Please enter the alias password again>
Command create-password-alias executed successfully.</screen>
</example>
</refsect1>
<refsect1 role="exit-status"><title></title>
<variablelist termlength="narrow">
<varlistentry><term>0</term><listitem><para>command executed successfully
</para>
</listitem></varlistentry>
<varlistentry><term>1</term><listitem><para>error in executing the command
</para>
</listitem></varlistentry>
</variablelist></refsect1>
<refsect1 role="see-also"><title></title>
<para><olink targetdoc="ASREFMAN" targetptr="delete-password-alias-1">delete-password-alias(1)</olink>, <olink targetdoc="ASREFMAN" targetptr="list-password-aliases-1">list-password-aliases(1)</olink>, <olink targetdoc="ASREFMAN" targetptr="update-password-alias-1">update-password-alias(1)</olink></para>
</refsect1>
</refentry>
<?Pub *0000003682>
