教師が学校を離れる場合やクラスを変更する場合は、1 つ以上のクラス ノートブックを別の教師に譲渡するのが一般的です。
このスクリプトを使用すると、IT 管理者は、以前の教育者のOneDriveから新しい教育者のOneDriveに Class Notebook のコンテンツをコピーして転送できます。 また、このスクリプトでは、再配置されたクラス ノートブックとそのコンテンツ (コラボレーション スペース、コンテンツ ライブラリ、学生ノートブックなど) が適切に設定されるように、プロビジョニングと許容 API も再度トリガーされます。 さらに、新しい場所でノートブックを開くリンクが記載された電子メールが、クラス内のすべての学生に送信されます。
この例では、API の以下の点について説明します。 Class Notebook で転送されるアクセス トークンは Azure PowerShell POST を使用して取得してください
Azure PowerShell - OneNote クラス ノートブック API と通信するためのアクセス トークンを取得するために使用されます。 OneDriveが設定された 2 つの Microsoft 365 アカウント - このサンプルでは、1 つの教師の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> - "contoso.com" など、 Microsoft 365 テナントです。
<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に移動し、Class Notebooks フォルダーを開きます。 このフォルダーには、転送されたクラス ノートブックが表示されます。 この処理には、数分かかる場合があります。