附錄 D Calendar Server 指令行公用程式參照

上一個目錄索引下一個
Sun Java System Calendar Server 管理指南

附錄 D
Calendar Server 指令行公用程式參照

Calendar Server 提供未包含在使用者管理公用程式 (即隨附於 Identity Server 的 commadmin) 中的一組指令行管理公用程式。

這些 Calendar Server 公用程式可從 batch、shell 和程序檔程式 (如 Perl) 啟動。在這些公用程式中，某些 (csuser、csresource 和 csdomain) 已由 commadmin 公用程式所取代，但其餘的仍在使用，即使是在模式 2 環境中。對於模式 1，您必須繼續使用 csuser、csresource 和 csdomain，而不使用 commadmin。

如果需要，這些公用程式可使用 ics.conf 配置檔案的預設值。

這些指令行公用程式位於以下目錄中︰

cal_svr_base/opt/SUNWics5/cal/sbin

本章提供以下資訊︰

執行指令行公用程式

指令行公用程式的語法

指令行公用程式的使用規則

程序檔中的回覆碼

指令行公用程式表格

csattribute  |  csbackup  |  cscal  |  csclean  |  cscomponents  |  csdb

csdomain  |  csexport  |  csimport  |  csmonitor  |  csplugin  |  cspurge

csrename  |  csresource  |  csrestore  |  csschedule  |  csstart  |  csstats

csstop  |  csstored.pl  |  cstool  |  csuser  |  start-cal  |  stop-cal

執行指令行公用程式

在 Solaris 作業系統上，以執行 Calendar Server 的使用者和群組身份或 root 身份登入時，執行指令行公用程式。這將在安裝期間指定；預設為 icsuser 和 icsgroup。

例如，如果您的 Calendar Server 基底目錄為 CALENDAR，若要執行 cscal 公用程式 list 指令，您需要在登入後執行以下動作：

cd CALENDAR/SUNWics5/cal/sbin
./cscal list

指令行公用程式的語法

Calendar Server 指令行公用程式使用以下語法︰

utility [ -option [ value ] ] command [ target ]

其中：

utility 為公用程式的可執行名稱，如 cscal 或 csuser。

option 決定指令所執行的動作。選項為小寫且前面帶有連字符號 (-)，如 -d。括號 ([]) 中的選項為選擇性的。如果指明，則可同時使用兩個或多個選項。

value 進一步限定 option 所指定的動作，如與 -d 選項一起使用的說明。括號 ([]) 中的值為選擇性的。包含空格的值必須置於引號 (" ") 中。多個值必須置於引號 ("") 中，且每個值必須以空格分隔，除非另有指示，如使用以分號分隔的清單。

command 為公用程式執行的動作，如 list 或 create。以垂直線 (|) 分隔的指令表示可同時使用任一指令 (而不是同時使用這兩個指令)。

target 為指令在其上生效的物件，如行事曆 ID 或使用者 ID。

指令行公用程式的使用規則

以下規則為指令行公用程式的一般使用指南︰

如果您僅指定公用程式的名稱，它則列出所有指令、選項以及數個範例。

如果您未指定必需的密碼，公用程式則提示您指定密碼。

-v (冗長) 和 -q (無訊息) 選項可用於每個公用程式。

如果是危險指令 (即可能會導致資料遺失的指令)，則公用程式會在執行該指令之前提示您進行確認。危險指令的範例為 cscal (可以刪除行事曆) 和 csuser (可以刪除使用者)。但是，-q (無訊息) 選項會停用確認提示。

version 指令可用於每個公用程式。

程序檔中的回覆碼

如果您從程序檔執行指令行公用程式，則在公用程式成功執行時，回覆碼為「0」；失敗時為「-1」。

指令行公用程式表格

表格 D-1 說明 Calendar Server 指令行公用程式。

表格 D-1 Calendar Server 指令行公用程式摘要

公用程式

說明

csattribute

管理行事曆使用者或資源的 LDAP 屬性。

csbackup

備份個別行事曆、使用者以及行事曆資料庫。

cscal

管理行事曆及其特性。

csclean

移除其狀態屬性 (inetUserStatus) 已被 Identity Server 的 commadmin 公用程式標記為「已刪除」的 Calendar Server 使用者的使用者行事曆和資源行事曆。

cscomponents

管理行事曆元件︰事件和工作 (待辦事項)。

csdb

管理行事曆資料庫。

csdomain

管理 LDAP 目錄中託管 (虛擬) 網域的 Calendar Server 屬性。

csexport

以 iCalendar (.ics) 或 XML (.xml) 格式匯出行事曆。

csimport

以 iCalendar (.ics) 或 XML (.xml) 格式匯入行事曆。

csmonitor

監視 LDAP 連線、日誌檔以及行事曆資料庫的可用磁碟空間。

csplugin

檢視、啟用或停用已配置的 Calendar Server API (CSAPI) Plug-in。

cspurge

允許手動清除刪除日誌資料庫 (ics50deletelog.db) 中的項目。

csrename

允許重新命名使用者 ID。導致整個資料庫被重寫。

csresource

管理行事曆資源，如會議室和設備。

csrestore

復原個別行事曆、使用者以及行事曆資料庫。

csschedule

管理群組排程引擎 (GSE) 佇列中的排程項目。

csstart

啟動 Calendar Server 程序。

csstats

顯示 Calendar Server 中的計數器。

csstop

停止 Calendar Server 程序。

csstored.pl

執行行事曆資料庫和日誌檔的歸檔作業。

cstool

Ping 執行中的 Calendar Server 實例。

csuser

管理行事曆使用者。

start-cal

啟動所有 Calendar Server 程序。

stop-cal

停止所有 Calendar Server 程序。

csattribute

csattribute 公用程式管理 Calendar Server 使用者或資源 LDAP 項目屬性。指令包括︰

add，將 LDAP 屬性和值增加至指定目標 (使用者或資源物件)。

list，列出目標物件的屬性。

delete，從目標中刪除屬性。

註

如果您的站點使用的是 LDAP CLD Plug-in，請勿在嘗試指定新的後端主機伺服器時使用 csattribute 來變更 icsDWPHost 屬性。修改 icsDWPHost 不會在新的後端主機上建立新的行事曆。如需更多資訊，請參閱第 9 章「配置行事曆查找資料庫 Plug-in」。

需求

Calendar Server 可以處於執行中或停止狀態。

在 Solaris 作業系統上，您必須以執行 Calendar Server 的使用者和群組身份 (在安裝期間指定，如 icsuser 和 icsgroup)，或者以 root 身份登入。

語法

csattribute [-q|-v] -a attribute =value [-t resource | user]

[-d domain] add target

csattribute [-q|-v] -a attribute [=value ] [-t resource | user]

[-d domain] delete target

csattribute [-q | -v] [-t resource | user] [-d domain] list target

表格 D-2 說明 csattribute 可以使用的指令。

表格 D-2 csattribute 公用程式指令

指令

說明

add target

將 LDAP 屬性和值增加至指定目標 (使用者或資源物件)。

list target

列出目標物件的屬性。

delete target

從目標中刪除屬性。

version

顯示公用程式的版本。

表格 D-3 說明 csattribute 公用程式指令選項。

表格 D-3 csattribute 公用程式指令選項

選項

說明

-v

在詳細模式下執行：顯示有關正在執行的指令之所有可用資訊。預設為關閉。

-q

在無訊息模式下執行：

如果作業成功，則不顯示任何資訊 (如果發生錯誤，則會顯示錯誤資訊)。

不顯示危險指令的確認提示。

預設為關閉。

-a attribute =value

或

-a attribute [=value ]

LDAP 屬性和值︰

使用 -a 選項時，attribute 是必需的。

當 -a 選項與 add 指令一起使用時，value 是必需的；但是，當 -a 選項與 delete 和 list 指令一起使用時，value 則為選擇性的。

-t user | resource

目標類型 (使用者或資源物件)。預設為使用者。

[-d domain]

指定託管 (虛擬) 網域的名稱。預設使用 ics.conf 檔案中 service.defaultdomain 參數的值。

範例

範例 1 — 將包含 tchang 值的 icsCalendar LDAP 屬性增加至使用者 ID TChang︰

csattribute -a icsCalendar=tchang add TChang

範例 2 — 從 TChang 中刪除 LDAP 屬性 icsCalendar︰

csattribute -a icsCalendar delete TChang

範例 3 — 顯示 TChang 的屬性︰

csattribute list TChang

csbackup

csbackup 公用程式可備份行事曆資料庫、指定的行事曆或使用者的預設行事曆。指令包括︰

database，備份行事曆資料庫。

calendar，備份指定的行事曆。

defcal，備份使用者的預設行事曆。

version，顯示目前安裝之公用程式的版本號碼。

位於指定備份目錄中的 caldb.conf 版本檔案顯示已備份資料庫的版本號碼。

如需有關 csrestore 的資訊，請參閱 csrestore。

需求

Calendar Server 可以處於執行中或停止狀態。

您必須在安裝了 Calendar Server 的機器上以本地方式執行此公用程式。

在 Solaris 作業系統上，您必須以執行 Calendar Server 的使用者和群組身份 (在安裝期間指定，如 icsuser 和 icsgroup)，或者以 root 身份登入。

語法

csbackup [-q|-v] -f database target

csbackup [-q|-v] -c calid calendar target

csbackup [-q|-v] -a userid [-b basedn] defcal target

表格 D-4 說明 csbackup 可以使用的指令。

表格 D-4 csbackup 公用程式指令

指令

說明

database target

將行事曆資料庫備份至指定的目標資料庫目錄。依預設，目標資料庫目錄為︰

cal_svr_base/opt/SUNWics5/cal/sbin/target-directory

如果您僅指定目標資料庫目錄，請勿在目錄名稱前加斜線 (/)。例如：

csbackup database backupdir

注意：如果目標備份目錄已經存在且您未指定 -f 選項，則 csbackup 公用程式會失敗。例如，如果 backupdir 存在，則即使目錄為空，以下指令也會失敗︰

csbackup database backupdir

因此，如果您指定已經存在的目標備份目錄，請在執行 csbackup 時加上 -f 選項。

您也可以指定不存在的目標備份目錄，並讓 csbackup 為您建立目錄。

calendar calid target

將指定的行事曆 ID 備份至指定的目標輸出檔案。檔案的資料格式由副檔名決定，.ics 為 text/calendar 格式，.xml 為 text/xml 格式。

defcal userid target

將指定使用者 ID 的預設行事曆備份至指定的目標檔案。檔案的資料格式由副檔名決定，.ics 為 text/calendar 格式，.xml 為 text/xml 格式。

version

顯示公用程式的版本。

表格 D-5 說明 csbackup 公用程式指令選項。

表格 D-5 csbackup 公用程式指令選項

選項

說明

-v

在詳細模式下執行：顯示有關正在執行的指令之所有可用資訊。預設為關閉。

-q

在無訊息模式下執行：

如果作業成功，則不顯示任何資訊 (如果發生錯誤，則會顯示錯誤資訊)。

不顯示危險指令的確認提示。

預設為關閉。

-a userid

要備份的行事曆使用者的使用者 ID。此選項需要預設選項。無預設值。

-b basedn

要用於該使用者的基底 DN。預設使用 ics.conf 檔案中所定義 local.ugldapbasedn 設定的值。

基底 DN (識別名稱) 是 LDAP 目錄中用作搜尋起點的項目。

例如，如果您指定的基底 DN 為 ou=people, o=sesta.com，則由 Calendar Server 執行的所有 LDAP 搜尋作業將僅檢查 o=sesta.com 目錄樹中的子樹 ou=people。

-c calid

要備份的行事曆 ID。此選項需要與 calendar 指令一起使用。無預設值。

如需更多資訊，請參閱「建立行事曆唯一識別碼 (calid)」。

-f

強制所有要刪除的現有備份檔案。

在目前發行版本中，如果備份目標目錄已存在，即使該目錄為空，您也必須加上 -f 選項。

-l

準備備份檔案，以與 Solstice Backup 或 Legato Networker 備份程序配合使用。如需更多資訊，請參閱第 15 章「備份與復原 Calendar Server 資料」。

範例

將行事曆資料庫備份至名為 backupdir 的目錄︰

csbackup database backupdir

將行事曆 ID 為 tchang 的行事曆以 text/calendar 格式備份至檔案 tchang.ics︰

csbackup -c tchang calendar tchang.ics

將 tchang 的預設行事曆以 text/xml 格式備份至檔案 tchang.xml︰

csbackup -a tchang defcal tchang.xml

cscal

cscal 公用程式管理行事曆及其特性。指令包括︰

create，建立行事曆

delete，刪除行事曆

disable，停用行事曆

enable，啟用行事曆

list，列出行事曆

modify，修改行事曆特性及群組排程存取控制

reset，將行事曆特性重設為預設設定

version，顯示目前安裝之公用程式的版本號碼

需求

您必須在安裝了 Calendar Server 的機器上以本地方式執行此公用程式。

Calendar Server 可以處於執行中或停止狀態。

在 Solaris 作業系統上，您必須以執行 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]

  [-y otherowners] create|modify calid

cscal [-q|-v] [-o owner] [-O] delete|reset calid

cscal [-q|-v] [-o owner] [-O] disable|list [calid]

cscal [-q|-v] [-k yes|no] [-o owner] [-O] enable [calid]

表格 D-6 說明 cscal 公用程式可以使用的指令。

表格 D-6 cscal 公用程式指令

指令

說明

create calid

建立 calid 指定的行事曆。

注意：如果您的站點使用的是 LDAP CLD Plug-in，特定使用者的所有行事曆必須常駐在同一後端伺服器上，如使用者的 icsDWPHost LDAP 屬性所指定。如果您嘗試在其他後端伺服器上建立該使用者的行事曆，Calendar Server 將傳回錯誤。

delete calid

刪除 calid 指定的行事曆。

如果指定 -o owner 選項，則會刪除主要所有者為指定所有者的所有行事曆。

enable [calid]

啟用 calid 指定的行事曆。如果未指定 calid，則會啟用所有行事曆。

如果指定 -o owner 選項，則會啟用主要所有者為指定所有者的所有行事曆。

disable [calid]

停用 calid 指定的行事曆。如果未指定 calid，則會停用所有行事曆。

如果指定 -o owner 選項，則會停用主要所有者為指定所有者的所有行事曆。

list [calid]

列出 calid 所指定行事曆的特性。如果未指定 calid，則會列出所有行事曆的特性。

如果指定 -o owner 選項，則會列出主要所有者為指定所有者的所有行事曆。

modify calid

修改 calid 所指定行事曆的特性。

reset calid

將 calid 所指定行事曆的特性重設為預設配置設定。

version

顯示公用程式的版本。

表格 D-7 說明 cscal 公用程式指令選項。

表格 D-7 cscal 公用程式指令選項

選項

說明

-v

在詳細模式下執行：顯示有關正在執行的指令之所有可用資訊。預設為關閉。

-q

在無訊息模式下執行：

如果作業成功，則不顯示任何資訊 (如果發生錯誤，則會顯示錯誤資訊)。

不顯示危險指令的確認提示。

預設為關閉。

-a [aces]

所指定行事曆的存取控制項目 (ACE)。ACE 決定可以存取群組排程行事曆的人員，以及他們擁有的許可權類型，如建立、刪除、讀取和寫入權限。ACE 字串或存取控制清單 (ACL) 必須置於引號 (" ") 中。

預設為 ics.conf 檔案中的 calstore.calendar.default.acl 參數。

如需有關 ACE 格式的詳細資訊，請參閱行事曆管理簡介。

-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

主要所有者。預設設定為行事曆 ID (calid)，通常與使用者 ID 相同。

-O

指定主要所有者的所有行事曆。預設僅為已命名的行事曆。

-y otherowners

其他行事曆所有者。多位所有者必須置於引號 ("") 中，並以空格分隔。預設為無其他所有者。

範例

使用預設存取控制設定 (由 ics.conf 檔案中的 calstore.calendar.default.acl 定義) 建立行事曆 ID 為 tchang 的行事曆，TChang 為主要所有者，顯示名稱為 Public_Calendar︰

cscal -o TChang -n Public_Calendar create tchang

修改行事曆 chang，以便讓所有使用者都擁有讀取和寫入權限，該行事曆與類別 sports 關聯，並由 jsmith 共同所有︰

cscal -a "@^a^rw^g" -g sports -y jsmith 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

csclean

csclean 公用程式可移除其狀態屬性 (inetUserStatus) 已被 Identity Server 的 commadmin 公用程式標記為「已刪除」的 Calendar Server 使用者的使用者行事曆和資源行事曆。

刪除 Calendar Server 使用者包括以下步驟︰

執行 commadmin 公用程式的 user delete 指令，以將使用者或使用者的行事曆服務標記為「已刪除」。

執行 csclean 公用程式，以從行事曆資料庫中移除使用者的對應行事曆，並將使用者的 inetUserStatus 屬性標記為「已移除」。

執行 commadmin 公用程式的 domain purge 指令，以移除使用者的 LDAP 項目。

如需有關 commadmin 公用程式的資訊，請參閱「Sun Java System Communications Services 6 2004Q2 User Management Utility Administration Guide」。

Messaging Server 使用類似的公用程式 (msuerpurge) 從訊息儲存中移除使用者。如需有關 msuserpurge 公用程式的資訊，請參閱「Sun Java System Messaging Server 6 2004Q2 Administration Reference」。

需求

Calendar Server 可以處於執行中或停止狀態。

您必須在安裝了 Calendar Server 的機器上以本地方式執行 csclean。

在 Solaris 作業系統上，您必須以執行 Calendar Server 的使用者和群組身份 (在安裝期間指定，如 icsuser 和 icsgroup)，或者以 root 身份登入。

語法

csclean [-q | -v] [-g graceperiod] clean domain

表格 D-8 說明 csclean 公用程式指令選項。

表格 D-8 csclean 公用程式指令選項

選項

說明

-q

在無訊息模式下執行：

如果作業成功，則不顯示任何資訊 (如果發生錯誤，則會顯示錯誤資訊)。

不顯示危險指令的確認提示。

預設為關閉。

-v

在詳細模式下執行：顯示有關正在執行的指令之所有可用資訊。預設為關閉。

-g graceperiod

指定為使用者刪除行事曆服務以後經過的天數。

預設為 10 天。

範例

移除 sesta.com 中行事曆服務被刪除 5 天以上的所有使用者和資源的行事曆︰

csclean -g 5 clean sesta.com

移除所有網域中行事曆服務被刪除 10 天以上的所有使用者和資源的行事曆︰

csclean -g 10 clean "*"

cscomponents

cscomponents 公用程式管理行事曆元件︰事件和工作 (待辦事項)。指令包括︰

delete，刪除行事曆中的事件和工作。

list，列出行事曆中的事件和工作。

version，顯示目前安裝之公用程式的版本號碼。

需求

您必須在安裝了 Calendar Server 的機器上以本地方式執行此公用程式。

Calendar Server 可以處於執行中或停止狀態。

在 Solaris 作業系統上，您必須以執行 Calendar Server 的使用者和群組身份 (在安裝期間指定，如 icsuser 和 icsgroup)，或者以 root 身份登入。

語法

cscomponents [-v|-q] [-e endtime] [-s starttime] [-t event|task]

  delete|list calid

表格 D-9 說明 cscomponents 公用程式可以使用的指令。

表格 D-9 cscomponents 公用程式指令

指令

說明

delete calid

刪除包含指定行事曆 ID 的行事曆中的事件和工作。

list calid

列出包含指定行事曆 ID 的行事曆中的事件和工作。

version

將公用程式的版本顯示在螢幕上。

表格 D-10 說明 cscomponents 公用程式指令選項。

表格 D-10 cscomponents 公用程式指令選項

選項

說明

-v

在詳細模式下執行：顯示有關正在執行的指令之所有可用資訊。預設為關閉。

-q

在無訊息模式下執行：

如果作業成功，則不顯示任何資訊 (如果發生錯誤，則會顯示錯誤資訊)。

不顯示危險指令的確認提示。

預設為關閉。

-e endtime

元件的結束時間。結束時間為 0 表示不限制結束時間。預設為 0。

-s starttime

元件的起始時間。起始時間為 0 表示不限制起始時間。預設為 0。

-t event|task

在其上執行動作之元件 (事件或工作) 的類型。預設為兩者。

範例

刪除行事曆 ID 為 tchang 的行事曆中的所有 2000 個事件︰

cscomponents -s 20000101T000000Z -e 20001231T000000Z delete tchang

列出行事曆 ID 為 tchang 的行事曆中的所有事件和工作的詳細資訊︰

cscomponents -v list tchang

csdb

csdb 公用程式管理行事曆資料庫 (行事曆、階段作業和統計資料)。指令包括︰

create，建立新資料庫。(如果伺服器啟動時資料庫不存在，Calendar Server 會自動建立一個。)

delete，刪除現有的行事曆資料庫。資料庫在開啟時 (Calendar Server 在執行時) 無法被刪除。

list，列出有關資料庫的資訊。

check，檢查行事曆資料庫以確定是否發生損毀。

rebuild，重建損毀的行事曆資料庫。

recover，回復損毀的行事曆資料庫。

version，顯示目前安裝之公用程式的版本號碼。

需求

您必須在安裝了 Calendar Server 的機器上以本地方式執行此公用程式。

必須停止 Calendar Server，然後才能執行 create、delete 或 rebuild 指令。

在 Solaris 作業系統上，您必須以執行 Calendar Server 的使用者和群組身份 (在安裝期間指定，如 icsuser 和 icsgroup)，或者以 root 身份登入。

語法

csdb [-q|-v] [-t caldb|sessdb|statdb] create|delete [dbdir]

csdb [-q|-v] [-t caldb|sessdb|statdb] list [dbdir]

csdb [-q|-v] [-f] [-t caldb|sessdb|statdb] recover [dbdir]

csdb check [dbdir]

csdb rebuild [-g] [dbdir [dstdir]]

表格 D-11 說明 csdb 公用程式可以使用的指令。

表格 D-11 csdb 公用程式指令

指令

說明

create [dbdir]

在指定的資料庫目錄中建立資料庫。如果未指定資料庫目錄，則使用目前目錄。如果伺服器啟動時資料庫不存在，Calendar Server 會自動建立一個。

delete [dbdir]

刪除指定資料庫目錄中的資料庫。如果未指定資料庫目錄，則使用目前目錄。資料庫在開啟時 (Calendar Server 在執行時) 無法被刪除。

list [dbdir]

列出有關指定資料庫目錄之資料庫的資訊。如果未指定資料庫目錄，則使用目前目錄。

recover [dbdir]

嘗試回復指定資料庫目錄中損毀的資料庫。如果未指定資料庫目錄，則使用目前目錄。

check [dbdir]

掃描指定資料庫目錄中的行事曆資料庫，以確定是否發生損毀，並在其輸出中報告結果。如果未指定資料庫目錄，則使用目前目錄。

rebuild [-g] [dbdir [dstdir]]

掃描指定資料庫目錄中的行事曆資料庫，以確定是否發生損毀，並產生重建的行事曆資料庫 (.db 檔案)。如果未指定資料庫目錄，則使用目前目錄。

除其他行事曆資料庫之外，-g 選項還可重建群組排程引擎 (GSE) 資料庫，dstdir 可指定選擇性的目標目錄。

version

顯示公用程式的版本。

表格 D-12 說明 csdb 公用程式指令選項。

表格 D-12 csdb 公用程式指令選項

選項

說明

-v

在詳細模式下執行：顯示有關正在執行的指令之所有可用資訊。預設為關閉。

-q

在無訊息模式下執行：

如果作業成功，則不顯示任何資訊 (如果發生錯誤，則會顯示錯誤資訊)。

不顯示危險指令的確認提示。

預設為關閉。

-f

強制回復行事曆資料庫。

-g

對於 rebuild 指令，除其他行事曆資料庫之外，還可重建群組排程引擎 (GSE) 資料庫。

-t caldb|sessdb|statdb

指定目標資料庫：

caldb (行事曆)

sessdb (階段作業)

statdb (統計資料)

注意：如果未指定 -t，csdb 將在所有資料庫上作業，但 check 和 rebuild 指令除外，它們僅在 caldb (行事曆) 上作業。

範例

在目前目錄中建立新的、未移入的資料庫︰

csdb -t caldb create

刪除目前目錄中的資料庫：

csdb -t caldb delete

列出有關目前目錄中之行事曆資料庫的資訊：

csdb -v -t caldb list

嘗試回復目前目錄中所有損毀的資料庫︰

csdb recover

列出有關目前目錄中之階段作業資料庫的資訊：

csdb -t sessdb list

嘗試回復目前目錄中損毀的統計資料庫︰

csdb -t statdb recover

csdomain

csdomain 公用程式可管理 LDAP 目錄中託管 (虛擬) 網域的 Calendar Server 屬性。這些屬性是 icsCalendarDomain 物件類別的一部分。指令包括︰

create，在 LDAP 目錄中建立新的託管網域。

add，在 LDAP 目錄中為特定託管網域新增 Calendar Server 屬性及其關聯值。

delete，在 LDAP 目錄中為特定託管網域刪除某個 Calendar Server 屬性，或刪除整個託管網域。

list，列出 LDAP 目錄中特定託管網域的 Calendar Server 屬性。

需求

您必須在託管 (虛擬) 網域模式中執行 csdomain。即，必須設定 ics.conf 檔案中的以下參數︰

必須將 service.virtualdomain.support 設定為 yes。

必須將 local.schemaversion 設定為 LDAP 模式的版本 (1 或 2)。

如果 local.schemaversion = 1，則必須將 service.dcroot 設定為 LDAP 目錄中 DC 樹的根目錄字尾。

如果 local.schemaversion = 2，則必須將 service.schema2root 設定為其下包含所有網域的根目錄字尾。

您必須在安裝了 Calendar Server 的機器上以本地方式執行 csdomain。

Calendar Server 可以處於執行中或停止狀態。

在 Solaris 作業系統上，您必須以執行 Calendar Server 的使用者和群組身份 (在安裝期間指定，如 icsuser 和 icsgroup)，或者以 root 身份登入。

語法

csdomain [-q | -v] -n node create domain

csdomain [-q | -v] {-a attr[=value] | -f filename} add domain

csdomain [-q | -v] [-a attr | -f filename] delete domain

csdomain [-q | -v] list domain

表格 D-13 說明 csdomain 公用程式可以使用的指令。

表格 D-13 csdomain 公用程式指令

指令

說明

create

在 LDAP 目錄中建立新的託管網域。網域的所有 Calendar Server 使用者和資源均建立在目錄的此項目之下。

add

在 LDAP 目錄中為特定網域增加 Calendar Server 屬性及其關聯值。如果您使用 csdomain 增加或更新網域 LDAP 屬性，請重新啟動 Calendar Server 以使新值生效。

delete

在 LDAP 目錄中為特定託管網域刪除某個 Calendar Server 屬性，或刪除整個網域的所有 LDAP 項目。

list

顯示 LDAP 目錄中特定網域的 Calendar Server 屬性。

version

顯示公用程式的版本。

表格 D-14 說明 csdomain 公用程式指令選項。

表格 D-14 csdomain 公用程式指令選項

選項

說明

-v

在詳細模式下執行：顯示有關正在執行的指令之所有可用資訊。預設為關閉。

-q

在無訊息模式下執行：

如果作業成功，則不顯示任何資訊 (如果發生錯誤，則會顯示錯誤資訊)。

不顯示危險指令的確認提示。

預設為關閉。

-a attr[=value]

指定 LDAP 屬性的特性名稱及其選擇性值。

如需這些屬性和特性名稱的清單，請參閱「LDAP 屬性和特性名稱」。

-f filename

指定包含 Calendar Server LDAP 目錄的特性名稱及其關聯值的文字檔案。例如：

createLowerCase="yes"
filterPrivateEvents="no"
fbIncludeDefCal="no"
subIncludeDefCal="no"
uiProxyUrl="https://proxyserver"

-n node

套用至 create 指令，如下所示︰

對於 LDAP 模式 1 - 指定在其下建立所有使用者和資源的節點。例如：o=node2,o=node1,o=sesta

對於 LDAP 模式 2 - 指定為該網域建立之節點的名稱。例如：o=west.sesta.com

如果未指定節點，則使用網域名稱。

網域

對於 add、delete 和 list 指令，指定 LDAP 目錄中的現有網域。

對於 create 指令，指定將要在 LDAP 目錄中建立之新網域的唯一名稱。

例如：west.sesta.com

LDAP 屬性和特性名稱

以下表格說明適用於 csdomain 公用程式的 LDAP 屬性和特性名稱。這些屬性是 icsCalendarDomain 物件類別的一部分。增加或刪除值時，您必須使用特性名稱，而不是屬性名稱。

icsAllowRights 屬性︰csdomain 公用程式

icsExtendedDomainPrefs 屬性︰csdomain 公用程式

其他 LDAP 目錄屬性︰csdomain 公用程式

如果您使用 csdomain 增加或更新網域 LDAP 屬性，請重新啟動 Calendar Server 以使新值生效。

icsAllowRights 屬性︰csdomain 公用程式

表格 D-15 說明您可以使用 csdomain 公用程式設定的 icsAllowRights 屬性和特性。該屬性為 32 位元的數字字串，字串中的每個位元均對應於特定使用者權限。(在目前發行版本中，某些位元不使用，並依預設被設定為零。) 如果設定了對應於某特定權限的位元 (值 = 1)，則不允許該權限。如果未設定該位元 (值 = 0)，則允許該權限。

icsAllowRights 屬性中的每個特性均具有對應的 ics.conf 參數。如果未設定特性 (值 = 0) 或特性不存在 (service.virtualdomain.support = "no")，則 Calendar Server 將使用對應的 ics.conf 參數作為預設值。

icsAllowRights 的值是數字字串，而不是整數。若要透過程序設計將 icsAllowRights 用於逐位元作業，您必須先將其字串值轉換為整數。

表格 D-15 icsAllowRights LDAP 目錄屬性和特性

位元

特性名稱

說明

0

allowCalendarCreation

如果設定 (位元 0 = 1)，則不允許建立行事曆。

對應的 ics.conf 參數為︰

service.wcap.allowcreatecalendars

1

allowCalendarDeletion

如果設定 (位元 1 = 1)，則不允許刪除行事曆。

對應的 ics.conf 參數為︰

service.wcap.allowdeletecalendars

2

allowPublicWritableCalendars

如果設定 (位元 2 = 1)，則不允許公用的可寫入行事曆。

對應的 ics.conf 參數為︰

service.wcap.allowpublicwriteablecalendars

3

n/a

在目前發行版本中不使用。

4

allowModifyUserPreferences

如果設定 (位元 4 = 1)，則不允許網域管理員使用 WCAP 指令取得或設定使用者喜好設定。

對應的 ics.conf 參數為︰

service.admin.calmaster.wcap.allowgetmodifyuserprefs

5

allowModifyPassword

如果設定 (位元 5 = 1)，則不允許使用者經由此伺服器變更密碼。

對應的 ics.conf 參數為︰

service.wcap.allowchangepassword

6,7

n/a

在目前發行版本中不使用。

8

allowUserDoubleBook

如果設定 (位元 8 = 1)，則不允許使用者行事曆的雙預定。

對應的 ics.conf 參數為︰

user.allow.doublebook

9

allowResourceDoubleBook

如果設定 (位元 9 = 1)，則不允許資源行事曆的雙預定。

對應的 ics.conf 參數為︰

resource.allow.doublebook

10

allowSetCn

如果設定 (位元 10 = 1)，則不允許使用者使用 WCAP 的 set_userprefs 指令設定一般名稱 (cn) 屬性。

對應的 ics.conf 參數為︰

service.wcap.allowsetprefs.cn

11

allowSetGivenName

如果設定 (位元 11 = 1)，則不允許使用者使用 WCAP 的 set_userprefs 指令設定 givenName 屬性。

對應的 ics.conf 參數為︰

service.wcap.allowsetprefs.givenname

12

allowSetGivenMail

如果設定 (位元 12 = 1)，則不允許使用者使用 WCAP 的 set_userprefs 指令設定 mail 屬性。

對應的 ics.conf 參數為︰

service.wcap.allowsetprefs.mail

13

allowSetPrefLang

如果設定 (位元 13 = 1)，則不允許使用者使用 WCAP 的 set_userprefs 指令設定 preferredLanguage 屬性。

對應的 ics.conf 參數為︰

service.wcap.allowsetprefs.preferredlanguage

14

allowSetSn

如果設定 (位元 14 = 1)，則不允許使用者使用 WCAP 的 set_userprefs 指令設定姓氏 (sn) 屬性。

對應的 ics.conf 參數為︰

service.wcap.allowsetprefs.sn

15

如果設定 (位元 15 = 1)，則不允許使用者使用 WCAP 的 set_userprefs 指令設定使用者的預設行事曆 ID (nswccalid)。

對應的 ics.conf 參數為︰

service.wcap.allowsetprefs.nswccalid

16-31

n/a

在目前發行版本中不使用。

icsExtendedDomainPrefs 屬性︰csdomain 公用程式

表格 D-16 說明您可以使用 csdomain 公用程式設定的 icsExtendedDomainPrefs 屬性和特性。每個特性均具有對應的 ics.conf 參數。如果未設定特性 (值 = 0) 或特性不存在 (service.virtualdomain.support = "no")，則 Calendar Server 將使用對應的 ics.conf 參數作為預設值。

表格 D-16 icsExtendedDomainPrefs LDAP 目錄屬性

特性名稱

說明

allowProxyLogin

指定 "yes" 或 "no" 以表示是否允許代理登入。

對應的 ics.conf 參數為︰

service.http.allowadminproxy (預設 = "no")

calmasterAccessOverride

指定 "yes" 或 "no" 以表示 Calendar Server 管理員是否可以置換存取控制。

對應的 ics.conf 參數為︰

service.admin.calmaster.overrides.accesscontrol (預設 = "no")

calmasterCred

指定一個 ASCII 字串，該字串是被指定為 Calendar Server 網域管理員之使用者 ID 的密碼。

對應的 ics.conf 參數為︰

service.admin.calmaster.cred (無預設值)

calmasterUid

指定一個 ASCII 字串，該字串是被指定為 Calendar Server 網域管理員的使用者 ID。

對應的 ics.conf 參數為︰

service.admin.calmaster.userid (無預設值)

createLowercase

指定 "yes" 或 "no" 以表示在建立新行事曆或搜尋行事曆時，Calendar Server 是否應將行事曆 ID (calid) 轉換為小寫。

對應的 ics.conf 參數為︰

calstore.calendar.create.lowercase (預設 = "no")

domainAccess

指定網域的存取控制清單 (ACL)。如需有關 ACL 的資訊，請參閱存取控制清單 (ACL)。

此 ACL 用於跨網域搜尋。如需更多資訊，請參閱交叉網域搜尋。

fbIncludeDefCal

指定 "yes" 或 "no" 以表示使用者的預設行事曆是否包含在使用者的空閒/忙碌行事曆清單中。

對應的 ics.conf 參數為︰

calstore.freebusy.include.defaultcalendar (預設 = "yes")

filterPrivateEvents

指定 "yes" 或 "no" 以表示 Calendar Server 是否過濾 (識別) 私人與只有時間和日期 (機密) 的事件和工作。如果為 "no"，則 Calendar Server 將它們視為公開事件和工作。

對應的 ics.conf 參數為︰

calstore.filterprivateevents (預設 = "yes")

groupMaxSize

指定展開事件時 LDAP 群組中所允許的與會人員的最大數目。

對應的 ics.conf 參數為︰

calstore.group.attendee.maxsize (預設為 "0"- 完全展開群組)

language

指定網域的語言。

對應的 ics.conf 參數為︰

local.domain.language

resourceDefaultAcl

指定一個存取控制清單 (ACL)，該清單為建立資源行事曆時所使用的預設存取控制權限。

對應的 ics.conf 參數為︰

resource.default.acl (預設為 "@@o^a^r^g;@@o^c^wdeic^g;@^a^rsf^g")

setPublicRead

指定使用者預設行事曆最初被設定為公開讀取/私人寫入 ("yes")，還是私人讀取/私人寫入 ("no")。

對應的 ics.conf 參數為︰

service.wcap.login.calendar.publicread (預設 = "no")

searchFilter

指定搜尋過濾器以尋找使用者。

對應的 ics.conf 參數為︰

local.userSearchFilter

ssoCookieDomain

指定瀏覽器應將 cookie 僅傳送至指定網域中的伺服器。值必須以句點 (.) 開頭。例如：".sesta.com"

對應的 ics.conf 參數為︰

sso.cookiedomain (預設為目前網域)

ssoUserDomain

指定用作使用者 SSO 認證一部分的網域。

對應的 ics.conf 參數為︰

sso.userdomain (無預設值)

subIncludeDefCal

指定 "yes" 或 "no" 以表示使用者的預設行事曆是否包含在使用者的訂閱行事曆清單中。

對應的 ics.conf 參數為︰

calstore.subscribed.include.defaultcalendar (預設 = "yes")

uiAllowAnyone

指定 "yes" 或 "no" 以表示 Calendar Express 是否應顯示並使用「所有使用者」存取控制清單 (ACL)。

對應的 ics.conf 參數為︰

ui.allow.anyone (預設 = "yes")

uiAllowDomain

指定 "yes" 或 "no" 以表示 Calendar Express 是否應顯示並使用此網域的存取控制清單 (ACL)。

對應的 ics.conf 參數為︰

ui.allow.domain (預設 = "no")

uiBaseUrl

指定基底伺服器位址的 URL。例如："https://proxyserver"。

對應的 ics.conf 參數為︰

ui.base.url (無預設值)

uiConfigFile

指定基於 xml 的選擇性配置檔案，該檔案可由 Calendar Server 在啟動時讀取，並允許使用者介面的某些部分被隱藏。

對應的 ics.conf 參數為︰

ui.config.file (無預設值)

uiProxyURL

指定要在 HTML UI JavaScript 檔案中前置的代理伺服器位址的 URL。例如："https://web_portal.sesta.com/"

對應的 ics.conf 參數為︰

ui.proxyaddress.url (無預設值)

其他 LDAP 目錄屬性︰csdomain 公用程式

表格 D-17 說明您可以使用 csdomain 公用程式設定的其他 LDAP 屬性和特性。

表格 D-17 csdomain 公用程式的其他 LDAP 目錄屬性

LDAP 屬性

特性名稱

說明

icsAllowedServiceAccess

allowedAccessProtocols

指定是否允許存取 Calendar Server。如果設定為「http」，則拒絕存取。如果設定為其他任何值，則允許存取。

僅在未設定 icsStatus 屬性時，Calendar Server 才使用此屬性。

icsDefaultAccess

userDefaultAcl

為新建立的使用者行事曆指定 ACL。

對應的 ics.conf 參數為︰

calstore.calendar.default.acl

icsDomainNames

searchDomainNames

指定在尋找行事曆或使用者時此網域可以搜尋的外部網域。

對應的 ics.conf 參數為︰無

icsDWPBackEndHosts

指定未明確提供主機名稱時，使用者的預設後端主機 (DNS 名稱)。此屬性在 Calendar Server 處於 LDAP CLD 模式時使用。

icsStatus

statusCalendarDomain

指定 Calendar Server 的狀態︰

active - Calendar Server 可以存取。

inactive - Calendar Server 不可以存取。行事曆保留在資料庫中，並且 Calendar Server LDAP 屬性保持不變。

deleted - Calendar Server 不可以存取，因為人員被標記為已刪除。

removed - 行事曆已從行事曆資料庫中被移除。

如果設定 icsStatus，其值將置換 icsAllowedServiceAccess 屬性。

如果未設定 icsStatus，Calendar Server 將使用 icsAllowedServiceAccess 屬性。

icsTimezone

timezone

指定匯入檔案時使用的時區 ID。例如，America/New_York 或 Asia/Tokyo。

如需所支援時區的資訊，請參閱 timezones.ics 檔案。

範例

使用名為 west.sesta.com 的 LDAP 模式 1 建立新的託管網域︰

csdomain -v -n o=nodewest,o=sesta create west.sesta.com

使用名為 east.sesta.com 的 LDAP 模式 2 建立新的託管網域︰

csdomain -v -n nodeeast create east.sesta.com

顯示名為 west.sesta.com 之託管網域的 Calendar Server LDAP 屬性清單︰

csdomain -v list west.sesta.com

將名為 west.sesta.com 之託管網域的時區設定為 America/New_York︰

csdomain -v -a icsTimezone=America/New_York add west.sesta.com

csexport

csexport 公用程式可將行事曆匯出至 iCalendar (.ics) 或 XML (.xml) 格式的檔案。指令包括︰

calendar，匯出指定的行事曆。

version，顯示目前安裝之公用程式的版本號碼。

需求

您必須在安裝了 Calendar Server 的機器上以本地方式執行此公用程式。

Calendar Server 可以處於執行中或停止狀態。

在 Solaris 作業系統上，您必須以執行 Calendar Server 的使用者和群組身份 (在安裝期間指定，如 icsuser 和 icsgroup)，或者以 root 身份登入。

語法

csexport [-v|-q] -c calid calendar outputfile

表格 D-18 說明 csexport 公用程式可以使用的指令。

表格 D-18 csexport 公用程式指令

指令

說明

calendar outputfile

將行事曆匯出至指定的輸出檔案。檔案的資料格式由指定檔案名稱的副檔名決定︰

.ics 為 iCalendar (text/calendar) 格式

.xml 為 XML (text/xml) 格式

version

顯示公用程式的版本。

表格 D-19 說明 csexport 公用程式指令選項。

表格 D-19 csexport 公用程式指令選項

選項

說明

-v

在詳細模式下執行：顯示有關正在執行的指令之所有可用資訊。預設為關閉。

-q

在無訊息模式下執行：

如果作業成功，則不顯示任何資訊 (如果發生錯誤，則會顯示錯誤資訊)。

不顯示危險指令的確認提示。

預設為關閉。

-c calid

要匯出的行事曆之行事曆 ID。此選項需要與 calendar 指令一起使用。無預設值。

範例

將行事曆 ID 為 tchang 的行事曆以 iCalendar (text/calendar) 格式匯出至名為 tchang.ics 的檔案︰

csexport -c tchang calendar tchang.ics

將行事曆 ID 為 tchang 的行事曆以 XML (text/xml) 格式匯出至名為 tchang.xml 的檔案︰

csexport -c tchang calendar tchang.xml

csimport

csimport 公用程式可從 csexport 公用程式儲存的 iCalendar (ics) 或 XML 格式的檔案匯入行事曆。指令包括︰

calendar，匯入指定的行事曆。

version，顯示目前安裝之公用程式的版本號碼。

需求

您必須在安裝了 Calendar Server 的機器上以本地方式執行此公用程式。

Calendar Server 可以處於執行中或停止狀態。

在 Solaris 作業系統上，您必須以執行 Calendar Server 的使用者和群組身份 (在安裝期間指定，如 icsuser 和 icsgroup)，或者以 root 身份登入。

語法

csimport [-v|-q] -c calid calendar inputfile

表格 D-20 說明 csimport 公用程式可以使用的指令。

表格 D-20 csimport 公用程式指令

指令

說明

calendar inputfile

從指定的輸入檔案匯入行事曆。檔案的資料格式由檔案名稱的副檔名決定︰

.ics 為 iCalendar (text/calendar) 格式

.xml 為 XML (text/xml) 格式

version

顯示公用程式的版本。

表格 D-21 說明 csimport 公用程式指令選項。

表格 D-21 csimport 公用程式指令選項

選項

說明

-v

在詳細模式下執行：顯示有關正在執行的指令之所有可用資訊。預設為關閉。

-q

在無訊息模式下執行：

如果作業成功，則不顯示任何資訊 (如果發生錯誤，則會顯示錯誤資訊)。

不顯示危險指令的確認提示。

預設為關閉。

-c calid

要匯入的行事曆之行事曆 ID。此選項需要與 calendar 指令一起使用。

如果指定的行事曆 ID 已經存在，則匯入的資料將併入目前行事曆。無預設值。

如需更多資訊，請參閱建立行事曆唯一識別碼 (calid)。

範例

從檔案 tchang.ics 匯入行事曆 ID 為 tchang 的行事曆，並使用 iCalendar (text/calendar 檔案) 格式︰

csimport -c tchang calendar tchang.ics

從檔案 tchang.xml 匯入行事曆 ID 為 tchang 的行事曆，並使用 XML (text/xml 檔案) 格式︰

csimport -c tchang calendar tchang.xml

csmonitor

csmonitor 公用程式為執行以下監視功能的程序檔：

根據特定 ics.conf 參數檢查 LDAP 連線。

檢查異動日誌檔，如果存在多個檔案，csmonitor 會透過電子郵件傳送警告訊息。

檢查行事曆資料庫的可用磁碟空間。

語法

csmonitor [ -k | -c | -help]

表格 D-22 說明 csmonitor 公用程式的指令。

表格 D-22 csmonitor 公用程式指令選項

參數

說明

-k

停止 csmonitor。

-c

備份並清除 csmonitor 日誌。

-help

顯示 csmonitor 的用法。

表格 D-23 csmonitor。

表格 D-23 csmonitor 配置參數

參數

說明

service.monitor.continuous

指定 csmonitor 是否應持續迴圈︰

"0" - 不持續迴圈。

"1" - 持續迴圈。

此選項需要較多的系統資源，但在除錯模式下十分有用。

預設為 "0"。

service.monitor.loopsdelay

指定兩個監視迴圈之間的延遲 (以秒為單位)。預設為 "60"。

service.monitor.emailaddress.from

指定 csmonitor 傳送訊息的電子郵件位址。預設為無。

service.monitor.emailaddress.to

指定 csmonitor 應將訊息傳送至的電子郵件位址。預設為無。

service.monitor.csdb.logthreshold

指定被視為正常的最大磁碟佔用率的臨界值 (以總磁碟空間的百分比表示)。如果行事曆資料庫 (csdb 目錄) 所在磁碟的佔用率超出此值，csmonitor 將傳送警告電子郵件訊息。

預設為 "90"。

logfile.monitor.logname

指定 csmonitor 日誌檔名稱。

預設為 "csmonitor.log"。

logfile.monitor.maxlogfilesize

指定日誌檔的最大大小。如果日誌檔超出此大小，csmonitor 會將日誌儲存為 csmonitor.log.timestamp，並重設日誌。

預設為 "2097152"。

service.monitor.dbglevel

指定除錯級別。此值越高，csmonitor 傳送的訊息就越精確、越詳細。

預設為 "0"。

csplugin

csplugin 可管理為您的 Calendar Server 安裝所配置的 CSAPI Plug-in。指令包括︰

activate，載入和啟動指定的 Plug-in。

deactivate，關閉和停用指定的 Plug-in 類型和 Plug-in 名稱。(如需支援的 Plug-in 類型的說明，請參閱表格 D-25 中的「-t」選項。)

list，顯示所有支援的 Plug-in。

version，顯示目前安裝之公用程式的版本號碼。

需求

必須在安裝了 Calendar Server 的本地機器上執行。

Calendar Server 可以處於執行中或停止狀態。

在 Solaris 作業系統上，您必須以執行 Calendar Server 的使用者和群組身份 (在安裝期間指定，如 icsuser 和 icsgroup)，或者以 root 身份登入。

語法

csplugin [-q|-v] [-r] -t ac|attr|auth|locate|lookup|xlate

  activate|deactivate plugin

csplugin [-q|-v] list

表格 D-24 說明 csplugin 公用程式可以使用的指令。

表格 D-24 csplugin 公用程式指令

指令

說明

activate -t type name

載入和啟用指定的 Plug-in 類型和 Plug-in 名稱。(如需支援的 Plug-in 類型的說明，請參閱表格 D-25 中的「-t」選項。)

deactivate -t type name

關閉和停用指定的 Plug-in 類型和 Plug-in 名稱。(如需支援的 Plug-in 類型的說明，請參閱表格 D-25 中的「-t」選項。)

list

列出所有支援的 Plug-in 類型、名稱和啟動狀態。(如需支援的 Plug-in 類型的說明，請參閱表格 D-25 中的「-t」選項。)

version

顯示公用程式的版本。

表格 D-25 說明 csplugin 公用程式指令選項。

表格 D-25 csplugin 公用程式指令選項

選項

說明

-v

在詳細模式下執行：顯示有關正在執行的指令之所有可用資訊。預設為關閉。

-q

在無訊息模式下執行：

如果作業成功，則不顯示任何資訊 (如果發生錯誤，則會顯示錯誤資訊)。

不顯示危險指令的確認提示。

預設為關閉。

-r

與 activate 指令一起使用時，可將 Plug-in 實體複製到 Calendar Server Plug-in 目錄。

與 deactivate 指令一起使用時，可從 Plug-in 目錄刪除 Plug-in。

-t type

指定 Plug-in 的以下支援的類型之一︰

ac 增加或置換預設群組排程存取控制機制。

attr 增加或置換儲存與擷取使用者屬性的機制。

auth - 增加或置換登入認證機制。

locate - 擷取指定的合格 URL 之行事曆 ID。

lookup - 增加或置換預設行事曆查找機制。

xlate - 增加或置換進來和外送資料的格式轉換。

範例

列出有關所有支援的 Plug-in 之詳細資訊，包括配置為與該伺服器實例配合使用的每個 Plug-in 的類型、名稱和啟動狀態︰

csplugin -v list

載入並啟用名為 mylookup 的檔案之 lookup 類型 Plug-in︰

csplugin activate -t lookup mylookup

停用名為 mylookup 的檔案之 lookup 類型 Plug-in，然後將其從 plugin 目錄刪除：

csplugin deactivate -t lookup mylookup -r

cspurge

cspurge 公用程式允許手動清除刪除日誌資料庫 (ics50deletelog.db) 中的項目。

需求

您必須在安裝了 Calendar Server 的機器上以本地方式執行此公用程式。

Calendar Server 可以處於執行中或停止狀態。

在 Solaris 作業系統上，您必須以執行 Calendar Server 的使用者和群組身份 (在安裝期間指定，如 icsuser 和 icsgroup)，或者以 root 身份登入。

語法

cspurge [-q|-v] -e endtime -s starttime

表格 D-26 說明 cspurge 公用程式指令選項。

表格 D-26 cspurge 公用程式指令選項

選項

說明

-v

在詳細模式下執行：顯示有關正在執行的指令之所有可用資訊。預設為關閉。

-q

在無訊息模式下執行：

如果作業成功，則不顯示任何資訊 (如果發生錯誤，則會顯示錯誤資訊)。

不顯示危險指令的確認提示。

預設為關閉。

-e endtime

指定 GMT (亦稱為 UTC 或祖魯) 格式的結束時間。此值最大為 (小於) 指定時間。

預設為 0，表示不限制結束時間。

-s starttime

指定 GMT (亦稱為 UTC 或祖魯) 格式的起始時間。此值包含 (大於或等於) 指定時間。

預設為 0，表示不限制起始時間。

範例

清除刪除日誌中的所有項目︰

cspurge -v -e 0 -s 0

清除 2003 年 7 月 1 日至 2003 年 7 月 31 日之間的所有項目︰

cspurge -v -e 20030731T235959Z -s 20030701T120000Z

清除 2003 年 9 月 30 日之前的所有項目︰

cspurge -v -e 20031030T235959Z -s 0

csrename

csrename 公用程式可讓您重新命名一位或多位行事曆使用者。此公用程式將重新命名行事曆使用者，如下所示：

行事曆資料庫檔案 - 重新命名行事曆資料庫檔案中的使用者 (使用者 ID)，然後將新的資料庫檔案寫入目標目錄。現有行事曆資料庫檔案不會被修改。

LDAP 目錄伺服器 - 轉換 Calendar Server LDAP 屬性中的使用者 ID (即帶「ics」字首的屬性)。系統會適當地修改 LDAP 目錄伺服器。

csrename 公用程式位於以下目錄中：

cal_svr_base/opt/SUNWics5/cal/sbin

需求

執行 csrename 之前，您必須首先執行以下作業：

為您要轉換的使用者建立輸入對映檔案 (-m 選項)。

如有必要，佈建 LDAP 目錄伺服器中的所有新使用者。

停止 Calendar Server。

若要執行 csrename，必須以 icsuser 的身份 (或以配置期間指定的 Calendar Server 運行時間使用者 ID 的身份) 登入。如果您以超級使用者 (root) 的身份執行 csrename，則可能需要重設新資料庫檔案的權限。若要修改 LDAP 目錄伺服器屬性，還必須具有該目錄的管理權限。

如果您的 Calendar Server 安裝具有前端/後端伺服器配置，則必須在每台後端伺服器上執行 csrename。

語法

請使用以下語法來執行 csrename：

csrename [-t DestinationDB ] [-c ConfigFile ] [-e ErrorFile ] -m MappingFile rename [DB|LDAP]

下表列出了該公用程式的選項並對各選項進行了說明：

表格 D-27 csrename 的選項

選項

說明

-t DestinationDB

指定 csrename 產生包含轉換的使用者名稱的新資料庫所在的目標目錄。預設為 MigratedDB。csrename 完成後，ics.conf 檔案中的 caldb.berkeleydb.homedir.path 參數必須指向目標資料庫。可以重設 caldb.berkeleydb.homedir.path 以指向目標資料庫目錄，也可以將目標資料庫檔案移至該參數所指定的目錄。

-c ConfigFile ics.conf

一個輸入參數，可指定 Calendar Server 配置檔案。預設為 ics.conf 檔案。csrename 使用配置檔案中的 caldb.berkeleydb.homedir.path 參數，以決定輸入行事曆資料庫的位置。行事曆資料庫的預設位置為 cal_svr_base/var/opt/SUNWics5/csdb。

-e ErrorFile

csrename 在其中寫入所有錯誤或無法解決的資料庫項目的檔案。預設為 MigrateError。

-m MappingFile

指定輸入對映檔案。預設為 MigrateMapping。輸入對映檔案是文字檔案，可將現有使用者 ID 對映至新使用者 ID。執行 csrename 之前，必須先建立對映檔案。每一行指定一個項目，新舊值之間用空格分隔。

例如：

tchang tc897675
jsmith js963123
bkamdar bk548769

如果在稽核搜索結果時發現一個或多個要變更的名稱被忽略，您可以透過建立僅包含遺漏名稱的新對映檔案和重新執行 csrename 來修正該錯誤。

DB|LDAP

指定要進行更新的資料庫：

DB 僅轉換新行事曆資料庫中的使用者 ID (預設)。

LDAP 同時轉換新行事曆資料庫和 LDAP 目錄伺服器屬性中的使用者 ID。

範例

根據名為 DBMapFile 的對映檔案重新命名使用者，並在目標目錄中建立名為 newcalDB 的新行事曆資料庫：

csrename -t newcalDB -m DBMapFile rename DB

根據名為 NewNames 的對映檔案中的值重新命名使用者，在目標目錄中建立名為 NewDB 的新行事曆資料庫，並修改 LDAP 目錄伺服器中的 Calendar Server 屬性：

csrename -t NewDB -m NewNames rename LDAP

csresource

csresource 公用程式可管理 LDAP 伺服器和 Calendar Server 資料庫中儲存的資源 (如會議室或設備) 的行事曆。 (csresource 公用程式僅可用於與資源關聯的行事曆，如果針對使用者的行事曆使用此公用程式，會傳回錯誤。)指令包括︰

create，為指定的行事曆 ID (calid) 增加資源

delete，移除一個資源或所有資源

disable，停用一個資源或所有資源

enable，啟用一個資源或所有資源

list，顯示單一資源或所有資源的清單

需求

您必須在安裝了 Calendar Server 的機器上以本地方式執行此公用程式。

Calendar Server 可以處於執行中或停止狀態。

在 Solaris 作業系統上，您必須以執行 Calendar Server 的使用者和群組身份 (在安裝期間指定，如 icsuser 和 icsgroup)，或者以 root 身份登入。

語法

csresource [-q|-v] [-a aces] [-b basedn] [-d domain] [-t description] [-k yes|no] [-o owner] [-y otherowners] -m email -c calid create name

csresource [-q|-v] [-b basedn] [-d domain]

delete|disable|enable [name]

csresource [-q|-v] [-b basedn] [-d domain] [-h host] list [name]

表格 D-28 說明 csresource 公用程式可以使用的指令。

表格 D-28 csresource 公用程式指令

指令

說明

create name

為指定的行事曆 ID 建立新資源。

delete [name]

刪除一個資源，或在未指定資源 name 時刪除所有資源。

enable [name]

啟用一個資源，或在未指定資源 name 時啟用所有資源。

disable [name]

停用一個資源，或在未指定資源 name 時停用所有資源。

list [name]

顯示單一資源行事曆，或在未指定資源 name 時顯示所有資源行事曆。

如果包含 -h host 選項，則顯示該後端伺服器上指定名稱 (或所有資源行事曆) 的行事曆屬性。

註

如果上述任一指令的 name 中包含空格，則必須將該 name 置於引號 (" ") 中。

表格 D-29 說明 csresource 公用程式指令選項。

表格 D-29 csresource 公用程式指令選項

選項

說明

-v

在詳細模式下執行：顯示有關正在執行的指令之所有可用資訊。預設為關閉。

-q

在無訊息模式下執行：

如果作業成功，則不顯示任何資訊 (如果發生錯誤，則會顯示錯誤資訊)。

不顯示危險指令的確認提示。

預設為關閉。

-a [aces]

所指定行事曆的存取控制項目 (ACE)。ACE 決定可以存取群組排程行事曆的人員，以及他們擁有的許可權類型，如建立、刪除、讀取和寫入權限。ACE 字串或存取控制清單 (ACL) 必須置於引號 ("") 中。

預設為 ics.conf 檔案中的 resource.default.acl 參數。

如需有關 ACE 格式的資訊，請參閱第 13 章「管理行事曆」。

-b [basedn]

用於指定資源的 LDAP 基底 DN (識別名稱)。預設使用 ics.conf 檔案中的 local.ugldapbasedn 參數的值。

-c calid

icsCalendar 屬性。此選項需要與 create 指令一起使用。如需更多資訊，請參閱建立行事曆唯一識別碼 (calid)。

-d domain

指定託管 (虛擬) 網域的名稱。預設使用 ics.conf 檔案中 service.defaultdomain 參數的值。

-t [description]

指定有關行事曆目的的可檢視註釋。預設為無說明。

-h host

指定資源行事曆所在之後端伺服器的名稱。此選項僅適用於 list 指令。

-k yes|no

指定是否允許與資源 (如會議室) 關聯之行事曆的雙預定。例如，yes 表示資源行事曆可以為同一時段排程一個以上的事件。

如果忽略 -k 選項，則預設使用 ics.conf 檔案中 resource.allow.doublebook 參數的值。但是，僅在建立行事曆時，才使用 resource.allow.doublebook 參數。

建立行事曆之後，Calendar Server 將檢查行事曆特性 (ics50calprops.db) 以決定是否允許雙預定。如果您需要為行事曆變更行事曆特性以允許或不允許雙預定，請重新執行帶有 -k 選項的 csresource。

-m email

指定資源的 LDAP mail 屬性 (主要電子郵件位址)。

-o owner

主要所有者。

預設使用 ics.conf 檔案中 service.admin.calmaster.userid 的值。

-y otherowners

其他所有者。多位所有者必須置於引號 (" ") 中，並以空格分隔。預設為無其他所有者。

version [name]

顯示公用程式的版本。

範例

顯示所有資源行事曆及其 LDAP 屬性的清單︰

csresource -v list

建立行事曆 ID (calid) 為 room100、可檢視名稱 (LDAP cn 屬性) 為 MeetingRoom100 的資源行事曆︰

csresource -c room100 create MeetingRoom100

顯示可檢視名稱為 MeetingRoom100 之資源行事曆的 LDAP 屬性︰

csresource -v list MeetingRoom100

停用可檢視名稱為 MeetingRoom100 的資源行事曆︰

csresource disable MeetingRoom100

啟用可檢視名稱為 MeetingRoom100 的資源行事曆，並允許雙預定︰

csresource -k yes enable MeetingRoom100

刪除可檢視名稱為 MeetingRoom100 的資源行事曆︰

csresource delete MeetingRoom100

顯示後端伺服器 sesta 上可檢視名稱為 MeetingRoom100 之資源行事曆的 LDAP 屬性︰

csresource -v -h sesta list MeetingRoom100

csrestore

csrestore 公用程式可復原使用 csbackup 或 csexport 儲存的行事曆資料庫、指定的行事曆或使用者的預設行事曆。指令包括︰

database，復原行事曆資料庫。

calendar，復原指定的行事曆。

defcal，復原使用者的預設行事曆。

version，顯示目前安裝之公用程式的版本號碼。

位於指定備份目錄中的 caldb.conf 版本檔案顯示已備份資料庫的版本號碼。

小心

Calendar Server 6.x csrestore 與 2.x 版本的 csrestore 不相容。請勿嘗試復原使用 Calendar Server 2.x csrestore 備份的資料，因為這可能會導致資料遺失。

需求

您必須在安裝了 Calendar Server 的機器上以本地方式執行此公用程式。

如果您要復原行事曆資料庫，則必須停止 Calendar Server。

在 Solaris 作業系統上，您必須以執行 Calendar Server 的使用者和群組身份 (在安裝期間指定，如 icsuser 和 icsgroup)，或者以 root 身份登入。

語法

csrestore [-v|-q] [-f] database inputdir

csrestore [-v|-q] -c calid calendar inputfile

csrestore [-v|-q] -a userid [-b basedn] defcal inputfile

表格 D-30 說明 csrestore 公用程式可以使用的指令。

表格 D-30 csrestore 公用程式指令

指令

說明

database inputdir

從包含備份行事曆資料庫的指定輸入目錄或輸入檔案復原行事曆資料庫。此作業會覆寫目前行事曆資料庫的所有先前內容。

calendar inputfile

從指定的輸入檔案復原指定的行事曆 ID。檔案的資料格式由檔案名稱的副檔名決定︰

.ics 為 iCalendar (text/calendar) 格式。

.xml 為 XML (text/xml) 格式。

如果指定的行事曆 ID 已經存在，則系統在復原行事曆的資料之前會將該資料清除。

defcal inputfile

從指定的輸入檔案復原指定使用者 ID 的預設行事曆。檔案的資料格式由檔案名稱的副檔名決定︰

.ics 為 iCalendar (text/calendar) 格式。

.xml 為 XML (text/xml) 格式。

version

顯示公用程式的版本。

表格 D-31 說明 csrestore 公用程式指令選項。

表格 D-31 csrestore 公用程式指令選項

選項

說明

-v

在詳細模式下執行：顯示有關正在執行的指令之所有可用資訊。預設為關閉。

-q

在無訊息模式下執行：

如果作業成功，則不顯示任何資訊 (如果發生錯誤，則會顯示錯誤資訊)。

不顯示危險指令的確認提示。

預設為關閉。

-a userid

要復原的使用者 ID。此選項需要預設選項。無預設值。

-b basedn

要用於指定使用者 ID 的 LDAP 基底 DN (識別名稱)。預設使用 ics.conf 檔案中所定義 local.ugldapbasedn 設定的值。

-f

強制所有要刪除的現有資料庫檔案。

-c calid

要復原的行事曆 ID。此選項需要與 calendar 指令一起使用。無預設值。

如需更多資訊，請參閱建立行事曆唯一識別碼 (calid)。

範例

復原目錄 backupdir 中先前使用 csbackup 儲存的行事曆資料庫︰

csrestore database backupdir

從目錄 backupdir 中先前使用 csbackup 或 csexport 以 iCalendar (text/calendar 檔案) 格式儲存的 tchang.ics 檔案復原行事曆 ID 為 tchang 的行事曆︰

csrestore -c tchang calendar backupdir/tchang.ics

從 backupdir 中先前使用 csbackup 儲存的行事曆資料庫復原 tchang︰

csrestore -c tchang calendar backupdir

從目錄 backupdir 中先前使用 csbackup 或 csexport 以 iCalendar (text/calendar 檔案) 格式儲存的 TChang.ics 檔案復原 TChang 擁有的預設行事曆︰

csrestore -a TChang defcal backupdir/TChang.ics

csschedule

csschedule 公用程式可管理群組排程引擎 (GSE) 佇列中儲存的排程項目。指令包括︰

list，顯示指定行事曆 ID 請求的 GSE 佇列中儲存的項目。

delete，從指定行事曆 ID 請求的 GSE 佇列中移除項目。

version，顯示目前安裝之公用程式的版本號碼。

需求

您必須在安裝了 Calendar Server 的機器上以本地方式執行此公用程式。

必須停止 Calendar Server。

在 Solaris 作業系統上，您必須以執行 Calendar Server 的使用者和群組身份 (在安裝期間指定，如 icsuser 和 icsgroup)，或者以 root 身份登入。

語法

csschedule [-q|-v] [-c count] [-e endtime] [-s starttime]

  [-t scheduletime -o offset] [-u uid] list [calid]

csschedule [-q|-v] [-t scheduletime -o offset -u uid -n sequencenumber

  -r rid] list [calid]

csschedule [-q|-v] [-t scheduletime -o offset -u uid -n sequencenumber

  -r rid] delete [calid]

csschedule [-q|-v] [-s starttime] [-e endtime] delete [calid]

表格 D-32 說明 csschedule 公用程式可以使用的指令。

表格 D-32 csschedule 公用程式指令

指令

說明

list

顯示指定行事曆 ID 請求的 GSE 佇列中儲存的項目。

delete

從指定行事曆 ID 請求的 GSE 佇列中移除項目。

version

顯示公用程式的版本。

表格 D-33 說明 csschedule 公用程式指令選項。

表格 D-33 csschedule 公用程式指令選項

選項

說明

-v

在詳細模式下執行：顯示有關正在執行的指令之所有可用資訊。預設為關閉。

-q

在無訊息模式下執行：

如果作業成功，則不顯示任何資訊 (如果發生錯誤，則會顯示錯誤資訊)。

不顯示危險指令的確認提示。

預設為關閉。

-c count

要列出的 GSE 佇列項目的數目。例如，如果您要檢查佇列中的十個項目，則指定 10。

-e endtime

GSE 佇列中項目的結束時間，其中 0 表示不限制結束時間。預設為 0。

-n sequencenumber

佇列中事件或工作的序列號碼。

-o offset

排程時間的偏移。同時排程一個以上的項目時，偏移可唯一識別 GSE 佇列中的項目。

-r rid

事件或待辦事項的週期性 ID (RID)。RID 是以分號分隔的字串清單，可識別發生的每個週期性事件或待辦事項。

-s starttime

GSE 佇列中項目的起始時間，其中 0 表示不限制起始時間。預設為 0。

-t scheduletime

排程時間，例如︰20001231T103045Z

-u uid

GSE 佇列中項目的唯一識別碼 (UID)。

範例

列出 GSE 佇列中儲存的所有項目的詳細資訊︰

csschedule -v list

列出 GSE 佇列中儲存的前十個項目︰

csschedule -c 10 list

列出 GSE 佇列中在 2000 年 12 月 31 日 10:30:45 至 11:30:45 之間排程的項目：

csschedule -s 20001231T103045Z -e 20001231T113045Z list

列出 GSE 佇列中在 10:30:45 排程的行事曆 tchang 的項目，該項目在 2000 年 12 月 31 日 10:30:45 的偏移為 2，唯一識別碼為 1111，週期性 ID 為 0 並且序列號碼為 0︰

csschedule -v -t 20001231T103045Z -o 2 -u 1111 -r 0 -n 0 list tchang

刪除 GSE 佇列中 10:30:45 的行事曆 tchang 的項目，該項目的第一個偏移在 2000 年 12 月 31 日 10:30:45、唯一識別碼為 1111、週期性 ID為 0 並且序列號碼為 0︰

csschedule -v -t 20001231T103045Z -o 1 -u 1111 -r 0 -n 0 delete tchang

刪除 GSE 中在 2000 年 12 月 31 日 10:30:45 至 16:30:45 之間排程的項目：

csschedule -v -s 20001231T103045Z -e 20001231T163045Z delete

刪除 GSE 佇列中的所有項目︰

csschedule -v delete

csstart

註

Calendar Server 提供 csstart 和 csstop 公用程式的目的僅為提供與舊版本的相容性。

如果可能，請使用 start-cal 和 stop-cal 指令來啟動和停止 Calendar Server。如需更多資訊，請參閱啟動和停止 Calendar Server。

csstart 公用程式可啟動 Calendar Server。指令包括︰

check，確定所有 Calendar Server 服務或指定的服務是否在執行。

list，顯示所有 Calendar Server 服務或指定的服務。

service，啟動所有 Calendar Server 服務或指定的服務。

version，顯示目前安裝之公用程式的版本號碼。

需求

您必須在安裝了 Calendar Server 的機器上以本地方式執行此公用程式。

必須停止 Calendar Server。

語法

csstart [-q|-v] check|list [servicename]

csstart [-q|-v] [-f] service [servicename]

表格 D-34 說明 csstart 公用程式可以使用的指令。

表格 D-34 csstart 公用程式指令

指令

說明

check | list
[servicename]

檢查指定的 Calendar Server 服務是否在執行，或檢查所有 Calendar Server 服務是否在執行 (如果未指定服務名稱)

或列出所有 Calendar Server 服務 (或指定的服務) 及其階段作業 ID。

servicename 可為以下之一︰

ens - 可由其他 Sun Java Enterprise System 伺服器共用的通用事件註冊和通知服務

notify - Calendar Server 通知服務

admin - Calendar Server 管理服務 (在每台伺服器機器上均是必需的)

dwp - Calendar Server 資料庫服務 (僅透過遠端資料庫配置啟動)

http - Calendar Server HTTP 服務

service [servicename]

啟動指定的 Calendar Server 服務或其所有服務 (如果未指定服務名稱)。Calendar Server 服務應按以下次序啟動︰

1. ens - 可由其他 Sun Java Enterprise System 伺服器共用的通用事件註冊和通知服務

2. notify - Calendar Server 通知服務

3. admin - Calendar Server 管理服務 (在每台伺服器機器上均是必需的)

4. dwp - Calendar Server 資料庫服務 (僅透過遠端資料庫配置啟動)

5. http - Calendar Server HTTP 服務

如需有關 Calendar Server 服務的更多資訊，請參閱以下小節︰

「Calendar Server 存取控制」。

啟動和停止 Calendar Server。

服務配置。

version

顯示公用程式的版本。

表格 D-35 說明 csstart 公用程式指令選項。

表格 D-35 csstart 公用程式指令選項

選項

說明

-v

在詳細模式下執行：顯示有關正在執行的指令之所有可用資訊。預設為關閉。

-f

強制指定的 Calendar Server 服務 (如果未指定服務，則為所有目前執行的服務) 以︰

1. 停止 (類似 kill -9 指令)。

2. 清除所有資料庫問題。

3. 啟動所有服務。

注意：如果可能，請使用 stop-cal 和 start-cal 公用程式來停止和啟動 Calendar Server。

-q

在無訊息模式下執行：

如果作業成功，則不顯示任何資訊 (如果發生錯誤，則會顯示錯誤資訊)。

不顯示危險指令的確認提示。

預設為關閉。

範例

使用預設連接埠並以預設啟動次序啟動所有本機 Calendar Server 服務︰

csstart service

啟動本機 Calendar Server HTTP 服務︰

csstart service http

檢查所有本機 Calendar Server 服務是否均已啟動︰

csstart check

列出已啟動的所有本機 Calendar Server 服務︰

csstart list

csstats

csstats 公用程式可顯示 Calendar Server 統計資料。指令包括︰

list，列出有關所指定 Calendar Server 子系統的計數器統計資料。

version，顯示目前安裝之公用程式的版本號碼。

如需有關計數器的更多資訊，請參閱計數器配置 (counter.conf) 檔案。

需求

您必須在安裝了 Calendar Server 的機器上以本地方式執行此公用程式。

Calendar Server 可以處於執行中或停止狀態。

在 Solaris 作業系統上，您必須以執行 Calendar Server 的使用者和群組身份 (在安裝期間指定，如 icsuser 和 icsgroup)，或者以 root 身份登入。

語法

csstats [-q|v] [-r registry] [-i iterations] [-s delay]] list [subsystem]

表格 D-36 說明 csstats 公用程式可以使用的指令。

表格 D-36 csstats 公用程式指令

指令

說明

list [subsystem]

列出有關指定 Calendar Server 子系統的計數器統計資料。如果未指定子系統，則顯示有關可用子系統的基本資訊，包括︰

alarm - 服務警示通知監視

auth - 登入認證

db - 行事曆資料庫

disk - 磁碟使用率監視

gse - 群組排程引擎 (GSE)

http - HTTP 傳輸

response - 伺服器回應次數

sess - 伺服器階段作業狀態

wcap Web 行事曆存取協定

Version

顯示公用程式的版本。

表格 D-37 說明 csstats 公用程式指令選項。

表格 D-37 csstats 公用程式指令選項

選項

說明

-v

在詳細模式下執行：顯示有關正在執行的指令之所有可用資訊。預設為關閉。

-q

在無訊息模式下執行：

如果作業成功，則不顯示任何資訊 (如果發生錯誤，則會顯示錯誤資訊)。

不顯示危險指令的確認提示。

預設為關閉。

-i iterations

重複統計資料查找的次數。預設為 1。

-r registry

儲存計數器統計資料的檔案之名稱和位置。預設為：

/opt/SUNWics5/cal/lib/counter/counter

-s delay

顯示每個統計資料查找之前等待的時間 (以秒為單位)。預設為 1 秒。

範例

顯示有關計數器和可用類型的基本資訊︰

csstats list

列出有關 HTTP 服務子系統的計數器統計資料 (hpptstat)︰

csstats list http

列出有關 WCAP 子系統的計數器統計資料 (wcapstat)，每 10 秒一次，共一小時 (3600 秒)︰

csstats -i 3600 -s 10 list wcap

csstop

註

Calendar Server 提供 csstop 和 csstart 公用程式的目的僅為提供與舊版本的相容性。

如果可能，請使用 start-cal 和 stop-cal 公用程式來啟動和停止 Calendar Server。如需更多資訊，請參閱啟動和停止 Calendar Server。

csstop 公用程式可停止 Calendar Server。指令包括︰

service，停止 Calendar Server 的所有服務或指定的服務。

version，顯示目前安裝之公用程式的版本號碼。

需求

您必須在安裝了 Calendar Server 的機器上以本地方式執行此公用程式。

Calendar Server 必須處於執行中。

語法

csstop [-q|-v] check | list [servicename]

csstop [-q|-v] [-f] service [servicename]

表格 D-38 說明 csstop 公用程式可以使用的指令。

表格 D-38 csstop 公用程式指令

指令

說明

check | list
[servicename]

檢查指定的 Calendar Server 服務是否在執行，或檢查所有服務是否在執行 (如果未指定服務名稱)。

或列出所有 Calendar Server 服務或指定的服務及其階段作業 ID。servicename 可為以下之一︰

ens - 可由其他 Sun Java Enterprise System 伺服器共用的通用事件註冊和通知服務。

notify - Calendar Server 通知服務。

admin - Calendar Server 管理服務 (admin 在每台伺服器機器上均是必需的)。

dwp - Calendar Server 資料庫服務 (僅透過遠端資料庫配置啟動)。

http - Calendar Server HTTP 服務。

service [servicename]

停止指定的 Calendar Server 服務或其所有服務 (如果未指定服務名稱)。Calendar Server 服務應按以下次序啟動，並按相反次序停止︰

1. ens - 可由其他 Sun Java Enterprise System 伺服器共用的通用事件註冊和通知服務。

2. notify - Calendar Server 通知服務。

3. admin - Calendar Server 管理服務 (admin 在每台伺服器機器上均是必需的)。

4. dwp - Calendar Server 資料庫服務 (僅透過遠端資料庫配置啟動)。

5. http - Calendar Server HTTP 服務。

如需有關 Calendar Server 服務的更多資訊，請參閱以下小節︰

「Calendar Server 存取控制」。

啟動和停止 Calendar Server。

服務配置。

version

顯示公用程式的版本。

表格 D-39 說明 csstop 公用程式指令選項。

表格 D-39 csstop 公用程式指令選項

選項

說明

-v

在詳細模式下執行：顯示有關正在執行的指令之所有可用資訊。預設為關閉。

-q

在無訊息模式下執行：

如果作業成功，則不顯示任何資訊 (如果發生錯誤，則會顯示錯誤資訊)。

不顯示危險指令的確認提示。

預設為關閉。

-f

強制 Calendar Server 服務停止 (如果先前的嘗試失敗，則類似 kill -9 指令)。

此選項僅能與 service 指令一起使用。

範例

停止所有的本機 Calendar Server 服務︰

csstop service

停止本機 Calendar Server HTTP 服務︰

csstop service http

檢查所有本機 Calendar Server 服務是否均已停止︰

csstop check

列出已啟動的所有本機 Calendar Server 服務︰

csstop list

csstored.pl

csstored.pl 公用程式為一種可執行行事曆資料庫和日誌檔的以下線上作業或「緊急」歸檔作業的 Perl 程序檔：

將資料庫檔案和目前日誌檔複製到備份歸檔目錄和「緊急」備份目錄。

將 Berkeley 資料庫 db_archive 公用程式傳回的日誌檔複製到備份歸檔目錄和「緊急」備份目錄。

移除 Berkeley 資料庫 db_archive 公用程式傳回的所有日誌檔，最後一個檔案除外。

在「緊急」備份目錄的資料庫檔案上執行 Berkeley 資料庫 db_verify。

如需有關 Berkeley 資料庫公用程式的文件，請參閱 Sleepycat 軟體網站：

http://www.sleepycat.com/docs/utility/index.html

需求

您必須在安裝了 Calendar Server 的機器上執行以下目錄中的程序檔︰

cal_svr_base/opt/SUNWics5/cal/sbin

在 Solaris 作業系統上，您必須以執行 Calendar Server 的使用者和群組身份 (在安裝期間指定，如 icsuser 和 icsgroup)，或者以 root 身份登入。

必須停用 Calendar Server 的循環記錄︰

caldb.berkeleydb.circularlogging = "no"

語法

perl csstored.pl

表格 D-40 說明 ics.conf 檔案中由 csstored.pl 公用程式使用的參數︰

表格 D-40 ics.conf 檔案中由 csstored.pl 公用程式使用的參數

參數

說明

caldb.berkeleydb.homedir.path

指定儲存行事曆資料庫檔案的目錄路徑。

預設為 "."，指定以下目錄︰

cal_svr_base/var/opt/SUNWics5/csdb

caldb.berkeleydb.archive.path

指定行事曆資料庫歸檔目錄的路徑。無預設值。

若要執行 csstored.pl，請指定一個不同於行事曆資料庫目錄和「緊急」備份目錄的路徑。

caldb.berkeleydb.hotbackup.path

指定「緊急」備份目錄的路徑。無預設值。

若要執行 csstored.pl，請指定一個不同於行事曆資料庫目錄和歸檔目錄的路徑。

caldb.berkeleydb.archive.enable

啟用 ("yes") 或停用 ("no") 行事曆資料庫的歸檔選項。

預設為 "no"。

若要執行 csstored.pl，請將此參數設定為 "yes"。

caldb.berkeleydb.hotbackup.enable

啟用 ("yes") 或停用 ("no") 行事曆資料庫的「緊急」備份選項

預設為 "no"。

若要執行 csstored.pl，請將此參數設定為 "yes"。

caldb.berkeleydb.circularlogging

指定 ("yes" 或 "no") 同步化資料庫檢查點檔案的異動後，是否移除這些檔案。

預設為 yes。

若要執行 csstored.pl，請將此參數設定為 "no"。

caldb.berkeleydb.archive.interval

指定歸檔行事曆資料庫的間隔時間 (以秒為單位)。

預設為「120」秒。

cstool

cstool 公用程式可 ping 以下選項之一：

HTTP 程序，cshttpd。

管理服務，csadmind

事件通知服務 (ENS) 程序，enpd。

安裝了 Calendar Server 的伺服器。

cstool 公用程式還可顯示其版本號碼。

cstool 不能用於 ping 以下程序：

通知程序，csnotifyd。

DWP 程序，csdwpd。

註

若要更新配置，請使用 stop-cal，然後使用 start-cal 以停止然後重新啟動 Calendar Server。

請勿使用 cstool 更新配置。這可能會導致不可預料的負面結果。

如需更多資訊，請參閱啟動和停止 Calendar Server 和編輯 ics.conf 配置檔案。

需求

Calendar Server 必須處於執行中。

在 Solaris 作業系統上，您必須以執行 Calendar Server 的使用者和群組身份 (在安裝期間指定，如 icsuser 和 icsgroup)，或者以 root 身份登入。

語法

cstool [-q|-v] [-h host] [-p port] [-t timeout] ping [http|ens]

cstool [-q|-v] [-h host] version

表格 D-41 說明 cstool 指令及其參數。

表格 D-41 cstool 公用程式指令

指令

參數

說明

ping

[http|admin|ens]

未指定任一參數

Ping cshttpd 程序、csadmind 程序或 ENS 程序 (enpd)

Ping 安裝了 Calendar Server 的伺服器。

version

無

顯示公用程式的版本。

表格 D-42 說明 cstool 公用程式選項。

表格 D-42 cstool 公用程式指令選項

選項

說明

-v

在詳細模式下執行：顯示有關正在執行的指令之所有可用資訊。預設為關閉。

-q

在無訊息模式下執行：

如果作業成功，則不顯示任何資訊 (如果發生錯誤，則會顯示錯誤資訊)。

不顯示危險指令的確認提示。

預設為關閉。

-h host

指定執行 Calendar Server 之機器的主機名稱。預設值在安裝時設定，且預設使用 ics.conf 檔案中 local.hostname 參數的值。如果您要存取在遠端機器上執行的 Calendar Server，請使用此選項。

-p port

使用指定服務的連接埠，如果未指定服務，則使用 ics.conf 檔案中所定義連接埠的預設值。

-t timeout

等待伺服器回應的時間 (以秒為單位)。預設為 120 秒。

範例

Ping cshttpd 服務︰

cstool ping http

Ping 主機名稱為 sesta 之伺服器上的 ENS︰

cstool -h sesta ping ens

Ping 主機名稱為 calserver 的機器，以查看 Calendar Server cshttpd 服務是否在偵聽連接埠 80︰

cstool -p 80 -h calserver -p 80 ping http

強制本機 Calendar Server 以更新服務的所有配置︰

cstool refresh

csuser

csuser 公用程式可管理 LDAP 目錄伺服器和 Calendar Server 行事曆資料庫中儲存的行事曆使用者資訊。指令包括︰

check，檢查是否允許使用者使用行事曆功能。

create，建立並允許使用者使用行事曆功能。

註

此公用程式無法讓使用者獲得 Communications Express 要求的通訊錄。要使用通訊錄，須藉由 ldapmodify 手動完成。

delete，刪除使用者。

disable，禁止使用者登入 Calendar Server。

enable，允許使用者登入 Calendar Server。

list，列出使用者的行事曆屬性。

reset，將使用者的行事曆屬性重設為預設設定。

如果您使用的是 Directory Server，則還可以使用 ldapsearch 和 ldapmodify 公用程式。如需有關這些公用程式的資訊，請參閱以下網站上的 Directory Server 文件：

http://docs.sun.com/coll/S1_DirectoryServer_52 和
http://docs.sun.com/coll/S1_DirectoryServer_52_zh_TW

需求

Calendar Server 可以處於執行中或停止狀態。

您必須在安裝了 Calendar Server 的機器上以本地方式執行此公用程式。

儲存行事曆使用者資訊的 LDAP 伺服器必須處於執行中狀態。

在 Solaris 作業系統上，您必須以執行 Calendar Server 的使用者和群組身份 (在安裝期間指定，如 icsuser 和 icsgroup)，或者以 root 身份登入。

語法

csuser [-q|-v] [-a aces] [-b basedn] -m email [-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] [-c calid]

csuser [-q|-v] [-b basedn] [-d domain]
  [check|delete|disable|enable|reset] userid [-c calid]

表格 D-43 說明 csuser 公用程式可以使用的指令。

表格 D-43 csuser 公用程式指令

指令

說明

check userid

檢查是否允許指定的使用者 ID 使用行事曆功能。

create userid

建立指定的使用者 ID，並使該使用者登入 Calendar Server。

delete userid

刪除指定的使用者 ID。

disable userid

禁止指定的使用者 ID 使用行事曆功能。此公用程式將 http 定義為 icsAllowedServiceAccess 屬性的值。

enable userid

允許指定的使用者 ID 使用行事曆功能。在單一網域模式中使用 -c 選項。

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 的 enable 指令時，這些屬性將在使用者的 LDAP 項目中被復原。

version

顯示公用程式的版本。

表格 D-44 說明 csuser 公用程式指令選項。

表格 D-44 csuser 公用程式指令選項

選項

說明

-v

在詳細模式下執行：顯示有關正在執行的指令之所有可用資訊。預設為關閉。

-q

在無訊息模式下執行：

如果作業成功，則不顯示任何資訊 (如果發生錯誤，則會顯示錯誤資訊)。

不顯示危險指令的確認提示。

預設為關閉。

-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 格式的詳細資訊，請參閱服務配置。

-b [basedn]

所指定使用者 ID 的 LDAP 基底 DN (識別名稱)。

預設使用 ics.conf 檔案中 local.ugldapbasedn 參數的值。

-c [calid]

與指定使用者 ID 關聯之預設行事曆的行事曆 ID。預設為使用者 ID。此選項對 create 指令無效。此選項在託管網域模式中無效。

如需有關 calid 的更多資訊，請參閱建立行事曆唯一識別碼 (calid)。

-f filename

檔案名稱，用於為需要密碼的選項 (-y 參數) 指定密碼。如果您要從程序檔執行 csuser，以使用附加的安全性，請在檔案名稱中指定密碼。

-g givenname

使用者的 LDAP 給定名稱 (名字)。此選項是必需的。無預設值。

-h host

指定使用者行事曆所在之後端伺服器的名稱。此選項僅適用於 list 指令。

-k yes|no

是否允許使用者行事曆的雙預定。如果是，則使用者的行事曆可以為同一時段排程一個以上的事件。

預設使用 ics.conf 檔案中所定義 user.allow.doublebook 設定的值。

-l [langcode]

語言代碼。預設為 ics.conf 中 local.sitelanguage 的值。

-m email

指定使用者的 LDAP mail 屬性 (主要電子郵件位址)。

-s surname

使用者的 LDAP 姓氏 (姓)。此選項是必需的。無預設值。

-y userpassword

所需的行事曆使用者的密碼。無預設值。

範例

檢查是否允許行事曆使用者 jsmith 使用行事曆功能 (如果現有行事曆使用者可以存取此 Calendar Server 的行事曆資料)︰

csuser check jsmith

建立一位 LDAP 使用者，其使用者 ID 為 jsmith，名字為 John，姓氏為 Smith，電子郵件位址為 jsmith@sesta.com，網域為 sesta.com︰

csuser -g John -s Smith -y password -m jsmith@sesta.com create jsmith -d sesta.com

刪除行事曆使用者︰jsmith

csuser delete jsmith

禁止行事曆使用者 jsmith 登入 Calendar Server︰

csuser disable jsmith

註

該指令可防止 jsmith 登入 Calendar Server 以存取行事曆資料，但不會從行事曆資料庫中刪除 jsmith 的資料。如果 jsmith 目前已登入 Calendar Server，則 jsmith 仍可存取行事曆資料，直至其登出。

允許 jsmith 使用行事曆功能 (讓現有行事曆使用者 jsmith 登入 Calendar Server)︰

csuser enable jsmith

列出 jsmith 的所有行事曆屬性︰

csuser -v list jsmith

列出以字串 user 為字首的所有行事曆使用者 ID︰

csuser -v list "user*"

將 jsmith 的所有行事曆屬性重設為預設配置設定︰

csuser reset jsmith

列出後端伺服器 sesta 上 TChang 的所有行事曆屬性︰

csuser -v -h sesta list TChang

start-cal

start-cal 公用程式可按以下次序啟動 Calendar Server 服務︰

enpd - 事件通知服務 (ENS)

csnotifyd - 通知服務

csadmind - 管理服務

csdwpd - 資料庫連線協定 (DWP) 服務，僅透過遠端 Calendar Server 資料庫配置啟動的分散式資料庫服務

cshttpd - HTTP 服務

需求

您必須在安裝了 Calendar Server 的機器上以本地方式執行 start-cal。

在 Solaris 作業系統上，您必須以執行 Calendar Server 的使用者和群組身份 (在安裝期間指定，如 icsuser 和 icsgroup)，或者以 root 身份登入。

語法

start-cal

範例

./start-cal

如需更多資訊，請參閱啟動和停止 Calendar Server。

stop-cal

stop-cal 公用程式可停止所有 Calendar Server 服務。

需求

您必須在安裝了 Calendar Server 的機器上以本地方式執行 stop-cal。

在 Solaris 作業系統上，您必須以執行 Calendar Server 的使用者和群組身份 (在安裝期間指定，如 icsuser 和 icsgroup)，或者以 root 身份登入。

語法

stop-cal

範例

./stop-cal

如需更多資訊，請參閱啟動和停止 Calendar Server。

上一個      目錄      索引      下一個

Copyright 2004 Sun Microsystems, Inc. 。版權所有。

公用程式	說明
csattribute	管理行事曆使用者或資源的 LDAP 屬性。
csbackup	備份個別行事曆、使用者以及行事曆資料庫。
cscal	管理行事曆及其特性。
csclean	移除其狀態屬性 (inetUserStatus) 已被 Identity Server 的 commadmin 公用程式標記為「已刪除」的 Calendar Server 使用者的使用者行事曆和資源行事曆。
cscomponents	管理行事曆元件︰事件和工作 (待辦事項)。
csdb	管理行事曆資料庫。
csdomain	管理 LDAP 目錄中託管 (虛擬) 網域的 Calendar Server 屬性。
csexport	以 iCalendar (.ics) 或 XML (.xml) 格式匯出行事曆。
csimport	以 iCalendar (.ics) 或 XML (.xml) 格式匯入行事曆。
csmonitor	監視 LDAP 連線、日誌檔以及行事曆資料庫的可用磁碟空間。
csplugin	檢視、啟用或停用已配置的 Calendar Server API (CSAPI) Plug-in。
cspurge	允許手動清除刪除日誌資料庫 (ics50deletelog.db) 中的項目。
csrename	允許重新命名使用者 ID。導致整個資料庫被重寫。
csresource	管理行事曆資源，如會議室和設備。
csrestore	復原個別行事曆、使用者以及行事曆資料庫。
csschedule	管理群組排程引擎 (GSE) 佇列中的排程項目。
csstart	啟動 Calendar Server 程序。
csstats	顯示 Calendar Server 中的計數器。
csstop	停止 Calendar Server 程序。
csstored.pl	執行行事曆資料庫和日誌檔的歸檔作業。
cstool	Ping 執行中的 Calendar Server 實例。
csuser	管理行事曆使用者。
start-cal	啟動所有 Calendar Server 程序。
stop-cal	停止所有 Calendar Server 程序。


註	如果您的站點使用的是 LDAP CLD Plug-in，請勿在嘗試指定新的後端主機伺服器時使用 csattribute 來變更 icsDWPHost 屬性。修改 icsDWPHost 不會在新的後端主機上建立新的行事曆。如需更多資訊，請參閱第 9 章「配置行事曆查找資料庫 Plug-in」。

指令	說明
add target	將 LDAP 屬性和值增加至指定目標 (使用者或資源物件)。
list target	列出目標物件的屬性。
delete target	從目標中刪除屬性。
version	顯示公用程式的版本。

選項	說明
-v	在詳細模式下執行：顯示有關正在執行的指令之所有可用資訊。預設為關閉。
-q	在無訊息模式下執行：如果作業成功，則不顯示任何資訊 (如果發生錯誤，則會顯示錯誤資訊)。不顯示危險指令的確認提示。預設為關閉。
-a attribute =value 或 -a attribute [=value ]	LDAP 屬性和值︰使用 -a 選項時，attribute 是必需的。當 -a 選項與 add 指令一起使用時，value 是必需的；但是，當 -a 選項與 delete 和 list 指令一起使用時，value 則為選擇性的。
-t user \| resource	目標類型 (使用者或資源物件)。預設為使用者。
[-d domain]	指定託管 (虛擬) 網域的名稱。預設使用 ics.conf 檔案中 service.defaultdomain 參數的值。

指令	說明
database target	將行事曆資料庫備份至指定的目標資料庫目錄。依預設，目標資料庫目錄為︰ cal_svr_base/opt/SUNWics5/cal/sbin/target-directory 如果您僅指定目標資料庫目錄，請勿在目錄名稱前加斜線 (/)。例如： csbackup database backupdir 注意：如果目標備份目錄已經存在且您未指定 -f 選項，則 csbackup 公用程式會失敗。例如，如果 backupdir 存在，則即使目錄為空，以下指令也會失敗︰ csbackup database backupdir 因此，如果您指定已經存在的目標備份目錄，請在執行 csbackup 時加上 -f 選項。您也可以指定不存在的目標備份目錄，並讓 csbackup 為您建立目錄。
calendar calid target	將指定的行事曆 ID 備份至指定的目標輸出檔案。檔案的資料格式由副檔名決定，.ics 為 text/calendar 格式，.xml 為 text/xml 格式。
defcal userid target	將指定使用者 ID 的預設行事曆備份至指定的目標檔案。檔案的資料格式由副檔名決定，.ics 為 text/calendar 格式，.xml 為 text/xml 格式。
version	顯示公用程式的版本。

選項	說明
-v	在詳細模式下執行：顯示有關正在執行的指令之所有可用資訊。預設為關閉。
-q	在無訊息模式下執行：如果作業成功，則不顯示任何資訊 (如果發生錯誤，則會顯示錯誤資訊)。不顯示危險指令的確認提示。預設為關閉。
-a userid	要備份的行事曆使用者的使用者 ID。此選項需要預設選項。無預設值。
-b basedn	要用於該使用者的基底 DN。預設使用 ics.conf 檔案中所定義 local.ugldapbasedn 設定的值。基底 DN (識別名稱) 是 LDAP 目錄中用作搜尋起點的項目。例如，如果您指定的基底 DN 為 ou=people, o=sesta.com，則由 Calendar Server 執行的所有 LDAP 搜尋作業將僅檢查 o=sesta.com 目錄樹中的子樹 ou=people。
-c calid	要備份的行事曆 ID。此選項需要與 calendar 指令一起使用。無預設值。如需更多資訊，請參閱「建立行事曆唯一識別碼 (calid)」。
-f	強制所有要刪除的現有備份檔案。在目前發行版本中，如果備份目標目錄已存在，即使該目錄為空，您也必須加上 -f 選項。
-l	準備備份檔案，以與 Solstice Backup 或 Legato Networker 備份程序配合使用。如需更多資訊，請參閱第 15 章「備份與復原 Calendar Server 資料」。

指令	說明
create calid	建立 calid 指定的行事曆。注意：如果您的站點使用的是 LDAP CLD Plug-in，特定使用者的所有行事曆必須常駐在同一後端伺服器上，如使用者的 icsDWPHost LDAP 屬性所指定。如果您嘗試在其他後端伺服器上建立該使用者的行事曆，Calendar Server 將傳回錯誤。
delete calid	刪除 calid 指定的行事曆。如果指定 -o owner 選項，則會刪除主要所有者為指定所有者的所有行事曆。
enable [calid]	啟用 calid 指定的行事曆。如果未指定 calid，則會啟用所有行事曆。如果指定 -o owner 選項，則會啟用主要所有者為指定所有者的所有行事曆。
disable [calid]	停用 calid 指定的行事曆。如果未指定 calid，則會停用所有行事曆。如果指定 -o owner 選項，則會停用主要所有者為指定所有者的所有行事曆。
list [calid]	列出 calid 所指定行事曆的特性。如果未指定 calid，則會列出所有行事曆的特性。如果指定 -o owner 選項，則會列出主要所有者為指定所有者的所有行事曆。
modify calid	修改 calid 所指定行事曆的特性。
reset calid	將 calid 所指定行事曆的特性重設為預設配置設定。
version	顯示公用程式的版本。

選項	說明
-v	在詳細模式下執行：顯示有關正在執行的指令之所有可用資訊。預設為關閉。
-q	在無訊息模式下執行：如果作業成功，則不顯示任何資訊 (如果發生錯誤，則會顯示錯誤資訊)。不顯示危險指令的確認提示。預設為關閉。
-a [aces]	所指定行事曆的存取控制項目 (ACE)。ACE 決定可以存取群組排程行事曆的人員，以及他們擁有的許可權類型，如建立、刪除、讀取和寫入權限。ACE 字串或存取控制清單 (ACL) 必須置於引號 (" ") 中。預設為 ics.conf 檔案中的 calstore.calendar.default.acl 參數。如需有關 ACE 格式的詳細資訊，請參閱行事曆管理簡介。
-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	主要所有者。預設設定為行事曆 ID (calid)，通常與使用者 ID 相同。
-O	指定主要所有者的所有行事曆。預設僅為已命名的行事曆。
-y otherowners	其他行事曆所有者。多位所有者必須置於引號 ("") 中，並以空格分隔。預設為無其他所有者。

選項	說明
-q	在無訊息模式下執行：如果作業成功，則不顯示任何資訊 (如果發生錯誤，則會顯示錯誤資訊)。不顯示危險指令的確認提示。預設為關閉。
-v	在詳細模式下執行：顯示有關正在執行的指令之所有可用資訊。預設為關閉。
-g graceperiod	指定為使用者刪除行事曆服務以後經過的天數。預設為 10 天。

指令	說明
delete calid	刪除包含指定行事曆 ID 的行事曆中的事件和工作。
list calid	列出包含指定行事曆 ID 的行事曆中的事件和工作。
version	將公用程式的版本顯示在螢幕上。

選項	說明
-v	在詳細模式下執行：顯示有關正在執行的指令之所有可用資訊。預設為關閉。
-q	在無訊息模式下執行：如果作業成功，則不顯示任何資訊 (如果發生錯誤，則會顯示錯誤資訊)。不顯示危險指令的確認提示。預設為關閉。
-e endtime	元件的結束時間。結束時間為 0 表示不限制結束時間。預設為 0。
-s starttime	元件的起始時間。起始時間為 0 表示不限制起始時間。預設為 0。
-t event\|task	在其上執行動作之元件 (事件或工作) 的類型。預設為兩者。

指令	說明
create [dbdir]	在指定的資料庫目錄中建立資料庫。如果未指定資料庫目錄，則使用目前目錄。如果伺服器啟動時資料庫不存在，Calendar Server 會自動建立一個。
delete [dbdir]	刪除指定資料庫目錄中的資料庫。如果未指定資料庫目錄，則使用目前目錄。資料庫在開啟時 (Calendar Server 在執行時) 無法被刪除。
list [dbdir]	列出有關指定資料庫目錄之資料庫的資訊。如果未指定資料庫目錄，則使用目前目錄。
recover [dbdir]	嘗試回復指定資料庫目錄中損毀的資料庫。如果未指定資料庫目錄，則使用目前目錄。
check [dbdir]	掃描指定資料庫目錄中的行事曆資料庫，以確定是否發生損毀，並在其輸出中報告結果。如果未指定資料庫目錄，則使用目前目錄。
rebuild [-g] [dbdir [dstdir]]	掃描指定資料庫目錄中的行事曆資料庫，以確定是否發生損毀，並產生重建的行事曆資料庫 (.db 檔案)。如果未指定資料庫目錄，則使用目前目錄。除其他行事曆資料庫之外，-g 選項還可重建群組排程引擎 (GSE) 資料庫，dstdir 可指定選擇性的目標目錄。
version	顯示公用程式的版本。

選項	說明
-v	在詳細模式下執行：顯示有關正在執行的指令之所有可用資訊。預設為關閉。
-q	在無訊息模式下執行：如果作業成功，則不顯示任何資訊 (如果發生錯誤，則會顯示錯誤資訊)。不顯示危險指令的確認提示。預設為關閉。
-f	強制回復行事曆資料庫。
-g	對於 rebuild 指令，除其他行事曆資料庫之外，還可重建群組排程引擎 (GSE) 資料庫。
-t caldb\|sessdb\|statdb	指定目標資料庫： caldb (行事曆) sessdb (階段作業) statdb (統計資料) 注意：如果未指定 -t，csdb 將在所有資料庫上作業，但 check 和 rebuild 指令除外，它們僅在 caldb (行事曆) 上作業。

指令	說明
create	在 LDAP 目錄中建立新的託管網域。網域的所有 Calendar Server 使用者和資源均建立在目錄的此項目之下。
add	在 LDAP 目錄中為特定網域增加 Calendar Server 屬性及其關聯值。如果您使用 csdomain 增加或更新網域 LDAP 屬性，請重新啟動 Calendar Server 以使新值生效。
delete	在 LDAP 目錄中為特定託管網域刪除某個 Calendar Server 屬性，或刪除整個網域的所有 LDAP 項目。
list	顯示 LDAP 目錄中特定網域的 Calendar Server 屬性。
version	顯示公用程式的版本。

選項	說明
-v	在詳細模式下執行：顯示有關正在執行的指令之所有可用資訊。預設為關閉。
-q	在無訊息模式下執行：如果作業成功，則不顯示任何資訊 (如果發生錯誤，則會顯示錯誤資訊)。不顯示危險指令的確認提示。預設為關閉。
-a attr[=value]	指定 LDAP 屬性的特性名稱及其選擇性值。如需這些屬性和特性名稱的清單，請參閱「LDAP 屬性和特性名稱」。
-f filename	指定包含 Calendar Server LDAP 目錄的特性名稱及其關聯值的文字檔案。例如： createLowerCase="yes" filterPrivateEvents="no" fbIncludeDefCal="no" subIncludeDefCal="no" uiProxyUrl="https://proxyserver"
-n node	套用至 create 指令，如下所示︰對於 LDAP 模式 1 - 指定在其下建立所有使用者和資源的節點。例如：o=node2,o=node1,o=sesta 對於 LDAP 模式 2 - 指定為該網域建立之節點的名稱。例如：o=west.sesta.com 如果未指定節點，則使用網域名稱。
網域	對於 add、delete 和 list 指令，指定 LDAP 目錄中的現有網域。對於 create 指令，指定將要在 LDAP 目錄中建立之新網域的唯一名稱。例如：west.sesta.com

位元	特性名稱	說明
0	allowCalendarCreation	如果設定 (位元 0 = 1)，則不允許建立行事曆。對應的 ics.conf 參數為︰ service.wcap.allowcreatecalendars
1	allowCalendarDeletion	如果設定 (位元 1 = 1)，則不允許刪除行事曆。對應的 ics.conf 參數為︰ service.wcap.allowdeletecalendars
2	allowPublicWritableCalendars	如果設定 (位元 2 = 1)，則不允許公用的可寫入行事曆。對應的 ics.conf 參數為︰ service.wcap.allowpublicwriteablecalendars
3	n/a	在目前發行版本中不使用。
4	allowModifyUserPreferences	如果設定 (位元 4 = 1)，則不允許網域管理員使用 WCAP 指令取得或設定使用者喜好設定。對應的 ics.conf 參數為︰ service.admin.calmaster.wcap.allowgetmodifyuserprefs
5	allowModifyPassword	如果設定 (位元 5 = 1)，則不允許使用者經由此伺服器變更密碼。對應的 ics.conf 參數為︰ service.wcap.allowchangepassword
6,7	n/a	在目前發行版本中不使用。
8	allowUserDoubleBook	如果設定 (位元 8 = 1)，則不允許使用者行事曆的雙預定。對應的 ics.conf 參數為︰ user.allow.doublebook
9	allowResourceDoubleBook	如果設定 (位元 9 = 1)，則不允許資源行事曆的雙預定。對應的 ics.conf 參數為︰ resource.allow.doublebook
10	allowSetCn	如果設定 (位元 10 = 1)，則不允許使用者使用 WCAP 的 set_userprefs 指令設定一般名稱 (cn) 屬性。對應的 ics.conf 參數為︰ service.wcap.allowsetprefs.cn
11	allowSetGivenName	如果設定 (位元 11 = 1)，則不允許使用者使用 WCAP 的 set_userprefs 指令設定 givenName 屬性。對應的 ics.conf 參數為︰ service.wcap.allowsetprefs.givenname
12	allowSetGivenMail	如果設定 (位元 12 = 1)，則不允許使用者使用 WCAP 的 set_userprefs 指令設定 mail 屬性。對應的 ics.conf 參數為︰ service.wcap.allowsetprefs.mail
13	allowSetPrefLang	如果設定 (位元 13 = 1)，則不允許使用者使用 WCAP 的 set_userprefs 指令設定 preferredLanguage 屬性。對應的 ics.conf 參數為︰ service.wcap.allowsetprefs.preferredlanguage
14	allowSetSn	如果設定 (位元 14 = 1)，則不允許使用者使用 WCAP 的 set_userprefs 指令設定姓氏 (sn) 屬性。對應的 ics.conf 參數為︰ service.wcap.allowsetprefs.sn
15		如果設定 (位元 15 = 1)，則不允許使用者使用 WCAP 的 set_userprefs 指令設定使用者的預設行事曆 ID (nswccalid)。對應的 ics.conf 參數為︰ service.wcap.allowsetprefs.nswccalid
16-31	n/a	在目前發行版本中不使用。

特性名稱	說明
allowProxyLogin	指定 "yes" 或 "no" 以表示是否允許代理登入。對應的 ics.conf 參數為︰ service.http.allowadminproxy (預設 = "no")
calmasterAccessOverride	指定 "yes" 或 "no" 以表示 Calendar Server 管理員是否可以置換存取控制。對應的 ics.conf 參數為︰ service.admin.calmaster.overrides.accesscontrol (預設 = "no")
calmasterCred	指定一個 ASCII 字串，該字串是被指定為 Calendar Server 網域管理員之使用者 ID 的密碼。對應的 ics.conf 參數為︰ service.admin.calmaster.cred (無預設值)
calmasterUid	指定一個 ASCII 字串，該字串是被指定為 Calendar Server 網域管理員的使用者 ID。對應的 ics.conf 參數為︰ service.admin.calmaster.userid (無預設值)
createLowercase	指定 "yes" 或 "no" 以表示在建立新行事曆或搜尋行事曆時，Calendar Server 是否應將行事曆 ID (calid) 轉換為小寫。對應的 ics.conf 參數為︰ calstore.calendar.create.lowercase (預設 = "no")
domainAccess	指定網域的存取控制清單 (ACL)。如需有關 ACL 的資訊，請參閱存取控制清單 (ACL)。此 ACL 用於跨網域搜尋。如需更多資訊，請參閱交叉網域搜尋。
fbIncludeDefCal	指定 "yes" 或 "no" 以表示使用者的預設行事曆是否包含在使用者的空閒/忙碌行事曆清單中。對應的 ics.conf 參數為︰ calstore.freebusy.include.defaultcalendar (預設 = "yes")
filterPrivateEvents	指定 "yes" 或 "no" 以表示 Calendar Server 是否過濾 (識別) 私人與只有時間和日期 (機密) 的事件和工作。如果為 "no"，則 Calendar Server 將它們視為公開事件和工作。對應的 ics.conf 參數為︰ calstore.filterprivateevents (預設 = "yes")
groupMaxSize	指定展開事件時 LDAP 群組中所允許的與會人員的最大數目。對應的 ics.conf 參數為︰ calstore.group.attendee.maxsize (預設為 "0"- 完全展開群組)
language	指定網域的語言。對應的 ics.conf 參數為︰ local.domain.language
resourceDefaultAcl	指定一個存取控制清單 (ACL)，該清單為建立資源行事曆時所使用的預設存取控制權限。對應的 ics.conf 參數為︰ resource.default.acl (預設為 "@@o^a^r^g;@@o^c^wdeic^g;@^a^rsf^g")
setPublicRead	指定使用者預設行事曆最初被設定為公開讀取/私人寫入 ("yes")，還是私人讀取/私人寫入 ("no")。對應的 ics.conf 參數為︰ service.wcap.login.calendar.publicread (預設 = "no")
searchFilter	指定搜尋過濾器以尋找使用者。對應的 ics.conf 參數為︰ local.userSearchFilter
ssoCookieDomain	指定瀏覽器應將 cookie 僅傳送至指定網域中的伺服器。值必須以句點 (.) 開頭。例如：".sesta.com" 對應的 ics.conf 參數為︰ sso.cookiedomain (預設為目前網域)
ssoUserDomain	指定用作使用者 SSO 認證一部分的網域。對應的 ics.conf 參數為︰ sso.userdomain (無預設值)
subIncludeDefCal	指定 "yes" 或 "no" 以表示使用者的預設行事曆是否包含在使用者的訂閱行事曆清單中。對應的 ics.conf 參數為︰ calstore.subscribed.include.defaultcalendar (預設 = "yes")
uiAllowAnyone	指定 "yes" 或 "no" 以表示 Calendar Express 是否應顯示並使用「所有使用者」存取控制清單 (ACL)。對應的 ics.conf 參數為︰ ui.allow.anyone (預設 = "yes")
uiAllowDomain	指定 "yes" 或 "no" 以表示 Calendar Express 是否應顯示並使用此網域的存取控制清單 (ACL)。對應的 ics.conf 參數為︰ ui.allow.domain (預設 = "no")
uiBaseUrl	指定基底伺服器位址的 URL。例如："https://proxyserver"。對應的 ics.conf 參數為︰ ui.base.url (無預設值)
uiConfigFile	指定基於 xml 的選擇性配置檔案，該檔案可由 Calendar Server 在啟動時讀取，並允許使用者介面的某些部分被隱藏。對應的 ics.conf 參數為︰ ui.config.file (無預設值)
uiProxyURL	指定要在 HTML UI JavaScript 檔案中前置的代理伺服器位址的 URL。例如："https://web_portal.sesta.com/" 對應的 ics.conf 參數為︰ ui.proxyaddress.url (無預設值)

LDAP 屬性	特性名稱	說明
icsAllowedServiceAccess	allowedAccessProtocols	指定是否允許存取 Calendar Server。如果設定為「http」，則拒絕存取。如果設定為其他任何值，則允許存取。僅在未設定 icsStatus 屬性時，Calendar Server 才使用此屬性。
icsDefaultAccess	userDefaultAcl	為新建立的使用者行事曆指定 ACL。對應的 ics.conf 參數為︰ calstore.calendar.default.acl
icsDomainNames	searchDomainNames	指定在尋找行事曆或使用者時此網域可以搜尋的外部網域。對應的 ics.conf 參數為︰無
icsDWPBackEndHosts		指定未明確提供主機名稱時，使用者的預設後端主機 (DNS 名稱)。此屬性在 Calendar Server 處於 LDAP CLD 模式時使用。
icsStatus	statusCalendarDomain	指定 Calendar Server 的狀態︰ active - Calendar Server 可以存取。 inactive - Calendar Server 不可以存取。行事曆保留在資料庫中，並且 Calendar Server LDAP 屬性保持不變。 deleted - Calendar Server 不可以存取，因為人員被標記為已刪除。 removed - 行事曆已從行事曆資料庫中被移除。如果設定 icsStatus，其值將置換 icsAllowedServiceAccess 屬性。如果未設定 icsStatus，Calendar Server 將使用 icsAllowedServiceAccess 屬性。
icsTimezone	timezone	指定匯入檔案時使用的時區 ID。例如，America/New_York 或 Asia/Tokyo。如需所支援時區的資訊，請參閱 timezones.ics 檔案。

指令	說明
calendar outputfile	將行事曆匯出至指定的輸出檔案。檔案的資料格式由指定檔案名稱的副檔名決定︰ .ics 為 iCalendar (text/calendar) 格式 .xml 為 XML (text/xml) 格式
version	顯示公用程式的版本。

指令	說明
calendar inputfile	從指定的輸入檔案匯入行事曆。檔案的資料格式由檔案名稱的副檔名決定︰ .ics 為 iCalendar (text/calendar) 格式 .xml 為 XML (text/xml) 格式
version	顯示公用程式的版本。

參數	說明
-k	停止 csmonitor。
-c	備份並清除 csmonitor 日誌。
-help	顯示 csmonitor 的用法。

參數	說明
service.monitor.continuous	指定 csmonitor 是否應持續迴圈︰ "0" - 不持續迴圈。 "1" - 持續迴圈。此選項需要較多的系統資源，但在除錯模式下十分有用。預設為 "0"。
service.monitor.loopsdelay	指定兩個監視迴圈之間的延遲 (以秒為單位)。預設為 "60"。
service.monitor.emailaddress.from	指定 csmonitor 傳送訊息的電子郵件位址。預設為無。
service.monitor.emailaddress.to	指定 csmonitor 應將訊息傳送至的電子郵件位址。預設為無。
service.monitor.csdb.logthreshold	指定被視為正常的最大磁碟佔用率的臨界值 (以總磁碟空間的百分比表示)。如果行事曆資料庫 (csdb 目錄) 所在磁碟的佔用率超出此值，csmonitor 將傳送警告電子郵件訊息。預設為 "90"。
logfile.monitor.logname	指定 csmonitor 日誌檔名稱。預設為 "csmonitor.log"。
logfile.monitor.maxlogfilesize	指定日誌檔的最大大小。如果日誌檔超出此大小，csmonitor 會將日誌儲存為 csmonitor.log.timestamp，並重設日誌。預設為 "2097152"。
service.monitor.dbglevel	指定除錯級別。此值越高，csmonitor 傳送的訊息就越精確、越詳細。預設為 "0"。

指令	說明
activate -t type name	載入和啟用指定的 Plug-in 類型和 Plug-in 名稱。(如需支援的 Plug-in 類型的說明，請參閱表格 D-25 中的「-t」選項。)
deactivate -t type name	關閉和停用指定的 Plug-in 類型和 Plug-in 名稱。(如需支援的 Plug-in 類型的說明，請參閱表格 D-25 中的「-t」選項。)
list	列出所有支援的 Plug-in 類型、名稱和啟動狀態。(如需支援的 Plug-in 類型的說明，請參閱表格 D-25 中的「-t」選項。)
version	顯示公用程式的版本。

選項	說明
-v	在詳細模式下執行：顯示有關正在執行的指令之所有可用資訊。預設為關閉。
-q	在無訊息模式下執行：如果作業成功，則不顯示任何資訊 (如果發生錯誤，則會顯示錯誤資訊)。不顯示危險指令的確認提示。預設為關閉。
-r	與 activate 指令一起使用時，可將 Plug-in 實體複製到 Calendar Server Plug-in 目錄。與 deactivate 指令一起使用時，可從 Plug-in 目錄刪除 Plug-in。
-t type	指定 Plug-in 的以下支援的類型之一︰ ac 增加或置換預設群組排程存取控制機制。 attr 增加或置換儲存與擷取使用者屬性的機制。 auth - 增加或置換登入認證機制。 locate - 擷取指定的合格 URL 之行事曆 ID。 lookup - 增加或置換預設行事曆查找機制。 xlate - 增加或置換進來和外送資料的格式轉換。

選項	說明
-t DestinationDB	指定 csrename 產生包含轉換的使用者名稱的新資料庫所在的目標目錄。預設為 MigratedDB。csrename 完成後，ics.conf 檔案中的 caldb.berkeleydb.homedir.path 參數必須指向目標資料庫。可以重設 caldb.berkeleydb.homedir.path 以指向目標資料庫目錄，也可以將目標資料庫檔案移至該參數所指定的目錄。
-c ConfigFile ics.conf	一個輸入參數，可指定 Calendar Server 配置檔案。預設為 ics.conf 檔案。csrename 使用配置檔案中的 caldb.berkeleydb.homedir.path 參數，以決定輸入行事曆資料庫的位置。行事曆資料庫的預設位置為 cal_svr_base/var/opt/SUNWics5/csdb。
-e ErrorFile	csrename 在其中寫入所有錯誤或無法解決的資料庫項目的檔案。預設為 MigrateError。
-m MappingFile	指定輸入對映檔案。預設為 MigrateMapping。輸入對映檔案是文字檔案，可將現有使用者 ID 對映至新使用者 ID。執行 csrename 之前，必須先建立對映檔案。每一行指定一個項目，新舊值之間用空格分隔。例如： tchang tc897675 jsmith js963123 bkamdar bk548769 如果在稽核搜索結果時發現一個或多個要變更的名稱被忽略，您可以透過建立僅包含遺漏名稱的新對映檔案和重新執行 csrename 來修正該錯誤。
DB\|LDAP	指定要進行更新的資料庫： DB 僅轉換新行事曆資料庫中的使用者 ID (預設)。 LDAP 同時轉換新行事曆資料庫和 LDAP 目錄伺服器屬性中的使用者 ID。

指令	說明
create name	為指定的行事曆 ID 建立新資源。
delete [name]	刪除一個資源，或在未指定資源 name 時刪除所有資源。
enable [name]	啟用一個資源，或在未指定資源 name 時啟用所有資源。
disable [name]	停用一個資源，或在未指定資源 name 時停用所有資源。
list [name]	顯示單一資源行事曆，或在未指定資源 name 時顯示所有資源行事曆。如果包含 -h host 選項，則顯示該後端伺服器上指定名稱 (或所有資源行事曆) 的行事曆屬性。


註	如果上述任一指令的 name 中包含空格，則必須將該 name 置於引號 (" ") 中。

選項	說明
-v	在詳細模式下執行：顯示有關正在執行的指令之所有可用資訊。預設為關閉。
-q	在無訊息模式下執行：如果作業成功，則不顯示任何資訊 (如果發生錯誤，則會顯示錯誤資訊)。不顯示危險指令的確認提示。預設為關閉。
-a [aces]	所指定行事曆的存取控制項目 (ACE)。ACE 決定可以存取群組排程行事曆的人員，以及他們擁有的許可權類型，如建立、刪除、讀取和寫入權限。ACE 字串或存取控制清單 (ACL) 必須置於引號 ("") 中。預設為 ics.conf 檔案中的 resource.default.acl 參數。如需有關 ACE 格式的資訊，請參閱第 13 章「管理行事曆」。
-b [basedn]	用於指定資源的 LDAP 基底 DN (識別名稱)。預設使用 ics.conf 檔案中的 local.ugldapbasedn 參數的值。
-c calid	icsCalendar 屬性。此選項需要與 create 指令一起使用。如需更多資訊，請參閱建立行事曆唯一識別碼 (calid)。
-d domain	指定託管 (虛擬) 網域的名稱。預設使用 ics.conf 檔案中 service.defaultdomain 參數的值。
-t [description]	指定有關行事曆目的的可檢視註釋。預設為無說明。
-h host	指定資源行事曆所在之後端伺服器的名稱。此選項僅適用於 list 指令。
-k yes\|no	指定是否允許與資源 (如會議室) 關聯之行事曆的雙預定。例如，yes 表示資源行事曆可以為同一時段排程一個以上的事件。如果忽略 -k 選項，則預設使用 ics.conf 檔案中 resource.allow.doublebook 參數的值。但是，僅在建立行事曆時，才使用 resource.allow.doublebook 參數。建立行事曆之後，Calendar Server 將檢查行事曆特性 (ics50calprops.db) 以決定是否允許雙預定。如果您需要為行事曆變更行事曆特性以允許或不允許雙預定，請重新執行帶有 -k 選項的 csresource。
-m email	指定資源的 LDAP mail 屬性 (主要電子郵件位址)。
-o owner	主要所有者。預設使用 ics.conf 檔案中 service.admin.calmaster.userid 的值。
-y otherowners	其他所有者。多位所有者必須置於引號 (" ") 中，並以空格分隔。預設為無其他所有者。
version [name]	顯示公用程式的版本。


小心	Calendar Server 6.x csrestore 與 2.x 版本的 csrestore 不相容。請勿嘗試復原使用 Calendar Server 2.x csrestore 備份的資料，因為這可能會導致資料遺失。

指令	說明
database inputdir	從包含備份行事曆資料庫的指定輸入目錄或輸入檔案復原行事曆資料庫。此作業會覆寫目前行事曆資料庫的所有先前內容。
calendar inputfile	從指定的輸入檔案復原指定的行事曆 ID。檔案的資料格式由檔案名稱的副檔名決定︰ .ics 為 iCalendar (text/calendar) 格式。 .xml 為 XML (text/xml) 格式。如果指定的行事曆 ID 已經存在，則系統在復原行事曆的資料之前會將該資料清除。
defcal inputfile	從指定的輸入檔案復原指定使用者 ID 的預設行事曆。檔案的資料格式由檔案名稱的副檔名決定︰ .ics 為 iCalendar (text/calendar) 格式。 .xml 為 XML (text/xml) 格式。
version	顯示公用程式的版本。