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 |
在详细模式下运行:显示正在执行的命令的所有可用信息。默认值为 off。 |
-q |
在静默模式下运行:
|
-a [aces] |
指定日历的访问控制条目 (Access Control Entries, ACE)。ACE 决定可以访问组计划日历的人员以及他们拥有的权限类型,例如创建、删除、读取和写入权限。ACE 字符串或存取控制表 (Access Control List, 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 通常与用户 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@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