csresource 公用程式可建立並管理 LDAP 項目和資源 (如會議室或設備) 的行事曆。(csresource 公用程式僅可用於與資源關聯的行事曆;如果針對使用者的行事曆發出此公用程式,則會傳回錯誤。)指令包括︰
create,為指定的行事曆 ID (calid) 增加新資源
delete,移除一個資源或所有資源
disable,停用一個資源或所有資源
enable,啟用一個資源或所有資源
list,顯示單一資源或所有資源清單
您必須在安裝了 Calendar Server 的機器上本機執行此公用程式。
Calendar Server 可以處於執行中或停止狀態。
您必須以執行 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 common_name csresource [-q|-v] [-b basedn] [-d domain] delete|disable|enable [common_name] csresource [-q|-v] [-b basedn] [-d domain] [-h host] list [common_name] |
下表說明 csresource 公用程式可用的指令。
表 D–26 csresource 公用程式指令
指令 |
說明 |
---|---|
create common_name |
為指定的行事曆 ID 建立新資源。 |
delete [common_name] |
刪除一個資源,或在未指定資源 common_name 時刪除所有資源。 |
enable [common_name] |
啟用一個資源,或在未指定資源 common_name 時啟用所有資源。 |
disable [common_name] |
停用一個資源,或在未指定資源 common_name 時停用所有資源。 |
list [common_name] |
顯示單一資源行事曆,或在未指定資源 name 時顯示所有資源行事曆。 如果包含 -h host 選項,則顯示該後端伺服器上指定名稱 (或所有資源行事曆) 的行事曆屬性。 |
如果上述任一指令的 name 中包含空格,則必須將其置於引號 (" ") 中。
下表說明 csresource 公用程式指令選項。
表 D–27 csresource 公用程式指令選項
選項 |
說明 |
---|---|
-v |
在詳細模式下執行:顯示有關正在執行的指令之所有可用資訊。預設為關閉。 |
-q |
在無訊息模式下執行:
|
-a [aces] |
指定行事曆的存取控制項目 (ACE)。ACE 決定可以存取群組排程行事曆的人員,以及他們擁有的權限類型,例如建立、刪除、讀取和寫入權限。ACE 字串或存取控制清單 (ACL) 必須置於引號 ("") 中。 預設為 ics.conf 檔案中的 resource.default.acl 參數。 如需有關 ACE 格式的資訊,請參閱15.4 Calendar 存取控制。 |
-b [basedn] |
要用於指定之資源的 LDAP 基底 DN (distinguished name,辨別名稱)。預設使用 ics.conf 檔案中 local.ugldapbasedn 參數的值。 |
-c calid |
icsCalendar 屬性。此選項需要與 create 指令一起使用。如需更多資訊,請參閱15.2 建立行事曆唯一識別碼 (calid)。 |
-d domain | |
-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.siteadmin.userid 的值。 |
-y otherowners |
其他所有者。必須將多位所有者置於引號 (" ") 中,並以空格分隔。預設為無其他所有者。 |
version |
顯示公用程式的版本。 |
顯示所有資源行事曆及其 LDAP 屬性的清單︰
csresource -v list
建立行事曆 ID (calid) 為 room100 且可檢視名稱 (LDAP cn 屬性) 為 MeetingRoom100 的資源行事曆:
csresource -m room100@sesta.com - 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