How to Configure Teams Education Guardian Policies in PowerShell Using CsTeamsEducationConfiguration

In primary, secondary, and higher education institutions operating Microsoft 365 Education tenants, Microsoft Teams serves as the primary digital classroom for remote learning, assignment distribution, and student-teacher communication. However, maintaining transparent communication between teachers, students, and parents requires strict compliance with student data privacy frameworks (such as FERPA, GDPR, and COPPA). Educational administrators must regulate how educators communicate with parents and guardians without inadvertently exposing student personal data or creating uncontrolled messaging channels.

To govern parent-teacher integration, Microsoft Teams integrates with School Data Sync (SDS) and provides dedicated tenant-wide education policies managed via the CsTeamsEducationConfiguration cmdlet family. Using PowerShell, education IT administrators can configure whether educators can view student guardian contact information, send automated weekly assignment digest emails to parents, or initiate direct communication. This guide explains how Teams Education configuration policies operate and details how to query, configure, and enforce guardian communication policies using PowerShell.

Understanding Microsoft Teams Education Configuration and Guardian Sync

The CsTeamsEducationConfiguration cmdlet controls how Microsoft Teams interacts with School Data Sync (SDS) to synchronise Student Information System (SIS) records with class teams. Key architectural features governed by this policy include:

• Parent and Guardian Contact Sync: Automatically links parent email addresses and phone numbers extracted from the school’s SIS into student profile metadata within Microsoft 365.
• Parent/Guardian Communication in Class Teams: Determines whether class teachers can click into the Class Team member list to view linked guardian contact details or send direct emails.
• Weekly Assignment Digest Emails: Controls whether the Teams Education system automatically compiles and dispatches a weekly summary email to registered guardians detailing their student’s completed assignments, upcoming due dates, and missing homework.
• Student Privacy Controls: Ensures student guardian contact records are partitioned so educators can only view contact information for students officially enrolled in their specific class teams.

Configuring these settings via PowerShell guarantees institutional consistency across all academic faculties, preventing unauthorized external communication channels while ensuring parents receive critical academic updates.

Prerequisites and PowerShell Module Connection

Managing Teams Education configurations requires the Microsoft Teams PowerShell module version 4.9.0 or later and an account assigned the Global Administrator or Teams Administrator role within a licensed Microsoft 365 Education (A1, A3, or A5) tenant.

Open an elevated PowerShell prompt and check your module version:

Get-Module -ListAvailable -Name MicrosoftTeams

If needed, install or update the module from the PowerShell Gallery:

Install-Module -Name MicrosoftTeams -Force -AllowClobber -Scope CurrentUser

Connect to your Microsoft 365 Education tenant:

Connect-MicrosoftTeams

Verify your active administrative session:

Get-CsTenant | Select-Object DisplayName, TenantId

Inspecting Current Teams Education Configuration

To inspect your educational tenant’s current parent and guardian communication policies, execute Get-CsTeamsEducationConfiguration:

Get-CsTeamsEducationConfiguration

PowerShell outputs the active tenant configuration:

Identity                      : Global
ParentGuardianEnabled         : True
EmailGuardiansEnabled         : True
WeeklyDigestEnabled           : True
GuardianConsentRequired       : False
EducationProfileStatus        : Active

Reviewing these attributes provides immediate visibility into guardian engagement:

• ParentGuardianEnabled: Indicates whether School Data Sync parent-guardian relationship mapping is active within Microsoft Teams.
• EmailGuardiansEnabled: Dictates whether teachers are permitted to trigger direct email communication to student guardians from the Teams client.
• WeeklyDigestEnabled: Governs automated weekly assignment summary dispatches to parents.

Configuring Guardian Engagement and Assignment Digest Policies

To modify how teachers and parents interact within your school district or university, use the Set-CsTeamsEducationConfiguration cmdlet.

Enabling Automated Weekly Assignment Digests

To ensure parents and guardians automatically receive weekly academic progress and homework status emails without requiring manual educator intervention, enable the weekly digest feature:

Set-CsTeamsEducationConfiguration -Identity "Global" `
    -ParentGuardianEnabled $true `
    -WeeklyDigestEnabled $true

Once activated, the Teams Education backend automatically sends an aggregated email digest every weekend to registered guardian email addresses, highlighting past-due assignments and upcoming test schedules.

Restricting Direct Teacher-to-Guardian Emailing

If institutional policy dictates that all official teacher-to-parent communications must pass through a centralised school portal rather than direct personal email, administrators can disable direct educator emailing while keeping weekly automated digests active:

Set-CsTeamsEducationConfiguration -Identity "Global" `
    -ParentGuardianEnabled $true `
    -EmailGuardiansEnabled $false `
    -WeeklyDigestEnabled $true

This setting removes the “Email guardian” button from the teacher’s Class Team interface while preserving background telemetry reporting.

Completely Disabling Guardian Features for Higher Education

In tertiary colleges or universities where adult students are protected by strict adult privacy regulations, parent-guardian tracking is unnecessary. Completely disable guardian features across the tenant:

Set-CsTeamsEducationConfiguration -Identity "Global" `
    -ParentGuardianEnabled $false `
    -EmailGuardiansEnabled $false `
    -WeeklyDigestEnabled $false

Verifying School Data Sync (SDS) Relationship Bindings

For parent-guardian policies to function, student-guardian relationships must be properly mapped in School Data Sync (SDS).

To verify that an individual student account has an associated guardian email registered in the directory, use Microsoft Graph PowerShell or inspect the directory profile:

# Query student directory attributes for guardian associations
Get-CsOnlineUser -Identity "[email protected]" | Select-Object DisplayName, UserPrincipalName, Department, UsageLocation

Administrators can also verify the status of parent-guardian sync profiles directly in the Microsoft 365 admin center under Settings > School Data Sync, ensuring that CSV sync rosters or OneRoster API connectors are healthy without synchronization errors.

Troubleshooting Common Teams Education Configuration Issues

When teachers report that parent contact details are missing or weekly digests are not delivered, review the following configuration checks:

• Missing Guardian Email in SIS: If a guardian does not receive weekly digests, confirm that their email is populated in the student’s SIS record and that SDS has completed synchronization within the past 24 hours.
• Unlicensed Student Accounts: Students must have an active Microsoft 365 Education Student license for assignments and digest telemetry to process.
• Policy Propagation Delays: Changes made via Set-CsTeamsEducationConfiguration can take up to 4 to 8 hours to propagate across global Teams client sessions. Teachers may need to sign out and restart the Teams client to see updated interface permissions.