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 |
在详细模式下运行:显示正在执行的命令的所有可用信息。默认值为 off。 |
-q |
在静默模式下运行:
|
-a [aces] |
指定日历的访问控制条目 (Access Control Entries, ACE)。ACE 决定可以访问组调度日历的人员以及他们拥有的权限类型,例如创建、删除、读取和写入权限。ACE 字符串或存取控制表 (Access Control List, ACL) 必须括在双引号 (" ") 中。 默认值来自 ics.conf 文件中的 resource.default.acl 参数。 有关 ACE 格式的信息,请参见15.4 日历访问控制。 |
-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