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 選項，則 Admin Tool 會啟動編輯器，以便您可以編輯新使用者的資訊。請參閱選項說明，以取得詳細資訊。
備註 –
您使用 -load 載入或使用 -edit 編輯的特性檔案使用 IS0-8859-1 字元集，如同所有 Java 特性檔案一樣。請參閱 java.util.Properties.load(InputStream) 的文件，以取得有關如何在特性檔案中表示非 ISO-8859-1 字元。
選項
- -edit
-
使 Admin Tool 啟動編輯器，以便您可以編輯新使用者的資訊。工具在評估其他指令行參數後啟動編輯器。然後，編輯才能起始於指令行或特性檔案中指定的任何資訊的評估結果。編輯程式必須無錯誤終止，指令才能繼續。Admin Tool 啟動 set editor 指令 (請參閱set) 指定的編輯器；依預設，此為 vi 編輯器。
備註 –在此發行版本中，-edit 可以與 emacsclient 和 NetBeansTM 指令 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 |
- © 2010, Oracle Corporation and/or its affiliates