O365Synchronizer

What's Changed

• Support Azure Automation output logging safely by @PrzemyslawKlys in #55

Full Changelog: Compare v1.0.6 to v1.0.7

Full Changelog: Compare v1.0.5 to v1.0.6

Adds optional diagnostic streams for synchronization and safer log retention.

• Use -LogStream Verbose -Verbose or -LogStream Information -InformationAction Continue with Sync-O365PersonalContact, Sync-O365Contact, and Clear-O365PersonalContact. Host output remains the default, and diagnostic messages do not enter returned synchronization data.
• Requires PSWriteColor 1.0.5 or later.
• Log retention now requires an explicit -LogFilePattern matching the active log filename. When LogMaximum is positive without a pattern, pruning is skipped with a warning. The active log, unrelated files, directories, and links are protected; -WhatIf previews removal.

Azure Automation runbooks using the Verbose stream must enable verbose job logging. Live Azure job capture has not been verified.

What's Changed

• Refactor group membership checks for users and contacts by @TheLuBu in #29
• Add Claude Code GitHub Workflow by @PrzemyslawKlys in #30
• Fix contact sync edge cases by @PrzemyslawKlys in #31
• Harden contact payload construction by @PrzemyslawKlys in #32
• Sync external mail users by @PrzemyslawKlys in #33
• Add OData prefilter support for user sync by @PrzemyslawKlys in #34
• Document private helper functions by @PrzemyslawKlys in #35
• Sync department and manager fields by @PrzemyslawKlys in #36
• Add category support for personal contact sync by @PrzemyslawKlys in #37
• Handle contact folder removal when not empty by @PrzemyslawKlys in #38
• Fix: Prevent string concat when adding Categories by @kevinmcgillicuddy in #39
• Fix: Escape folder name OData filters + stabilize Compare-UserToContact output by @PrzemyslawKlys in #40
• Fix PowerShell Gallery preview badge by @PrzemyslawKlys in #41
• Generate unique org contact names for homonyms by @PrzemyslawKlys in #44
• Add opt-in hidden address list filtering for personal sync by @PrzemyslawKlys in #43
• Modernize PowerForge options and Pester assertions by @PrzemyslawKlys in #47
• Configure grouped low-noise Dependabot updates by @PrzemyslawKlys in #46
• Bump the all-dependencies group with 3 updates by @dependabot[bot] in #48
• Fix personal contact nickname source by @PrzemyslawKlys in #50

New Contributors

• @TheLuBu made their first contribution in #29
• @PrzemyslawKlys made their first contribution in #30
• @kevinmcgillicuddy made their first contribution in #39
• @dependabot[bot] made their first contribution in #48

Full Changelog: Compare v1.0.3 to v1.0.4

What's new

• Fixes problem with synchronizing proper contacts when using folders

Full Changelog: Compare v1.0.2 to v1.0.3

What's new

• Fixes bug when not using folder for synchronization it would prompt for contact folder id

Full Changelog: Compare v1.0.1 to v1.0.2

What's new

• Fixes too small amount of contacts gathered when using folders

Full Changelog: Compare v1.0.0 to v1.0.1

What's new

• Added Sync-O365PersonalContactFilter to allow filtering of users to synchronize by properties
• Added Sync-O365PersonalContactFilterGroup to allow filtering of users to synchronize by group membership (ID only)
• Allow synchronizing of contacts to personal contacts in Outlook to specific Folder (only 1 level deep)

# synchronize contacts for 1 user of two types (Member, Contact) using GUID prefix and filtering by company name
# this will only synchronize contacts that have CompanyName starting with 'Evotec' or 'Ziomek'
# this will also require contacts to be in a group by 'e7772951-4b0e-4f10-8f38-eae9b8f55962'
# this will also create a folder 'O365Sync' in user's personal contacts and put synchronized contacts there
# this will also return the results in a table
Sync-O365PersonalContact -UserId 'test@evotec.pl' -MemberTypes 'Contact', 'Member' -GuidPrefix 'O365Synchronizer' -PassThru {
    Sync-O365PersonalContactFilter -Type Include -Property 'CompanyName' -Value 'Evotec*','Ziomek*' -Operator 'like'
    Sync-O365PersonalContactFilterGroup -Type Include -GroupID 'e7772951-4b0e-4f10-8f38-eae9b8f55962'
} -FolderName 'O365Sync' | Format-Table

• Improved Clear-O365PersonalContact to allow clearing of contacts in specific Folder, including deleting the folder itself

# this will only delete synchronized ones (based on FileAs property that has to convert to GUID, with GUID prefix) from specific folder
Clear-O365PersonalContact -Identity 'testAccount@evotec.pl' -GuidPrefix 'O365Synchronizer' -FolderName 'O365' -WhatIf

# this will only delete synchronized ones (based on FileAs property that has to convert to GUID, with GUID prefix) from specific folder, including the folder
Clear-O365PersonalContact -Identity 'testAccount@evotec.pl' -GuidPrefix 'O365Synchronizer' -FolderName 'O365Sync' -FolderRemove -WhatIf

Full Changelog: Compare v0.0.4 to v1.0.0