IT admins can use this guide to deploy the OneNote Class Notebook add-in across a school or district, using Group Policy templates. With this approach, IT admins push out default settings for a particular Learning Management System (LMS) or Student Information System (SIS) or Gradebook. By deploying this Group Policy, teachers have less to set up themselves to get started with assignment and grade integration with the Class Notebook add-in.
Getting started
Download the Class Notebook Add-in Group Policy templates.
This file contains a single language-neutral ClassNotebook.admx file and multiple language-specific ClassNotebook.adml files, one for each of the 43 languages that the Class Notebook add-in supports.
For information about using ADMX and ADML files for Windows 7 and Windows Server 2008 and above, see Managing Group Policy ADMX Files Step-by-Step Guide.
Managing LMS/SIS connections
The Class Notebook add-in allows teachers to connect to their school’s or district’s LMS/SIS. When teachers click the Connections button in the Class Notebook add-in, they are prompted for connection settings that will allow the Class Notebook add-in to connect to their LMS/SIS, as shown in the following screenshot.
With this Group Policy, an IT administrator can set these settings for every teacher in the school or district. Once enabled, teachers will not need to enter the settings manually. The following screenshot shows the Manage Connections dialog with a Group Policy enabled.
The following sections describe these settings in detail and how they apply to each of the LMS/SIS that the Class Notebook add-in supports.
Group Policy settings
The following table lists the group policy settings that are included in the above templates.
|
Setting name |
Registry path and value name |
Description |
|
LMS Name |
HKEY_CURRENT_USER\Software\Policies\Microsoft\OneNoteClassNotebook\Lms |
This policy setting specifies the LMS or SIS that the Class Notebook add-in connects to. For the list of allowed values for this setting, refer to the section LMS/SIS settings below. |
|
LMS Host URL |
HKEY_CURRENT_USER\Software\Policies\Microsoft\OneNoteClassNotebook\LmsHost |
This policy setting specifies the host URL of the LMS or SIS. Some LMS and SIS have constant host URLs while others have host URLs that are specific to a school or a district. Refer to the section LMS/SIS settings below to see which LMS or SIS have school- or district-specific host URLs. |
|
Client ID |
HKEY_CURRENT_USER\Software\Policies\Microsoft\OneNoteClassNotebook\ClientId |
This policy setting specifies the client ID (sometimes referred to as the app ID) that the Class Notebook add-in requires in order to call the Application Programming Interface (API) of some LMS or SIS. Client IDs are typically generated by the IT admin within the LMS/SIS user interface along with the client secret. Refer to the section LMS/SIS settings below to see which LMS or SIS require a client ID. |
|
Client Secret |
HKEY_CURRENT_USER\Software\Policies\Microsoft\OneNoteClassNotebook\ClientSecret |
This policy setting specifies the client secret (sometimes referred to as the app secret) that the Class Notebook add-in requires in order to call the Application Programming Interface (API) of some LMS or SIS. Client secrets are typically generated by the IT admin within the LMS/SIS user interface along with the client ID. Refer to the section LMS/SIS settings below to see which LMS or SIS require a client secret. |
|
Access Token |
HKEY_CURRENT_USER\Software\Policies\Microsoft\OneNoteClassNotebook\AccessToken |
This policy setting specifies the access token (sometimes referred to as the user token) that the Class Notebook add-in requires in order to call the Application Programming Interface (API) of some LMS or SIS. Access tokens are typically generated by the IT admin within the LMS/SIS admin settings. Refer to the section LMS/SIS settings below to see which LMS or SIS require an access token. |
|
School Code |
HKEY_CURRENT_USER\Software\Policies\Microsoft\OneNoteClassNotebook\SchoolCode |
This policy setting specifies the school code that the Class Notebook add-in for OneNote requires in order to call the Application Programming Interface (API) of some LMS or SIS. The value of this setting is typically obtained from the LMS/SIS admin settings. Refer to the section LMS/SIS settings below to see which LMS or SIS require a school code. |
|
School Year |
HKEY_CURRENT_USER\Software\Policies\Microsoft\OneNoteClassNotebook\SchoolYear |
This policy setting specifies the school year that the Class Notebook add-in for OneNote requires in order to call the Application Programming Interface (API) of some LMS or SIS. The value of this setting is typically obtained from the LMS/SIS admin settings. Refer to the section LMS/SIS settings below to see which LMS or SIS require a school year. |
LMS/SIS settings
The following sections list the group policy settings required by each of the LMS/SIS supported by the Class Notebook add-in.
A setting value in bold indicates that the value must be entered verbatim. For example, the value for the setting LMS Name.
A setting value in italics indicates that the value is specific to your school’s or district’s LMS/SIS instance and is typically obtained from the admin's settings. For example, the value for the setting LMS Host URL.
Aeries
|
Setting name |
Setting type |
Value |
|
LMS Name |
String |
Aeries |
Blackbaud
|
Setting name |
Setting type |
Value |
|
LMS Name |
String |
Blackbaud |
|
LMS Host URL |
String |
The URL of your school’s or district’s Blackbaud instance. For example: https://contoso.blackbaud.com |
Brightspace
|
Setting name |
Setting type |
Value |
|
LMS Name |
String |
Brightspace |
|
LMS Host URL |
String |
The URL of your school’s or district’s Brightspace instance. For example: https://contoso.brightspace.com |
|
Client ID |
String |
Generated within your Brightspace instance. See this guide for information about how to generate the client ID. |
|
Client Secret |
String |
Generated within your Brightspace instance. See this guide for information about how to generate the client secret. |
Canvas
|
Setting name |
Setting type |
Value |
|
LMS Name |
String |
Canvas |
|
LMS Host URL |
String |
The URL of your school’s or district’s Canvas instance. For example: https://contoso.instructure.com |
Classter
|
Setting name |
Setting type |
Value |
|
LMS Name |
String |
Classter |
Edmodo
|
Setting name |
Setting type |
Value |
|
LMS Name |
String |
Edmodo |
Edsby
|
Setting name |
Setting type |
Value |
|
LMS Name |
String |
Edsby |
|
LMS Organization Name |
String |
The name of the organization that IT admin specifies during registration |
EDUonGo
|
Setting name |
Setting type |
Value |
|
LMS Name |
String |
EDUonGo |
|
LMS Host URL |
String |
The URL of your school’s or district’s EDUonGo instance. For example: https://contoso.eduongo.com |
ESD
|
Setting name |
Setting type |
Value |
|
LMS Name |
String |
ESD |
|
LMS Organization Name |
String |
The name of the organization that IT admin specifies during registration |
Firefly Learning
|
Setting name |
Setting type |
Value |
|
LMS Name |
String |
FireflyLearning |
|
LMS Host URL |
String |
The URL of your school’s or district’s Firefly Learning instance. For example: https://contoso.firefly.com |
Google Classroom
|
Setting name |
Setting type |
Value |
|
LMS Name |
String |
GoogleClassroom |
Infinite Campus (Blocked)
|
Setting name |
Setting type |
Value |
|
LMS Name |
String |
Infinite Campus (Blocked) |
Live Grades
|
Setting name |
Setting type |
Value |
|
LMS Name |
String |
Live Grades |
LMS365
|
Setting name |
Setting type |
Value |
|
LMS Name |
String |
Lms365 |
|
LMS Host URL |
String |
The URL of your school’s or district’s LMS365 instance. For example: https://contoso.sharepoint.com |
Microsoft Classroom
|
Setting name |
Setting type |
Value |
|
LMS Name |
String |
MicrosoftClassroom |
Microsoft Teams
|
Setting name |
Setting type |
Value |
|
LMS Name |
String |
Microsoft Teams |
Moodle
|
Setting name |
Setting type |
Value |
|
LMS Name |
String |
Moodle |
|
LMS Host URL |
String |
The URL of your school’s or district’s Moodle instance. For example: https://contoso.moodle.com |
|
Access Token |
String |
Generated within your Moodle instance. See this guide for information about how to generate the access token. |
OpenLearning
|
Setting name |
Setting type |
Value |
|
LMS Name |
String |
OpenLearning |
PowerSchool
|
Setting name |
Setting type |
Value |
|
LMS Name |
String |
PowerSchool |
Rediker
|
Setting name |
Setting type |
Value |
|
LMS Name |
String |
Rediker |
|
LMS Host URL |
String |
The URL of your school’s or district’s Moodle instance. For example: https://www.plusportals.com/contoso |
|
School Code |
String |
Obtained from your Rediker instance. See https://aka.ms/classnotebookaddinrediker. |
|
School Year |
String |
Obtained from your Rediker instance. See https://aka.ms/classnotebookaddinrediker. |
School Bytes
|
Setting name |
Setting type |
Value |
|
LMS Name |
String |
SchoolBytes |
Schoology
|
Setting name |
Setting type |
Value |
|
LMS Name |
String |
Schoology |
|
LMS Host URL |
String |
The URL of your school’s or district’s Schoology instance. For example: https://contoso.schoology.com |
|
Client ID |
String |
Generated within your Schoology instance. See https://aka.ms/classnotebookaddinschoology |
|
Client Secret |
String |
Generated within your Schoology instance. See https://aka.ms/classnotebookaddinschoology |
Sebit VCloud
|
Setting name |
Setting type |
Value |
|
LMS Name |
String |
Sebit |
Skyward
|
Setting name |
Setting type |
Value |
|
LMS Name |
String |
Skyward |
SunGard
|
Setting name |
Setting type |
Value |
|
LMS Name |
String |
SunGard |
Synergy
|
Setting name |
Setting type |
Value |
|
LMS Name |
String |
Synergy |
|
LMS Organization Name |
String |
The name of the organization that IT admin specifies during registration |
Teacher Dashboard
|
Setting name |
Setting type |
Value |
|
LMS Name |
String |
TeacherDashboard |
|
LMS Host URL |
String |
The URL of your school’s or district’s Teacher Dashboard instance. For example: https://contoso.teacherdasboard365.com |
WinjiGo
|
Setting name |
Setting type |
Value |
|
LMS Name |
String |
WinjiGo |
