csuser 公用程式可管理儲存於 LDAP 目錄伺服器和 Calendar Server 行事曆資料庫中的行事曆使用者資訊。指令包括︰
check,檢查是否允許使用者使用行事曆功能。
create,建立並允許使用者使用行事曆功能。
此公用程式無法讓使用者獲得 Communications Express 要求的通訊錄。要使用通訊錄,須藉由 ldapmodify 手動完成。
delete,刪除使用者和使用者的預設行事曆。
處於非託管網域模式下時,您必須使用此指令刪除使用者。但是,不會刪除該使用者擁有的其他行事曆。使用 cscal 移除已刪除使用者的其他行事曆。
disable,禁止使用者登入 Calendar Server。
enable,允許使用者登入 Calendar Server。
list,列出使用者的行事曆屬性。
reset,將使用者的行事曆屬性重設為預設設定。
如果您使用的是 Directory Server,則還可以使用 ldapsearch 和 ldapmodify 公用程式。如需有關這些公用程式的資訊,請參閱以下網站上的 Directory Server 文件:
http://docs.sun.com/coll/1316.1 和 http://docs.sun.com/coll/1419.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–38 csuser 公用程式指令
指令 |
說明 |
---|---|
check userid |
檢查是否允許指定的使用者 ID 使用行事曆功能。 |
create userid |
建立指定的使用者 ID 並使該使用者登入 Calendar Server。 |
delete userid |
刪除指定的使用者 ID。 |
disable userid |
禁止指定的使用者 ID 使用行事曆功能。該公用程式將 http 定義為 icsAllowedServiceAccess 屬性的值。 |
enable userid |
允許指定的使用者 ID 使用行事曆功能。 |
list [userid] |
列出指定使用者 ID 的行事曆屬性。如果未指定使用者 ID,則列出所有已啟用使用者的屬性。 如果包含 -hserver-name 選項,則列出該後端伺服器上指定使用者 ID (或所有已啟用使用者) 的行事曆屬性。 |
reset userid |
將使用者 ID 的所有行事曆屬性重設為它們的預設設定。 注意:重設使用者 ID 的行事曆屬性之後,所有行事曆屬性都將從使用者的 LDAP 項目 (包括 icsCalendarUser [物件類別]、icsSubscribed、icsCalendarOwned、icsCalendar 和 icsDWPHost) 中被移除 (如果使用者在 LDAP CLD 設定中)。然後,Calendar Server 管理員便無法代表使用者建立行事曆。 Calendar Server 管理員為使用者發出 csuser 啟用指令時,這些屬性儲存於使用者的 LDAP 項目中。 |
version |
顯示公用程式的版本。 |
下表說明 csuser 公用程式指令選項。
表 D–39 csuser 公用程式指令選項
選項 |
說明 |
---|---|
-v |
在詳細模式下執行:顯示有關正在執行的指令之所有可用資訊。預設為關閉。 |
-q |
在無訊息模式下執行:
|
-b basedn |
要用於所有 LDAP 使用者的基底 DN。預設使用 ics.conf 檔案中所定義設定 local.ugldapbasedn 的值。 |
-b basedn |
指定使用者的基底 DN。 |
-d domain |
指定託管 (虛擬) 網域的名稱。預設使用 ics.conf 檔案中 service.defaultdomain 參數的值。 |
-a [aces] |
指定行事曆的存取控制項目 (ACE)。ACE 決定可以存取群組排程行事曆的人員,以及他們擁有的權限類型,例如建立、刪除、讀取和寫入權限。ACE 字串或存取控制清單 (ACL) 必須置於引號 ("") 中。 預設為: "@@o^a^r^g;@@o^c^wdeic^g; @^a^sf^g;@^c^^g;@^p^r^g" 如需有關 ACE 格式的詳細資訊,請參閱服務配置。 |
-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 姓氏 (姓)。此選項是必需的。無預設值。 |
-u adminDN |
對儲存使用者認證資訊的 LDAP 伺服器具有管理權限的個人的 LDAP 辨別名稱 (DN)。預設使用 ics.conf 檔案中所定義的配置設定 local.enduseradmindn 的值。 |
-w password |
透過 -u 選項指定之 LDAP 管理員 DN 的密碼。 預設使用 ics.conf 檔案中所定義的配置設定 local.enduseradmincred 的值。如果您使用 -u 選項,則需要此選項。 |
-y userpassword |
所需的行事曆使用者的密碼。無預設值。 |
檢查是否允許行事曆使用者 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