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