如果授課者離開學校或變更班級,您很常將一或多個課程筆記本移轉給另一位授課者。
此腳本可讓 IT 管理員 將課程筆記本內容從原授課者的 OneDrive 複製並傳輸到新授課者的 OneDrive。 腳本也會重新觸發佈建和寬鬆 API,以確保所有重新配置的課程筆記本及其內容,例如其共同作業空間、內容庫和學生筆記本都正確設定。 此外,含有可在新位置開啟筆記本之連結的電子郵件,也會傳送給班級中的所有學生。
此範例涵蓋以下 API 層面。 使用 Azure PowerShell 取得存取權杖以發佈課程筆記本轉換
Azure PowerShell:用來取得存取權杖以與 OneNote 課程筆記本 API 溝通。 兩個已設定 OneDrive 的 Microsoft 365 帳戶 - 此範例會將筆記本從一位授課者的 OneDrive 移轉到另一個。
若要確保 OneDrive 已設定完成,請登入 Microsoft 365 ,然後在 App 啟動器 中選取 [OneDrive]。 如果您被帶往 OneDrive,表示您已完成所有設定。 使用 Microsoft OneNote 課程筆記本 API 建立的 OneNote 課程筆記本,是在授課者之間傳輸的筆記本。
變更權限
-
使用 Azure AD (企業 App) [驗證] 底下所述取得用戶端 ID。 要求重新導向 URI 時,「http://localhost」即已足夠:
-
將此 Repo 當做 ZIP 檔案下載到您的本機電腦並解壓縮檔案,或將存放庫複製到 Git 的本地副本中。
將游標放在 /para 卷標前面,然後按 Enter,即可在編號步驟下新增縮排段落。
-
編輯 OneNoteClassNotebooksApiSample.ps1。 尋找下列權杖,並以實際值取代下列權杖:
<AZURE_AD_TENANT_NAME> - 這是您的 Microsoft 365 租使用者,例如「contoso.com」。
<CLIENT_ID>:這是您 App 的用戶端 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,然後開啟 [課程筆記本] 資料夾。 在此資料夾中,您會找到已傳輸的課程筆記本。 此程序可能需要幾分鐘的時間。