add user
將使用者增加至登錄 (Registry)。
提要
add user [-edit] [- load pathname] [-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 Console 或 JAXR 予以增加。
指定地址、電話號碼或電子郵件時，您必須提供其類型的值︰例如，-emailType OfficeEmail。
對於每個使用者都需要的共用資訊，您可以在指令行使用快捷選項 (例如，-fn)。然而，在特性檔案中提供資訊時，您必須使用較長的格式。例如，您可以使用 -email1.address、-emailAddress 或 -email，在指令行指定使用者的第一個電子郵件地址。不過，當您在特性檔案中指定第一個電子郵件地址時，則須使用 email1.address=。由於使用者的第二個電子郵件地址僅有一個選項，所以您必須在指令行中使用 -email2.address，在特性檔案中使用 email2.address=。
如果您指定 -edit 選項，則 Admin Tool 會啟動編輯器，以便您可以編輯新使用者的資訊。請參閱選項說明，以取得詳細資訊。
指令會在主目錄中的 $HOME/soar/3.0/jaxr-ebxml/security/keystore.jks 檔案內，建立新使用者的憑證金鑰庫。如果您正以 root 的身份執行工具，主目錄會是 / 或 /root。
備註 –
您使用 -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