create,建立行事曆
delete,刪除行事曆
disable,停用行事曆
enable,啟用行事曆
list,列出行事曆
modify,修改行事曆特性及群組排程存取控制
reset,將行事曆特性重設為預設設定
version,顯示目前安裝之公用程式的版本編號。
您必須在安裝了 Calendar Server 的機器上本機執行此公用程式。
Calendar Server 可以處於執行中或停止狀態。
您必須以執行 Calendar Server 的使用者或群組 (在安裝期間指定,例如 icsuser 和 icsgroup) 的身份或以 root 身份登入。
cscal [-q|-v] [-a aces] [-c charset] [-d description] [-g categories] [-k yes|no] [-l langcode] [-m email] [-n name] [-o owner’s uid] [-y otherowners] create|modify calid cscal [-q|-v] [-o owner’s uid] [-O] delete|reset calid cscal [-q|-v] [-o owner’s uid] [-O] disable|list [calid] cscal [-q|-v] [-k yes|no] [-o owner’s uid] [-O] enable [calid] |
儘管在您輸入 -o (所有者的 uid) 後 cscal 不檢查大小寫,搜尋仍是大小寫不須相符。
下表說明 cscal 公用程式可用的指令。
表 D–6 cscal 公用程式指令
指令 |
說明 |
---|---|
create calid |
建立 calid 指定的行事曆。 注意:如果您的網站使用的是 LDAP CLD 外掛程式,則特定使用者的所有行事曆必須在同一後端伺服器上,如使用者的 icsDWPHost LDAP 屬性所指示。如果您嘗試在其他後端伺服器上建立該使用者的行事曆,Calendar Server 將傳回錯誤。 |
delete calid |
刪除 calid 指定的行事曆。 如果指定 -o owner 選項,則會刪除主要所有者為指定 uid 的所有行事曆。 |
enable [ calid ] |
啟用 calid 指定的行事曆。如果未指定 calid,則會啟用所有行事曆。 如果指定 -o owner 選項,則會啟用主要所有者為指定 uid 的所有行事曆。 |
disable [ calid ] |
停用 calid 指定的行事曆。如果未指定 calid,則會停用所有行事曆。 如果指定 - o owner 選項,則會停用主要所有者為指定 uid 的所有行事曆。 |
list [ calid ] |
列出 calid 所指定行事曆的特性。如果未指定 calid,則會列出所有行事曆的特性。 如果指定 - o owner's uid 選項,則會列出主要所有者為指定所有者 uid 的所有行事曆。 |
modify calid |
修改 calid 所指定行事曆的特性。 |
reset calid |
將 calid 所指定行事曆的特性重設為預設配置設定。 |
version |
顯示公用程式的版本。 |
下表說明 cscal 公用程式指令選項。
表 D–7 cscal 公用程式指令選項
選項 |
說明 |
---|---|
-v |
在詳細模式下執行:顯示有關正在執行的指令之所有可用資訊。預設為關閉。 |
-q |
在無訊息模式下執行:
|
-a [ aces] |
指定行事曆的存取控制項目 (ACE)。ACE 決定可以存取群組排程行事曆的人員,以及他們擁有的權限類型,例如建立、刪除、讀取和寫入權限。ACE 字串或存取控制清單 (ACL) 必須置於引號 (" ") 中。 預設為 ics.conf 檔案中的 calstore.calendar.default.acl 參數。 如需 ACE 格式的詳細資訊,請參閱1.8 Calendar Server 版本 6.3 的存取控制。 |
-c charset |
字元集。預設為無字元集。 |
-d description |
說明 (有關行事曆目的的可檢視註釋)。預設為無說明。 |
-g category |
類別。多個種類必須置於引號 ("") 中,並以空格分隔。預設為無類別。 |
-k yes|no |
指定是否允許使用者行事曆的雙預定。例如,yes 表示行事曆可以為同一時段排程一個以上的事件。 如果忽略 -k 選項,則預設使用 ics.conf 檔案中 user.allow.doublebook 參數的值。但是,僅在建立行事曆時,才使用 user.allow.doublebook 參數。 建立行事曆之後,Calendar Server 將檢查行事曆特性資料庫 ics50calprops.db,以確定是否允許雙預定。如果您需要為行事曆變更行事曆特性以允許或不允許雙預定,請重新發出帶有 -k 選項的 cscal。 |
-l langcode |
語言代碼。預設為無語言代碼。 |
-m email |
電子郵件位址。預設為無電子郵件。 |
-n name |
可檢視的名稱。預設為無名稱。 |
-o owner |
(小寫 o) 主要所有者。預設設定為主要所有者的唯一 ID (uid)。 |
-O |
(大寫 O) 指定主要所有者的所有行事曆。預設僅為已命名的行事曆。 |
-y otherowners |
其他行事曆所有者。多位所有者必須置於引號 ("") 中,並以空格分隔。預設為無其他所有者。 |
若嘗試在指定的後端機器上建立行事曆,並收到以下錯誤訊息:[無效的 DWP 主機伺服器]。則表示出現以下兩種狀況之一。可能是您的伺服器配置錯誤,或已將行事曆所有者指定給其他後端伺服器。
查詢 ics.conf 檔案以找出有問題的後端伺服器。確認存在下列設定:
service.dwp.enable = "yes" caldb.cld.type = "directory" local.hostname = "back-end hostname"
查詢使用者的 LDAP 項目,看是否存在 icsDWPHost 屬性。icsDWPHost 的值必須符合您嘗試建立行事曆所在的後端伺服器的名稱。您無法在其他後端伺服器上建立這個使用者的行事曆。
使用預設存取控制設定 (由 ics.conf 檔案中的 calstore.calendar.default.acl 定義) 建立行事曆 ID 為 tchang 的行事曆,tchang 為主要所有者,顯示名稱為 Public_Calendar︰
cscal - o tchang - n Public_Calendar create tchang
修改行事曆 chang,以便讓所有使用者都擁有讀取和寫入權限,該行事曆與種類 sports 關聯,並由 jsmith@sesta.com 共同所有︰
cscal - a "@^a^rw^g" -g sports -y jsmith@sesta.com modify tchang
停用行事曆 ID 為 tchang 的行事曆 (不允許使用者透過使用者介面讀取、寫入或尋找該行事曆)︰
cscal disable tchang
啟用行事曆 ID 為 tchang 的行事曆 (允許使用者透過使用者介面讀取或寫入該行事曆),但不允許雙預定︰
cscal -k no enable tchang
列出 tchang 的特性:
cscal list tchang
列出 tchang 的所有特性:
cscal - v list tchang
列出資料庫中的所有行事曆︰
cscal list
將行事曆 ID 為 tchang 的行事曆重設為預設配置設定︰
cscal reset tchang
從行事曆 ID 為 tchang 的行事曆中移除說明︰
cscal -d "" modify tchang
從行事曆 ID 為 tchang 的行事曆中移除所有種類︰
cscal -g "" modify tchang
從行事曆 ID 為 tchang 的行事曆中移除其他所有者︰
cscal -y "" modify tchang
從行事曆資料庫中刪除 tchang:
cscal delete tchang
從主要所有者為 tchang 的行事曆資料庫中刪除所有行事曆︰
cscal -o tchang delete