add user

向 Registry 中添加用户。

一般形式

说明

add user 命令用于添加用户 (User) 对象。通常，用户 (User) 对象至少包含一个邮政地址 (PostalAddress)、电话号码 (TelephoneNumber) 和电子邮件地址 (EmailAddress) 对象。

在命令行中或通过 -load 选项指定含有信息的 Java 属性文件来指定有关用户的信息。将按照信息选项和 -load 选项在命令行中显示的顺序求值。例如，您可以在命令行中指定一些属性，从某个属性文件中装入其他属性，然后用后面的命令行选项覆盖该属性文件中的信息。

您最多可以为一个新用户指定三组地址、电话号码和电子邮件地址。如果需要指定更多信息，您可以在以后使用 Web 控制台或 JAXR 来添加。

当您指定地址、电话号码或电子邮件地址时，必须提供针对其类型的值：例如，-emailType OfficeEmail。

您可以在命令行中针对每个用户都需要的某些通用信息使用缩略选项（例如 -fn）。但是，当您在属性文件中提供此信息时，必须使用较长的形式。例如，您可以在命令行中使用 -email1.address、-emailAddress 或 -email 指定用户的第一个电子邮件地址。但是，当您在属性文件中指定第一个电子邮件地址时，必须使用 email1.address=。由于用户的第二个电子邮件地址只有一个选项，因此在命令行中必须使用 -email2.address，在属性文件中必须使用 email2.address=。

如果指定了 -edit 选项，管理工具将启动编辑器，以使您可以编辑新用户的信息。有关详细信息，请参见选项说明。

此命令将为新用户在主目录的 $HOME/soar/3.0/jaxr-ebxml/security/keystore.jks 文件中创建证书密钥库。如果您以 root 身份运行此工具，则主目录为 / 或 /root。

使用 -load 装入或使用 -edit 编辑的属性文件使用 IS0-8859-1 字符集，就象所有 Java 属性文件一样。有关如何在属性文件中表示不属于 ISO-8859-1 的字符的详细信息，请参见 java.util.Properties.load(InputStream) 文档。

选项

-edit

使管理工具启动编辑器，以使您可以编辑新用户的信息。对其他命令行参数求值之后，管理工具将启动编辑器。因此，首先编辑对命令行或属性文件中指定的所有信息进行求值所得的结果。编辑程序必须在不出错的情况下终止，然后命令才能继续执行。管理工具将启动由 set editor 命令（请参见set）指定的编辑器；默认情况下，此编辑器为 vi 编辑器。

---

注 –

在此版本中，-edit 可与 emacsclient 和 NetBeans^TM 命令 bin/runide.sh --open 结合使用（但不是很好） ，但还不能与 vi 结合使用。

---

-load

指定用于指定用户属性的 Java 属性文件。属性名称与 add user 命令选项的长型名称（例如 lastName 和 post1.type）相同。

-fn | -firstName

指定用户的名字。

-ln | -lastName

指定用户的姓氏。姓氏是必需的信息，必须在命令行或属性文件中指定。

-mn | -middleName

指定用户的中间名。

-alias

访问密钥库中的用户证书时使用的别名。此选项是必需的选项。别名的长度不能少于三个字符。

-keypass

访问密钥库中的用户证书时使用的密码。此选项是必需的选项。密码的长度不能少于六个字符。

-postalType | -post1.type

第一个邮政地址 (PostalAddress) 的类型。类型是必需的信息，必须在命令行或属性文件中指定。值为一个任意字符串（例如 Office 或 Home）。

-city | -post1.city

第一个邮政地址 (PostalAddress) 的城市。

-country | -post1.country

第一个邮政地址 (PostalAddress) 的国家/地区。

-postalCode | -postcode | - zip | -post1.postalcode

第一个邮政地址 (PostalAddress) 的邮政编码。

-stateOrProvince | -state | - province | -post1.stateOrProvince

第一个邮政地址 (PostalAddress) 的省/自治区/直辖市。

-street | -post1.street

第一个邮政地址 (PostalAddress) 的街道名称。

-streetNumber | -number | - -post1.streetNumber

第一个邮政地址 (PostalAddress) 的门牌号码。

-post2.type

第二个邮政地址 (PostalAddress) 的类型。如果指定了第二个邮政地址 (PostalAddress)，则类型是必需的信息，必须在命令行或属性文件中指定。值为一个任意字符串（例如 Office 或 Home）。

-post2.city

第二个邮政地址 (PostalAddress) 的城市。

-post2.country

第二个邮政地址 (PostalAddress) 的国家/地区。

-post2.postalcode

第二个邮政地址 (PostalAddress) 的邮政编码。

-post2.stateOrProvince

第二个邮政地址 (PostalAddress) 的省/自治区/直辖市。

-post2.street

第二个邮政地址 (PostalAddress) 的街道名称。

-post2.streetNumber

第二个邮政地址 (PostalAddress) 的门牌号码。

-post3.type

第三个邮政地址 (PostalAddress) 的类型。如果指定了第三个邮政地址 (PostalAddress)，则类型是必需的信息，必须在命令行或属性文件中指定。值为一个任意字符串（例如 Office 或 Home）。

-post3.city

第三个邮政地址 (PostalAddress) 的城市。

-post3.country

第三个邮政地址 (PostalAddress) 的国家/地区。

-post3.postalcode

第三个邮政地址 (PostalAddress) 的邮政编码。

-post3.stateOrProvince

第三个邮政地址 (PostalAddress) 的省/自治区/直辖市。

-post3.street

第三个邮政地址 (PostalAddress) 的街道名称。

-post3.streetNumber

第三个邮政地址 (PostalAddress) 的门牌号码。

-phoneType | -telephone1.type

第一个电话号码 (TelephoneNumber) 的类型。类型是必需的信息，必须在命令行或属性文件中指定。值为一个任意字符串，但可以指定下面的一种已知类型：Beeper、FAX、HomePhone、MobilePhone 或 OfficePhone。

-areaCode | -telephone1.areaCode

第一个电话号码 (TelephoneNumber) 的区号。

-countryCode | -telephone1.countryCode

第一个电话号码 (TelephoneNumber) 的国家/地区代码。

-extension | -telephone1.extension

第一个电话号码 (TelephoneNumber) 的分机。

-number | -telephone1.number

第一个电话号码 (TelephoneNumber) 的电话号码后缀（不包括国家/地区代码或区号）。号码是必需的信息，必须在命令行或属性文件中指定。

-URL | -telephone1.URL

第一个电话号码 (TelephoneNumber) 的 URL（可以在网上拨打此号码的 URL）。

-telephone2.type

第二个电话号码 (TelephoneNumber) 的类型。如果指定了第二个电话号码 (TelephoneNumber)，则类型是必需的信息，必须在命令行或属性文件中指定。值为一个任意字符串，但可以指定下面的一种已知类型：Beeper、FAX、HomePhone、MobilePhone 或 OfficePhone。

-telephone2.areaCode

第二个电话号码 (TelephoneNumber) 的区号。

-telephone2.countryCode

第二个电话号码 (TelephoneNumber) 的国家/地区代码。

-telephone2.extension

第二个电话号码 (TelephoneNumber) 的分机。

-telephone2.number

第二个电话号码 (TelephoneNumber) 的电话号码后缀（不包括国家/地区代码或区号）。如果指定了第二个电话号码 (TelephoneNumber)，则号码是必需的信息，必须在命令行或属性文件中指定。

-telephone2.URL

第二个电话号码 (TelephoneNumber) 的 URL（可以在网上拨打此号码的 URL）。

-telephone3.type

第三个电话号码 (TelephoneNumber) 的类型。如果指定了第三个电话号码 (TelephoneNumber)，则类型是必需的信息，必须在命令行或属性文件中指定。值为一个任意字符串，但可以指定下面的一种已知类型：Beeper、FAX、HomePhone、MobilePhone 或 OfficePhone。

-telephone3.areaCode

第三个电话号码 (TelephoneNumber) 的区号。

-telephone3.countryCode

第三个电话号码 (TelephoneNumber) 的国家/地区代码。

-telephone3.extension

第三个电话号码 (TelephoneNumber) 的分机。

-telephone3.number

第三个电话号码 (TelephoneNumber) 的电话号码后缀（不包括国家/地区代码或区号）。如果指定了第三个电话号码 (TelephoneNumber)，则号码是必需的信息，必须在命令行或属性文件中指定。

-telephone3.URL

第三个电话号码 (TelephoneNumber) 的 URL（可以在网上拨打此号码的 URL）。

-emailType | -email1.type

第一个电子邮件地址 (EmailAddress) 的类型。类型是必需的信息，必须在命令行或属性文件中指定。值为一个任意字符串，但可以指定下面的一种已知类型：HomeEmail 或 OfficeEmail。

-emailAddress | -email | - email1.address

第一个电子邮件地址。第一个电子邮件地址是必需的信息。

-email2.type

第二个电子邮件地址 (EmailAddress) 的类型。如果指定了第二个电子邮件地址 (EmailAddress)，则类型是必需的信息，必须在命令行或属性文件中指定。值为一个任意字符串，但可以指定下面的一种已知类型：HomeEmail 或 OfficeEmail。

-email2.address

第二个电子邮件地址。

-email3.type

第三个电子邮件地址 (EmailAddress) 的类型。如果指定了第三个电子邮件地址 (EmailAddress)，则类型是必需的信息，必须在命令行或属性文件中指定。值为一个任意字符串，但可以指定下面的一种已知类型：HomeEmail 或 OfficeEmail。

-email3.address

第三个电子邮件地址。

示例

以下命令将从用户主目录的 JaneSmith.properties 文件中装入用户 (User) 属性。

admin> add user -load ~/JaneSmith.properties

以下命令（全都在一行）将指定创建用户 (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