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