特定のユーザーをレジストリに追加します。
add user コマンドは、User オブジェクトを追加します。User オブジェクトには通常、PostalAddress、TelephoneNumber、EmailAddress の各オブジェクトが少なくとも 1 つずつ含まれます。
ユーザーに関する情報を指定するには、それらの情報をコマンド行から直接入力するか、あるいは -load オプションを使ってそれらの情報を含む Java プロパティーファイルを指定します。情報オプションと -load オプションは、コマンド行に指定された順番で評価されます。たとえば、いくつかのプロパティーをコマンド行から指定し、その他のプロパティーをプロパティーファイルから読み込んだあとで、そのプロパティーファイルの情報を後続のコマンド行オプションで上書きする、といったことも可能です。
新規ユーザーごとにアドレス、電話番号、および電子メールアドレスを最大 3 つずつ指定できます。それ以上必要な場合も、あとで Web コンソールや JAXR を使って追加できます。
住所、電話番号、電子メールアドレスのいずれかを指定する際には、 -emailType OfficeEmail のようにタイプの値を指定する必要があります。
コマンド行では、すべてのユーザーで必要となる基本情報のいくつかに対して短形式オプション (-fn など) が使用できるようになっています。ただし、そうした情報をプロパティーファイルで指定する場合には、長形式を使用する必要があります。たとえば、ユーザーの 1 つ目の電子メールアドレスをコマンド行から指定する場合には、- email1.address、-emailAddress、-email のいずれかを使用できますが、1 つ目の電子メールアドレスをプロパティーファイルで指定する場合には、email1.address= を使用する必要があります。ユーザーの 2 つ目の電子メールアドレスに対するオプションは 1 つしか用意されていないため、コマンド行では -email2.address を、プロパティーファイル内では email2.address= を、それぞれ使用する必要があります。
-edit オプションを指定した場合、新しいユーザーの情報を編集できるように、管理ツールによってエディタが起動されます。詳細については、オプション説明を参照してください。
-load の読み込み対象または -edit の編集対象となるプロパティーファイルでは、その他のすべての Java プロパティーファイルと同じく、IS0-8859-1 文字が使用されます。ISO-8859-1 に含まれない文字をプロパティーファイル内で表現する方法の詳細については、java.util.Properties.load(InputStream) のドキュメントを参照してください。
これを指定すると、新しいユーザーの情報を編集できるように、管理ツールによってエディタが起動されます。ツールによってエディタが起動されるのは、ほかのコマンド行パラメータが評価されたあとです。したがって、コマンド行またはプロパティーファイル内に指定された情報の評価結果に基づいて編集作業が開始されます。編集プログラムが正常に終了しないと、コマンドは続行されません。管理ツールは、set editor コマンド (「set」を参照) で指定されたエディタを起動します。これはデフォルトでは vi エディタになっています。
このリリースでは、-edit は、emacsclient および NetBeansTM コマンド bin/runide.sh --open と組み合わせて使用できますが、動作は保証されておらず、vi と組み合わせた場合に正常に動作するかどうかは、明らかになっていません。
ユーザーのプロパティーが格納された Java プロパティーファイルを指定します。そのプロパティー名は、add user コマンドの長形式オプション (lastName、post1.type など) と同一です。
ユーザーの名を指定します。
ユーザーの姓 (名字) を指定します。姓は必須です。コマンド行、プロパティーファイル内のいずれかで指定する必要があります。
ユーザーのミドルネームを指定します。
キーストア内のユーザーの証明書にアクセスする際に使用するエイリアス。このオプションは必須です。エイリアスの文字長は 3 文字以上である必要があります。
キーストア内のユーザーの証明書にアクセスする際に使用するパスワード。このオプションは必須です。パスワードの文字長は 6 文字以上である必要があります。
1 つ目の PostalAddress のタイプ。このタイプは必須です。コマンド行、プロパティーファイル内のいずれかで指定する必要があります。値は任意の文字列 (Office、Home など) です。
1 つ目の PostalAddress の市。
1 つ目の PostalAddress の国。
1 つ目の PostalAddress の郵便番号。
1 つ目の PostalAddress の州または都道府県。
1 つ目の PostalAddress の町名。
1 つ目の PostalAddress の番地。
2 つ目の PostalAddress のタイプ。2 つ目の PostalAddress を指定する場合、そのタイプは必須です。コマンド行、プロパティーファイル内のいずれかで指定する必要があります。値は任意の文字列 (Office、Home など) です。
2 つ目の PostalAddress の市。
2 つ目の PostalAddress の国。
2 つ目の PostalAddress の郵便番号。
2 つ目の PostalAddress の州または都道府県。
2 つ目の PostalAddress の町名。
2 つ目の PostalAddress の番地。
3 つ目の PostalAddress のタイプ。3 つ目の PostalAddress を指定する場合、そのタイプは必須です。コマンド行、プロパティーファイル内のいずれかで指定する必要があります。値は任意の文字列 (Office、Home など) です。
3 つ目の PostalAddress の市。
3 つ目の PostalAddress の国。
3 つ目の PostalAddress の郵便番号。
3 つ目の PostalAddress の州または都道府県。
3 つ目の PostalAddress の町名。
3 つ目の PostalAddress の番地。
1 つ目の TelephoneNumber のタイプ。このタイプは必須です。コマンド行、プロパティーファイル内のいずれかで指定する必要があります。値は任意の文字列ですが、次の既知のタイプのいずれかを指定できます。 Beeper、FAX、HomePhone、MobilePhone、または OfficePhone。
1 つ目の TelephoneNumber の市外局番。
1 つ目の TelephoneNumber の国番号。
1 つ目の TelephoneNumber の内線。
1 つ目の TelephoneNumber の電話番号サフィックス。国番号や市外局番は含みません。この番号は必須です。コマンド行、プロパティーファイル内のいずれかで指定する必要があります。
1 つ目の TelephoneNumber の URL (この番号に電子的に電話をかけることのできる URL)。
2 つ目の TelephoneNumber のタイプ。2 つ目の TelephoneNumber を指定する場合、そのタイプは必須です。コマンド行、プロパティーファイル内のいずれかで指定する必要があります。値は任意の文字列ですが、次の既知のタイプのいずれかを指定できます。Beeper、 FAX、HomePhone、MobilePhone、または OfficePhone。
2 つ目の TelephoneNumber の市外局番。
2 つ目の TelephoneNumber の国番号。
2 つ目の TelephoneNumber の内線。
2 つ目の TelephoneNumber の電話番号サフィックス。国番号や市外局番は含みません。2 つ目の TelephoneNumber を指定する場合、その番号は必須です。コマンド行、プロパティーファイル内のいずれかで指定する必要があります。
2 つ目の TelephoneNumber の URL (この番号に電子的に電話をかけることのできる URL)。
3 つ目の TelephoneNumber のタイプ。3 つ目の TelephoneNumber を指定する場合、そのタイプは必須です。コマンド行、プロパティーファイル内のいずれかで指定する必要があります。値は任意の文字列ですが、次の既知のタイプのいずれかを指定できます。Beeper、 FAX、HomePhone、MobilePhone、または OfficePhone。
3 つ目の TelephoneNumber の市外局番。
3 つ目の TelephoneNumber の国番号。
3 つ目の TelephoneNumber の内線。
3 つ目の TelephoneNumber の電話番号サフィックス。国番号や市外局番は含みません。3 つ目の TelephoneNumber を指定する場合、その番号は必須です。コマンド行、プロパティーファイル内のいずれかで指定する必要があります。
3 つ目の TelephoneNumber の URL (この番号に電子的に電話をかけることのできる URL)。
1 つ目の EmailAddress のタイプ。このタイプは必須です。コマンド行、プロパティーファイル内のいずれかで指定する必要があります。値は任意の文字列ですが、次の既知のタイプのいずれかを指定できます。HomeEmail または OfficeEmail。
1 つ目の電子メールアドレス。1 つ目の電子メールアドレスは必須です。
2 つ目の EmailAddress のタイプ。2 つ目の EmailAddress を指定する場合、そのタイプは必須です。コマンド行、プロパティーファイル内のいずれかで指定する必要があります値は任意の文字列ですが、次の既知のタイプのいずれかを指定できます。HomeEmail または OfficeEmail。
2 つ目の電子メールアドレス。
3 つ目の EmailAddress のタイプ。3 つ目の EmailAddress を指定する場合、そのタイプは必須です。コマンド行、プロパティーファイル内のいずれかで指定する必要があります。値は任意の文字列ですが、次の既知のタイプのいずれかを指定できます。HomeEmail または OfficeEmail。
3 つ目の電子メールアドレス。
次のコマンドは、ユーザーのホームディレクトリ内のファイル JaneSmith.properties から User のプロパティーを読み込みます。
admin> add user -load ~/JaneSmith.properties |
次のコマンド (すべてを 1 行で入力) では、User オブジェクトの作成に最低限必要なプロパティーを指定しています。
admin> add user -ln Smith -postaltype Office -country US -phonetype Office -number 333-3333 -emailtype OfficeEmail -emailaddress JaneSmith@JaneSmith.com -alias 123 -keypass 123456 |