教师转移脚本有助于将 OneDrive 托管的 OneNote 课堂笔记本从一名教师转移到另一名教师。 它将笔记本及其内容复制到新教师的 OneDrive,重新生成课堂笔记本元数据和权限,并且可以选择性地删除对原始笔记本的访问权限。
注意
此脚本当前正在测试中。 首先将其与小型试点配合使用,验证复制的笔记本,并在广泛使用之前与Microsoft共享反馈。
何时使用此脚本
在以下情况下使用此脚本:
- 课堂笔记本托管在教师的 OneDrive 中。
- 新教师需要成为笔记本的主要所有者。
- 新教师已经是原始笔记本上的共同教师。
- 在将笔记本移动到新教师的 OneDrive 时,需要保留学生内容。
对于由Microsoft Teams 或Microsoft 365 LTI支持的课堂笔记本,不需要此脚本,教师访问是通过团队或课堂容器管理的。
脚本的作用
脚本:
- 将课堂笔记本从原始教师的 OneDrive 复制到共同教师的 OneDrive。
- 保留笔记本分区和学生内容。
- 重新生成标准课堂笔记本权限结构。
- 将新教师设置为复制笔记本的主要所有者。
- 使学生分区对每个学生保持私密。
- 使内容库对学生保持只读。
- 保留协作空间行为。
- (可选)撤销对原始笔记本的访问权限。
该脚本不会自动通知学生。 转移后,新教师在准备就绪时与学生共享新笔记本链接。
开始之前
请确保配有:
已安装 PowerShell 7。 从 安装 PowerShell 下载它。
教师转移脚本: Copy-ClassNotebookToCoTeacher.ps1
有权访问原始课堂笔记本的协教帐户。
管理员脚本请求的 Microsoft Graph 委托权限的同意审批。
该脚本使用 Microsoft Graph,并在已登录用户的上下文下运行。 首次在租户中运行时,它可能会请求管理员同意与Files、网站、备注和用户相关的委派权限。
如果租户使用管理员同意工作流,管理员可以在Microsoft Entra 管理中心中查看请求。 有关详细信息,请参阅查看管理员同意请求。
安装所需的 Microsoft Graph PowerShell 模块
- 打开 PowerShell 7。
- 运行以下命令:
Install-Module Microsoft.Graph.Authentication, Microsoft.Graph.Files, Microsoft.Graph.Sites, Microsoft.Graph.Users -Scope CurrentUser - 如果系统提示信任 PSGallery 存储库,请键入 Y,然后按 Enter。
运行教师转移脚本
重要
确保在 aka.ms/OneNoteEDUScripts 使用此脚本的最新版本。
- 将脚本保存到同事计算机上的文件夹。
- 在 PowerShell 7 中,转到保存脚本的文件夹。
- 运行脚本:
.\Copy-ClassNotebookToCoTeacher.ps1 - 当浏览器登录窗口打开时,使用共同教师的学校帐户登录。
- 按照脚本中的提示选择源笔记本并创建新副本。
- 脚本完成后,打开复制的笔记本并确认笔记本内容和权限看起来正确。
重命名复制的笔记本
为复制的笔记本提供一个明确标识新所有者或类上下文的名称。
例如,重命名:
- 10 年级科学 - 琼斯
需要:
- 10 年级科学 - 史密斯
如果原始教师在转换期间仍有权访问原始笔记本,这有助于避免混淆。
与学生共享新笔记本
验证复制的笔记本后:
- 打开复制的课堂笔记本。
- 使用标准 “管理笔记本” 流或共享 OneDrive 链接来分发新的笔记本链接。
- 告诉学生何时应开始使用新笔记本。
- 确认学生可以访问自己的分区和预期的共享区域。
该脚本不会自动发送通知,因此新教师可以控制学生何时移动到复制的笔记本。
传输后验证权限
脚本运行后,检查:
- 教师在整个笔记本中具有写入权限。
- 每个学生仅对自己的学生分区组具有写入权限。
- 锁定的笔记本会按预期保留只读学生访问权限。
- 学生对内容库具有只读访问权限。
- 协作空间访问按预期工作。
- 新教师是复制笔记本的主要所有者。
- 原始笔记本中的用户对复制的笔记本具有等效访问权限。
可选:删除对原始笔记本的访问权限
确认复制的笔记本正常工作后,如果转换计划需要,则可以删除对原始笔记本的访问权限。
此操作有助于防止教师或学生错误地继续使用旧笔记本。
警告
在确认复制的笔记本包含预期的内容和权限之前,请勿删除对原始笔记本的访问权限。
向Microsoft发送反馈
由于此脚本仍在测试中,因此请分享有关以下内容的反馈:
- 任何传输失败或错误消息。
- 缺少笔记本内容。
- 权限问题。
- 学生访问问题。
- 令人困惑的提示或设置步骤。
- 需要管理员运行版本的方案。
- 涉及团队到团队或 SharePoint 支持的笔记本迁移的方案。
包括脚本版本、租户上下文、笔记本详细信息以及所发生情况的摘要。