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 aan een andere docent.

Met dit script kunnen IT-Beheer inhoud van klasnotitieblok kopiëren en overdragen van de OneDrive van de voormalige docent naar de OneDrive van de nieuwe docent. Het script activeert ook opnieuw de inrichting en permissie-API's om ervoor te zorgen dat alle verplaatste klasnotitieblokken en de bijbehorende inhoud, zoals de samenwerkingsruimte, inhoudsbibliotheek en notitieblokken van leerlingen/studenten, correct zijn ingesteld. Daarnaast wordt een e-mail met een koppeling om het notitieblok op de nieuwe locatie te openen 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 waarop OneDrive is ingesteld: met dit voorbeeld wordt een notitieblok overgedragen van de OneDrive van de ene docent naar een ander.

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 gaat, bent u klaar. OneNote Class Notebook dat is gemaakt met de OneNote Class Notebooks-API van Microsoft, is het notitieblok 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 naar 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-Beheer Microsoft 365.

   <MY_ADMIN_PASSWORD>: dit is uw IT-Beheer Microsoft 365-wachtwoord.

   < 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. Sla het correlatienummer op 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.