Ändern von Berechtigungen für ein Kursnotizbuch

Wenn eine Lehrkraft eine Schule verlässt oder den Unterricht wechselt, ist es üblich, ein oder mehrere Kursnotizbücher an eine andere Lehrkraft zu übertragen.

Dieses Skript ermöglicht IT-Admin das Kopieren und Übertragen von Kursnotizbuchinhalten aus dem OneDrive des ehemaligen Dozenten auf das OneDrive des neuen Lehrers. Das Skript löst auch die Bereitstellung und die freizügigen APIs erneut aus, um sicherzustellen, dass alle verschobenen Kursnotizbücher und seine Inhalte, z. B. der Bereich für die Zusammenarbeit, die Inhaltsbibliothek und die Notizbücher der Kursteilnehmer, ordnungsgemäß eingerichtet sind. Darüber hinaus wird eine E-Mail mit einem Link zum Öffnen des Notizbuchs am 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, bei dem OneDrive eingerichtet ist: In diesem Beispiel wird ein Notizbuch vom OneDrive einer Lehrkraft auf das OneDrive eines anderen Notizbuchs übertragen.

Um sicherzustellen, dass OneDrive eingerichtet ist, melden Sie sich bei Microsoft 365 an, und wählen Sie OneDrive im App-Startfeld aus. Wenn Sie zu OneDrive weitergeleitet werden, sind Sie bereit. 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 eingezogenen Absatz unter einem nummerierten Schritt hinzu, indem Sie den Cursor vor das Tag /para 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 der Anmeldename Ihrer IT-Admin Microsoft 365.

   <MY_ADMIN_PASSWORD>: Dies ist Ihr IT-Admin Microsoft 365-Kennwort.

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

   <SOURCE_TEACHER_ID>: Dies ist der Anmeldename des ursprünglichen Pädagogen, dem das Notizbuch gehört.

   <DESTINATION_TEACHER_ID>: Dies ist der Anmeldename der neuen Lehrkraft, die 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 zur späteren Referenz zu speichern.

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