# SharePoint Groups job plugin
Synchronizes SharePoint groups from a template site to all matter site collections. Monitors group membership changes and propagates them across the SharePoint farm.
DLL: Epona.Jobs.SharepointGroups.dll
# What it does
- Group synchronization — copies group definitions from template site to matter sites
- Membership tracking — detects changes in group membership
- User propagation — adds new users to groups across all sites
- User removal — removes users no longer in source group
- Orphaned user handling — gracefully manages deleted or unavailable accounts
- Selective synchronization — optionally sync specific groups or sites
- Scheduled execution — runs at configured times of day
# Prerequisites
- Template site collection with groups to sync
- Matter site collections with matching group structure
- SharePoint Online or SharePoint 2016+
- Administrator access to SharePoint
# Configuration
# TemplateSiteUrl
Type: string | Required: Yes
Source site URL containing template groups
# TimeOfDay
Type: TimeSpan (list) | Required: Yes
Times of day to run synchronization
# Groups
Type: string (list) | Required: No
Specific group names to sync (empty = all groups)
# SiteCollectionUrls
Type: string (list) | Required: No
Specific sites to update; empty uses matter sites
# ExcludeSiteCollectionUrls
Type: string (list) | Required: No
Sites to skip during synchronization
# Debug
Type: boolean | Required: No
Enable debug logging
# Disabled
Type: boolean | Required: No
Disable group synchronization
# Example configuration
| Property | Example value |
|---|---|
TemplateSiteUrl | https://company.sharepoint.com/sites/template |
TimeOfDay | 09:00:00, 17:00:00 |
Groups | Legal Team, Support Team |
ExcludeSiteCollectionUrls | https://company.sharepoint.com/sites/archive |
# System user exclusion
The plugin automatically skips SHAREPOINT\system user to prevent breaking SharePoint system functionality.
# Troubleshooting
| Issue | Cause | Resolution |
|---|---|---|
| Groups not syncing | TemplateSiteUrl incorrect or inaccessible | Verify template site URL and check permissions |
| Users not added | User not found in SharePoint | Verify user exists and has valid login |
| Synchronization fails | Site collections offline or network issue | Check SharePoint availability and connectivity |