Service Registry 3 2005Q4 管理指南

`add user`

向 Registry 中添加用户。

一般形式

add user [-edit] [-load filename] [-firstname string] [-lastname string] [-middleName string] -alias string -keypass string [-post1.type string] [-post1.city string] [-post1.country string] [- post1.postalcode string] [-post1.stateOrProvince string] [-post1.street string] [-post2.streetNumber string] [-post2.type string] [-post2.city string] [- post2.country string] [-post2.postalcode string] [-post2.stateOrProvince string] [-post2.street string] [-post2.streetNumber string] [-post3.type string] [-post3.city string] [- post3.country string] [-post3.postalcode string] [-post3.stateOrProvince string] [-post3.street string] [-post3.streetNumber string] [-telephone1.type string] [-telephone1.areaCode string] [-telephone1.countryCode string] [-telephone1.extension string] [-telephone1.number string] [- telephone1.URL string] [-telephone2.type string] [-telephone2.areaCode string] [-telephone2.countryCode string] [-telephone2.extension string] [-telephone2.number string] [-telephone2.URL string] [-telephone3.type string] [-telephone3.areaCode string] [-telephone3.countryCode string] [-telephone3.extension string] [-telephone3.number string] [- telephone3.URL string] [-email1.type string] [-email1.address string] [-email2.type string] [-email12address string] [- email3.type string] [-email3.address string]

说明

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 选项，管理工具将启动编辑器，以使您可以编辑新用户的信息。有关详细信息，请参见选项说明。

注 –

使用 -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