De machtigingen voor een klasnotitieblok wijzigen

Als een docent een school verlaat of van klas verandert, is het gebruikelijk om een of meer klasnotitieblokken over te dragen naar een andere docent.

Met dit script kan de IT-beheerder inhoud van klasnotitieblok kopiëren en overdragen van de OneDrive van de voormalige docent naar de OneDrive van de nieuwe docent. Met het script worden ook de inrichtings- en tolerante API's opnieuw geactiveerd om ervoor te zorgen dat alle verplaatste klasnotitieblokken en de inhoud ervan, zoals de samenwerkingsruimte, inhoudsbibliotheek en notitieblokken van leerlingen/studenten, correct zijn ingesteld. Daarnaast wordt er een e-mailbericht met een koppeling naar het notitieblok op de nieuwe locatie verzonden naar alle leerlingen/studenten in de klas.

In dit voorbeeld worden de volgende aspecten van de API behandeld. Een toegangstoken verkrijgen met behulp van Azure PowerShell na de overdracht van een klasnotitieblok

Azure PowerShell - gebruikt voor het verkrijgen van een toegangstoken voor communicatie met de OneNote klasnottieblokken-API. Twee Microsoft 365-account met OneDrive ingesteld. In dit voorbeeld wordt een notitieblok van de ene docent OneDrive naar een ander notitieblok overgebracht.

Om ervoor te zorgen dat OneDrive is ingesteld, meldt u zich aan bij Microsoft 365 en selecteert u OneDrive  in het startprogramma voor apps . Als u naar OneDrive wordt gebracht, bent u klaar. OneNote Class Notebook dat is gemaakt met behulp van de OneNote Class Notebooks-API van Microsoft, is het notebook dat wordt overgedragen tussen docenten.

Machtigingen wijzigen

1. Haal een client-id op, zoals beschreven onder Authenticate using Azure AD (enterprise apps) (Authenticeren met behulp van Azure AD (bedrijfsapps)). Wanneer u om een omleidings-URI wordt gevraagd, is "http://localhost" voldoende:

2. Download deze opslagplaats als een ZIP-bestand naar uw lokale computer en pak de bestanden uit of kloon de opslagplaats in een lokale kopie van Git.

   Voeg een ingesprongen alinea toe onder een genummerde stap door de cursor vóór de /para-tag te plaatsen en vervolgens op Enter te drukken.

3. Bewerk OneNoteClassNotebooksApiSample.ps1. Zoek de volgende tokens en vervang ze door werkelijke waarden:

   <AZURE_AD_TENANT_NAME>: dit is uw Microsoft 365 tenant, bijvoorbeeld 'contoso.com'.

   < CLIENT_ID - > Dit is de client-id van de app, bijvoorbeeld "471afe29-4aee-4bc5-9aaf-468ee5bbe20a".

   <MY_ADMIN_LOGIN>: dit is de aanmeldingsnaam van uw IT-beheerder Microsoft 365.

   <MY_ADMIN_PASSWORD>: dit is het wachtwoord van uw IT-beheerder Microsoft 365.

   < NOTEBOOK_ID - > Dit is de id van het over te brengen notitieblok.

   <SOURCE_TEACHER_ID>: dit is de aanmeldingsnaam van de oorspronkelijke docent die eigenaar is van het notitieblok.

   <DESTINATION_TEACHER_ID>: dit is de aanmeldingsnaam van de nieuwe docent die het notitieblok ontvangt.

4. Nadat alle bovengenoemde plaatsaanduidingen zijn vervangen door echte waarden (vergeet niet om elke waarde tussen dubbele aanhalingstekens te zetten), hoeft u alleen nog het script uit te voeren.

5. Als het script met succes is uitgevoerd, krijgt u een tekenreeks met het correlatiegetal. Zorg ervoor dat u het correlatienummer opslaat voor toekomstig gebruik.

6. Ga naar de OneDrive van de doeldocent en open de map Klasnotitieblokken. In deze map vindt u het overgedragen klasnotitieblok. Dit proces kan een paar minuten duren.