<!DOCTYPE REFENTRY PUBLIC "-//Sun Microsystems//DTD DocBook V3.0-Based SolBook Subset V2.0//EN" [
<!--ArborText, Inc., 1988-1999, v.4002-->
<!ENTITY metainfo SYSTEM "metainfo.sgm">
<!ENTITY options-common SYSTEM "options-common.sgm">
<!ENTITY synopsis-common SYSTEM "synopsis-common.sgm">
<!ENTITY % commonents SYSTEM "smancommon.ent">
%commonents;
<!ENTITY % booktitles SYSTEM "booktitles.ent">
%booktitles;
<!ENTITY Dash "&ndash;">
]>
<?Pub UDT _bookmark _target>
<?Pub EntList brvbar bull cross dash diam diams frac12 frac13 frac14 hellip
 laquo lArr loz mdash nabla ndash para pound rArr raquo sect yen ne>
<?Pub Inc>
<refentry id="update-password-alias-1">
<refmeta><refentrytitle>update-password-alias</refentrytitle><manvolnum>1
</manvolnum>&metainfo;
</refmeta>
<refnamediv><indexterm><primary sortas="update-password-alias">update-password-alias &mdash;
updates a password alias</primary></indexterm><indexterm><primary sortas="updates a password alias">
updates a password alias &mdash; update-password-alias</primary></indexterm>
<refname>update-password-alias</refname><refpurpose>updates a password alias
</refpurpose></refnamediv>
<refsynopsisdiv><title>&synp-tt;</title>
<cmdsynopsis><command>update-password-alias</command>&synopsis-common;
<arg choice="plain"><replaceable>aliasname</replaceable></arg>
</cmdsynopsis></refsynopsisdiv>
<refsect1><title>&desc-tt;</title>
<para>This command updates the password alias IDs in the named target. An
alias is a token of the form <literal>${ALIAS=passowrd-alias-password}</literal>.
The password corresponding to the alias name is stored in an encrypted form.
The <command>update-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><title>&opts-tt;</title>
<variablelist termlength="medium">&options-common;
</variablelist><?Pub Caret1></refsect1>
<refsect1><title>OPERANDS</title>
<variablelist termlength="medium">
<varlistentry><term><option role="nodash">aliasname</option></term><listitem>
<para>This is the name of the password as it appears in <filename>domain.xml
</filename>.</para>
</listitem></varlistentry>
</variablelist></refsect1>
<refsect1><title>&exam-tt;</title>
<example>
<title>Using update-password-alias</title>
<screen>asadmin> <userinput>update-password-alias --user admin --passwordfile /home/password.txt jmspassword-alias
</userinput>
Please enter the alias password>
Please enter the alias password again>
Command update-password-alias executed successfully.</screen>
</example>
</refsect1>
<refsect1><title>&exit-tt;</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><title>&also-tt;</title>
<para><link linkend="delete-password-alias-1"><citerefentry><refentrytitle>
delete-password-alias</refentrytitle><manvolnum>1</manvolnum></citerefentry></link>, <link
linkend="list-password-aliases-1"><citerefentry><refentrytitle>list-password-aliases
</refentrytitle><manvolnum>1</manvolnum></citerefentry></link>, <link linkend="create-password-alias-1"><citerefentry>
<refentrytitle>create-password-alias</refentrytitle><manvolnum>1</manvolnum>
</citerefentry></link></para>
</refsect1>
</refentry>
<?Pub *0000003600>
