Sun Java System Calendar Server 6 2005Q4 管理指南

csresource

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–28 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–29 csresource 实用程序命令选项


选项	说明
`-v`	在详细模式下运行：显示正在执行的命令的所有可用信息。默认值为 off。
`-q`	在静默模式下运行：如果操作成功，则不会显示任何信息；如果出现错误，则显示错误信息。抑制破坏性命令的确认提示。默认值为 off。
`-a [aces]`	指定日历的访问控制条目 (Access Control Entries, ACE)。ACE 决定可以访问组计划日历的人员以及他们拥有的权限类型，例如创建、删除、读取和写入权限。ACE 字符串或存取控制表 (Access Control List, ACL) 必须括在双引号 (`" "`) 中。默认值为 ics.conf 文件中的 resource.default.acl 参数。有关 ACE 格式的信息，请参见日历访问控制。
`-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`	显示实用程序的版本。

示例

显示所有资源日历及其 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
```