课程文件命令行工具

管理员可以使用课程文件命令行工具进行以下操作：

• 使用 backup_course_files 命令备份一个或多个课程的课程文件内容。
• 使用 update-course-directory 命令更改一个或多个课程的默认目录。
• 使用 update-course-permission 命令更改个别课程目录的权限。
• 使用 update-all-course-hd-permission 命令更改 /courses 目录的权限。
• 使用 MoveCourseContent 命令将一个或多个课程的内容移动到课程文件。

---

备份一个课程的课程文件内容

使用 backup_course_files 命令，管理员可以将课程文件从单个课程解压缩到选定的目录，以进行备份。

如果您的机构许可资源管理，则仅在课程的默认目录未更改的情况下管理员可以使用此命令。管理员可以使用现有的孤立搜索来查找与已删除课程相关联的文件。To learn more, see Managing Orphaned Content.

1. 从命令行中，更改为以下目录，其中 BLACKBOARD 是 Blackboard Learn 的安装位置：

   UNIX 语法： cd $BLACKBOARD_HOME/apps/bbcms/bin

   Windows 语法： cd C:\%BLACKBOARD_HOME%\apps\bbcms\bin

2. 从该目录中，键入以下命令和操作：

   backup_course_files.[sh|bat] COURSE_ID BACKUP_DIRECTORY

   UNIX 示例：

   backup_course_files.sh Course001 /backups

   Windows 示例：

   backup_course_files.bat Course001 c:\backups

---

更改默认目录

使用 update-course-directory 命令，管理员可以更改一个或多个课程的默认目录。

1. 从命令行中，更改为以下目录，其中 BLACKBOARD 是 Blackboard Learn 的安装位置：
   
   UNIX 语法： cd $BLACKBOARD_HOME/apps/bbcms/bin

   Windows 语法： cd C:\%BLACKBOARD_HOME%\apps\bbcms\bin

2. 从此目录中，使用相应的操作键入命令：
   • 重置单个课程的目录：
     update-course-directory.[sh|bat] --c COURSE_ID --p COURSE_DIRECTORY
   • 使用数据源重置一组课程的目录：
     update-course-directory.[sh|bat] --d DATA_SOURCE_BUID --p COURSE_DIRECTORY
   • 使用馈送文件重置一组课程的目录：
     update-course-directory.[sh|bat] --f FEED_FILE_NAME

操作说明

操作	说明
--c	提供课程的课程 ID。
--d	提供数据源批处理 UID 以获得课程列表。
--f	提供包含每个课程 ID 及其目标课程目录的列表的馈送文件的名称。例如：courseId1|/courses/Files courseId2|/institution/Files 使用该选项，管理员能对他们在某个馈送文件中指定的一组课程运行该操作。基本上，这是一个包含两个步骤的过程： 使用数据库创建馈送文件。 对该馈送文件运行命令行。 使用馈送文件的好处在于管理员将获得尝试对其执行操作的课程的记录。
--p	要将内容移动到默认课程目录之外的某个位置，请提供目标课程目录。

示例：

update-course-directory.sh --c Course001 --p /courses/Files
update-course-directory.sh --d DATA_SOURCE_BUID --p /institution/Files
update-course-directory.bat --f c:\feedfile.txt

---

更改单独课程目录的权限

使用 update-course-permission 命令，管理员可以更改个别课程目录的权限。

1. 从命令行中，更改为以下目录，其中 BLACKBOARD 是 Blackboard Learn 的安装位置：

   UNIX 语法： cd $BLACKBOARD_HOME/apps/bbcms/bin

   Windows 语法： cd C:\%BLACKBOARD_HOME%\apps\bbcms\bin

2. 从此目录中，使用相应的操作键入命令：
   • 更改单个课程的权限：
     update-course-permission.[sh|bat] --c COURSEID --r ROLE --p PERMISSIONS --o OPERATION --e RECURSIVEFLAG
   • 使用数据源更改一组课程的权限：
     update-course-permission.[sh|bat] --d DATA_SOURCE_BUID --r ROLE --p PERMISSIONS --o OPERATION
   • 使用馈送文件更改一组课程的权限：
     update-course-permission.[sh|bat] --f FEED_FILE_NAME

   更改权限的命令

   操作	说明
   --c	提供课程的课程 ID。
   --d	提供数据源批处理 UID 以获得课程列表。
   --r	按照 --o 和 --p 操作中定义的内容，提供更改其权限的角色名称。
   --p	按照 --o 操作中定义的内容，提供要添加、删除或重置的权限。有效值： R：读取 W：写入 D：删除 M：管理 可以通过将值进行组合来定义多种权限。例如，要更改某个角色的读取和写入权限，请使用 RW。
   --o	提供要执行的操作： add：添加 --p 操作中定义的权限。 remove：删除 --p 操作中定义的权限。 reset：重置 --p 操作中定义的权限。
   --f	提供包含每个课程 ID、角色、权限和操作和递归标记的馈送文件的名称。例如： courseId1|Instructor|RDM|add|y courseId2|Course Builder|RD|reset|n 使用“馈送文件”选项，管理员可以在生成的文件中指定想对其运行该操作的任意一组课程。基本上，这是一个包含两个步骤的过程： 使用数据库创建馈送文件。 对该馈送文件运行命令行。 使用馈送文件的好处在于管理员将获得尝试对其执行操作的课程的记录。
   --e	递归标志“y”或“n” y = 对课程主文件夹及其子文件夹和文件所做的递归式权限更改。 n= 仅对课程主文件夹所做的权限更改。

   示例：

   update-course-permission.bat --c Test001 --r Instructor --p RWD --o add
   update-course-permission.sh --c Test002 --r 'Course Builder' --p RWDM --o reset
   update-course-permission.bat --c Test003 --r Student --p RW --o remove
   update-course-permission.sh --d DATA_SOURCE_BUID --r Instructor --p RDM --o reset
   update-course-permission.bat --f c:\feedfile.txt

---

更改 /courses 目录的权限

使用 update-all-course-hd-permission 命令，管理员可以更改 /courses 目录的权限。

1. 从命令行中，更改为以下目录，其中 BLACKBOARD 是 Blackboard Learn 的安装位置：
   
   UNIX Syntax： cd $BLACKBOARD_HOME/apps/bbcms/bin

   Windows 语法： cd C:\%BLACKBOARD_HOME%\apps\bbcms\bin

2. 从此目录中，使用相应的操作键入命令：

   update-all-course-hd-permission.[sh|bat] --r ROLE --p PERMISSIONS --o OPERATION

   更改 /courses 目录权限的命令

   操作	说明
   --r	按照 --o 和 --p 操作中定义的内容，提供更改其权限的角色名称。
   --p	按照 --o 操作中定义的内容，提供要添加、删除或重置的权限。有效值： R：读取 W：写入 D：删除 M：管理 可以通过将值进行组合来定义多种权限。例如，要更改某个角色的读取和写入权限，请使用 RW。
   --o	提供要执行的操作： add：添加 --p 操作中定义的权限。 remove：删除 --p 操作中定义的权限。 reset：重置 --p 操作中定义的权限。
   --e	递归标志“y”或“n” y = 对课程主文件夹及其子文件夹和文件所做的递归式权限更改。 n= 仅对课程主文件夹所做的权限更改。

   示例：

   update-all-course-hd-permission.bat --r Instructor --p RWD --e n --o add
   update-all-course-hd-permission.sh --r 'Course Builder' --p RWDM --e y --o reset
   update-all-course-hd-permission.bat --r Student --p RW --e y --o remove

---

移动一个或多个课程的内容

从 Blackboard Learn 9.1 版之前的版本进行升级时，管理员可以将现有课程资源移动到课程文件目录，以便利用其功能。使用 MoveCourseContent 命令，管理员可以将课程内容批量移动到课程文件中。移动到课程文件的所有内容均存储在 /courses/CourseID 目录的子文件夹中。子文件夹将使用以下格式命名：Course_ ID_ImportedContent_DATETIMESTAMP。

如果您的机构许可资源管理，管理员可在资源库中定义单个目标文件夹，以将所有内容都移动到该文件夹。子文件夹将使用以下格式命名：Course_ID_ImportedContent_DATETIMESTAMP。

1. 从命令行中，更改为以下目录，其中 BLACKBOARD 是 Blackboard Learn 的安装位置：

   UNIX 语法： cd $BLACKBOARD_HOME/apps/bbcms/bin

   Windows 语法： cd C:\%BLACKBOARD_HOME%\apps\bbcms\bin

2. 从此目录中，使用相应的操作键入命令：
   • 移动单个课程的文件：
     MoveCourseContent.[sh|bat] --c COURSE_ID [--p COURSE_DIRECTORY]
   • 使用批处理移动一组课程的文件：
     MoveCourseContent.[sh|bat] --b BATCH_UID [--p Course Builder]
   • 使用数据源移动一组课程的文件：
     MoveCourseContent.[sh|bat] --d DATA_SOURCE_BUID [--p Course Builder]
   • 使用馈送文件移动一组课程的文件：
     MoveCourseContent.[sh|bat] --f FEED_FILE_NAME [--p Course Builder]

移动内容的命令

操作	说明
--c	提供课程的课程 ID。
--b	提供批处理 UID 以获得课程列表。
--d	提供数据源批处理 UID 以获得课程列表。
--f	提供包含每个课程 ID 或批处理 UID 及其目标课程目录的列表的馈送文件的名称。馈送文件不使用分隔符，但是必须指定标题（标题将详细显示 course_id 或 batch_uid 提供哪些列）。例如： batch_uid crs_batch-UID 或 course_id crs_course-ID 或 ***FileHeader course_id crs_course-ID ***FileFooter 使用“馈送”文件选项，管理员可以在生成的文件中指定想对其运行操作的任意一组课程。基本上，这是一个包含两个步骤的过程： 使用数据库创建馈送文件。 对该馈送文件运行命令行。 使用馈送文件的好处在于管理员将获得尝试对其执行操作的课程的记录。
--p	要将内容移动到除默认课程目录之外的某个位置，请提供目标目录。

示例：

MoveCourseContent.sh --c Course001
MoveCourseContent.sh --c Course002 --p /institution/Course002<
MoveCourseContent.bat --b BATCH_UID
MoveCourseContent.bat --d DATA_SOURCE_BUID
MoveCourseContent.bat --f c:\feedfile.txt --p c:\institution\All