Ändern von Berechtigungen für ein Kursnotizbuch

Wenn ein Lehrer eine Schule verlässt oder den Kurs ändert, ist es üblich, ein oder mehrere Kursnotizbücher an einen anderen Lehrer zu übertragen.

Dieses Skript ermöglicht es IT-Administratoren, Kursnotizbuchinhalte aus dem OneDrive des ehemaligen Lehrers in die OneDrive des neuen Lehrers zu kopieren und zu übertragen. Das Skript löst außerdem die Bereitstellungs- und eingeschränkten APIs erneut aus, um sicherzustellen, dass alle verschobenen Kursnotizbücher und deren Inhalte, z. B. der Platz für die Zusammenarbeit, die Inhaltsbibliothek und Kursteilnehmernotizbücher, ordnungsgemäß eingerichtet sind. Darüber hinaus wird eine E-Mail mit einem Link zum Öffnen des Notizbuchs an seinem neuen Speicherort an alle Kursteilnehmer gesendet.

In diesem Beispiel werden die folgenden Aspekte der API behandelt. Abrufen eines Zugriffstoken, Verwenden von Azure PowerShell POST, Kursnotizbuch-Übertragung

Azure PowerShell – Wird verwendet, um ein Zugriffstoken für die Kommunikation mit der OneNote-Kursnotizbücher-API abzurufen. Zwei Microsoft 365 Konto mit eingerichteter OneDrive – In diesem Beispiel wird ein Notizbuch von der OneDrive eines Lehrers in das notizbuch eines anderen Lehrers übertragen.

Um sicherzustellen, dass OneDrive eingerichtet ist, melden Sie sich bei Microsoft 365 an, und wählen Sie im App-Startfeld OneDrive  aus. Wenn Sie zu OneDrive gebracht werden, sind Sie alle festgelegt. OneNote Kursnotizbuch, das mit der OneNote Kursnotizbuch-API von Microsoft erstellt wurde, ist das Notizbuch, das zwischen Lehrkräften übertragen wird.

Berechtigungen ändern

1. Anfordern einer Client-ID gemäß der Beschreibung unter "Authentifizieren mit Azure AD (Enterprise-Apps)". Wenn Sie nach einem Umleitungs-URI gefragt werden, reicht "http://localhost" aus:

2. Laden Sie dieses Repository als ZIP-Datei auf Ihren lokalen Computer herunter, und extrahieren Sie die Dateien, oder klonen Sie das Repository in eine lokale Kopie von Git.

   Fügen Sie einen eingerückten Absatz unter einem nummerierten Schritt hinzu, indem Sie den Cursor vor das /para-Tag setzen und dann die EINGABETASTE drücken.

3. Bearbeiten Sie OneNoteClassNotebooksApiSample.ps1. Suchen Sie die folgenden Token, und ersetzen Sie sie durch reale Werte:

   <AZURE_AD_TENANT_NAME> - Dies ist Ihr Microsoft 365 Mandant, z. B. "contoso.com".

   <CLIENT_ID> – Die Client-ID Ihrer App, z. B. "471afe29-4aee-4bc5-9aaf-468ee5bbe20a".

   <MY_ADMIN_LOGIN> – Dies ist Ihr IT-Administrator Microsoft 365 Anmeldename.

   <MY_ADMIN_PASSWORD> – Dies ist Ihr IT-Administrator Microsoft 365 Kennwort.

   <NOTEBOOK_ID> – Die ID des zu übertragenden Notizbuchs.

   <SOURCE_TEACHER_ID> – Dies ist der Anmeldename des ursprünglichen Lehrers, dem das Notizbuch gehört.

   <DESTINATION_TEACHER_ID> – Dies ist der Anmeldename des neuen Lehrers, der das Notizbuch erhält.

4. Nachdem alle oben aufgeführten Platzhalter durch reale Werte ersetzt wurden (denken Sie daran, alle Werte in doppelte Anführungszeichen zu setzen), brauchen Sie nur noch das Skript auszuführen.

5. Nachdem das Skript erfolgreich ausgeführt wurde, erhalten Sie eine Zeichenfolge mit der Korrelationszahl. Achten Sie darauf, die Korrelationsnummer für zukünftige Verweise zu speichern.

6. Wechseln Sie zum OneDrive des Zielpädagogen, und öffnen Sie den Ordner "Kursnotizbücher". In diesem Ordner finden Sie das übertragene Kursnotizbuch. Dieser Vorgang kann einige Minuten dauern.