如果教师离开学校或更改班级,通常将一个或多个课堂笔记本转让给另一位教师。
此脚本将允许 IT 管理员将课堂笔记本内容从前教师的 OneDrive 复制并传输到新教师的 OneDrive。 该脚本还将重新触发预配和许可 API,以确保正确设置任何已重新定位的课堂笔记本及其内容,例如协作空间、内容库和学生笔记本。 此外,将向课堂中的所有学生发送一封电子邮件,其中包含用于在其新位置打开笔记本的链接。
本示例介绍了 API 的以下方面。 使用 Azure PowerShell 获取访问令牌,发布课堂笔记本转移
Azure PowerShell - 用于获取访问令牌,以便与 OneNote 课堂笔记本 API 进行通信。 设置了 OneDrive 的两个 Microsoft 365 帐户 - 此示例将笔记本从一个教师的 OneDrive 转移到另一个教师的 OneDrive。
若要确保设置 OneDrive,请登录到 Microsoft 365 并选择应用启动器 中的 OneDrive 。 如果你被带到 OneDrive,则你已全部设置好。 使用 Microsoft 的 OneNote 课堂笔记本 API 创建的 OneNote 课堂笔记本是在教师之间传输的笔记本。
更改权限
-
根据“使用 Azure AD 进行的身份验证(企业应用)”下所述,获取客户端 ID。 如果需要提供重定向 URI,使用“http://localhost”即可:
-
将此存储库作为 ZIP 文件下载到本地计算机并提取文件,或将存储库克隆到 Git 的本地副本中。
通过将光标置于 /para 标记之前,然后按 Enter,在编号步骤下添加缩进段落。
-
编辑 OneNoteClassNotebooksApiSample.ps1。 查找以下令牌并将其替换为实际值:
<AZURE_AD_TENANT_NAME> - 这是 Microsoft 365 租户,例如“contoso.com”。
<CLIENT_ID> - 表示应用的客户端 ID,例如“471afe29-4aee-4bc5-9aaf-468ee5bbe20a”。
<MY_ADMIN_LOGIN> - 这是 IT 管理员 Microsoft 365 登录名。
<MY_ADMIN_PASSWORD> - 这是 IT 管理员 Microsoft 365 密码。
<NOTEBOOK_ID> - 表示要转移的笔记本的 ID。
<SOURCE_TEACHER_ID> - 这是拥有笔记本的原始教师的登录名。
<DESTINATION_TEACHER_ID> - 这是将接收笔记本的新教师的登录名。
-
上述所有占位符均替换为实际值(请记住将每个值括在双引号内)后,执行脚本即可。
-
成功执行脚本后,将收到包含相关数的字符串。 请务必保存相关编号以供将来参考。
-
转到目标教师的 OneDrive 并打开“课堂笔记本” 文件夹。 在此文件夹中,你将找到传输的课堂笔记本。 此过程可能需要几分钟时间。