csuser 公用程式僅適用於 Schema 1 模式。它會管理行事曆使用者的 LDAP 項目及使用者的預設行事曆。指令包括︰
check,檢查是否允許使用者使用行事曆功能。
create,允許使用者使用行事曆功能。
此公用程式無法讓使用者獲得 Communications Express 要求的通訊錄。要使用通訊錄,須藉由 ldapmodify 手動完成。
delete,刪除使用者和使用者的預設行事曆。
若使用者具有其他行事曆,則不會刪除它們。可使用 cscal 移除已刪除之使用者的其他行事曆。
disable,防止使用者登入 Calendar Server。
enable,允許使用者登入 Calendar Server。
list,列出使用者的行事曆屬性。
reset,從 LDAP 項目移除所有行事曆屬性,包括 icsCalendarUser (物件類別)、icsSubscribed、icsCalendarOwned、icsCalendar 和 icsDWPHost (如果使用者在 LDAP CLD 設定中)。
發出此指令後,將無法再啟用使用者的行事曆服務。若要復原使用者的行事曆服務,請發出 csuser enable 指令。
如果您使用的是 Directory Server,則還可以使用 ldapsearch 和 ldapmodify 公用程式。如需有關這些公用程式的資訊,請參閱以下網站上的 Directory Server 文件:
http://docs.sun.com/coll/1316.2
您必須使用 Schema 1。
Calendar Server 可以處於執行中或停止狀態。
您必須在安裝了 Calendar Server 的機器上本機執行此公用程式。
儲存行事曆使用者資訊的 LDAP 伺服器必須處於執行中狀態。
您必須以執行 Calendar Server 的使用者或群組 (在安裝期間指定,例如 icsuser 和 icsgroup) 的身份或以 root 身份登入。
| csuser [-q|-v]
       [-a aces] 
       [-b basedn]
        -m email address 
       [-d domain]
        -f filename
        -g givenname 
       [-k yes|no] 
       [-l langcode] 
        -s surname 
        -y userpassword
       create userid
csuser [-q|-v] 
       [-b basedn] 
       [-d domain] 
       [-h host] 
       list [userid]
csuser [-q|-v] 
       [-b basedn] 
       [-d domain]
       [check|delete|disable|enable|reset] userid
         
 | 
下表說明 csuser 公用程式可用的指令。
表 D–34 csuser 公用程式指令| 指令 | 說明 | 
|---|---|
| check userid | 檢查是否允許指定的使用者 ID 使用行事曆功能。 | 
| create userid | 建立指定的使用者 ID 並使該使用者登入 Calendar Server。 | 
| delete userid | 刪除指定的使用者 ID。 | 
| disable userid | 籍由在使用者的 LDAP 的項目中增加 icsAllowedServiceAcess="http" 來防止指定使用者 ID 使用行事曆功能。 | 
| enable userid | 籍由移除使用者 LDAP 中的 icsAllowedServiceAcess="http" 來允許指定使用者 ID 使用行事曆功能。 | 
| list [userid] | 列出指定使用者 ID 的行事曆屬性。如果未指定使用者 ID,則列出所有已啟用使用者的屬性。 如果包含 -h server-name 選項,則列出該後端伺服器上指定使用者 ID (或所有已啟用使用者) 的行事曆屬性。 | 
| reset userid | 將使用者 ID 的所有行事曆屬性重設為它們的預設設定。 注意:重設使用者 ID 的行事曆屬性之後,所有行事曆屬性都將從使用者的 LDAP 項目 (包括 icsCalendarUser (物件類別)、icsSubscribed、icsCalendarOwned、icsCalendar 和 icsDWPHost) 中移除 (如果使用者在 LDAP CLD 設定中)。然後,Calendar Server 管理員便無法代表使用者建立行事曆。 Calendar Server 管理員針對使用者發出 csuser 啟用指令時,這些屬性會復原至使用者的 LDAP 項目中。 | 
| version | 顯示公用程式的版本。 | 
下表說明 csuser 公用程式指令選項。
表 D–35 csuser 公用程式指令選項| 選項 | 說明 | 
|---|---|
| -v | 在詳細模式下執行:顯示有關正在執行的指令之所有可用資訊。預設為關閉。 | 
| -q | 在無訊息模式下執行: 
 | 
| -b basedn | 要用於所有 LDAP 使用者的基底 DN。預設使用 ics.conf 檔案中所定義之設定 local.ugldapbasedn 的值。 | 
| -d domain | |
| -a [aces] | 指定行事曆的存取控制項目 (ACE)。ACE 決定可以存取群組排程行事曆的人員,以及他們擁有的權限類型,例如建立、刪除、讀取和寫入權限。ACE 字串或存取控制清單 (ACL) 必須置於引號 ("") 中。 預設為: "@@o^a^r^g;@@o^c^wdeic^g; @^a^sf^g;@^c^^g;@^p^r^g" 如需有關 ACE 格式的詳細資訊,請參閱E.2.9 Calendar Server 服務配置。 | 
| -f filename | 檔案名稱,用於為需要密碼 (-y 參數) 的選項指定密碼。如果您要從程序檔執行 csuser,以使用附加的安全性,請在檔案名稱中指定密碼。 | 
| -g givenname | 使用者的 LDAP 給定名稱 (名字)。此選項是必需的。無預設值。 | 
| -h host | 指定使用者行事曆所在的後端伺服器的名稱。此選項僅適用於 list 指令。 | 
| -p port | LDAP 伺服器偵聽的連接埠號。預設使用 ics.conf 檔案中所定義之設定 local.ugldapport 的值。 | 
| -k yes|no | |
| -l [langcode] | 語言代碼。預設為 ics.conf 中 local.sitelanguage 的值。 | 
| -m email address | 指定使用者的 LDAP mail 屬性 (主要電子郵件位址)。 | 
| -s surname | 使用者的 LDAP 姓氏 (姓)。此選項是必需的。無預設值。 | 
檢查是否允許行事曆使用者 jsmith@sesta.com 使用行事曆功能 (現有行事曆使用者是否可以存取此 Calendar Server 的行事曆資料)︰
csuser check jsmith@sesta.com
建立一位 LDAP 使用者,其使用者 ID 為 jsmith@sesta.com,名字為 John,姓氏為 Smith,電子郵件位址為 jsmith@sesta.com,網域為 sesta.com:
csuser -g John -s Smith -y password -m jsmith@sesta.com create jsmith@sesta.com -d sesta.com
刪除行事曆使用者 jsmith@sesta.com:
csuser delete jsmith@sesta.com
禁止行事曆使用者 jsmith@sesta.com 登入 Calendar Server:
csuser disable jsmith@sesta.com
此指令可防止 jsmith@sesta.com 登入 Calendar Server 以存取行事曆資料,但不會從行事曆資料庫中刪除 jsmith 的資料。如果 jsmith 目前已登入 Calendar Server,則他仍可存取行事曆資料,直至其登出。
允許 jsmith@sesta.com 使用行事曆功能 (讓現有行事曆使用者登入 Calendar Server):
csuser enable jsmith@sesta.com
列出 jsmith@sesta.com 的所有行事曆屬性:
csuser -v list jsmith@sesta.com
列出前綴為字串 user 的所有行事曆使用者 ID:
csuser -v list "user*"
將 jsmith@sesta.com 的所有行事曆屬性重設為預設配置設定:
csuser reset jsmith@sesta.com
列出後端伺服器 sesta 上 tchang 的所有行事曆屬性︰
csuser - v -h sesta list tchang