Public/func_Invoke-GALSync.ps1

function Invoke-GALSync {
    [CmdletBinding(SupportsShouldProcess, DefaultParameterSetName = "TargetGroup")]
    param (
        [parameter(Mandatory)][string]$ContactFolderName,

        [parameter(Mandatory, ParameterSetName = "AllUsers")][switch]$AllUsers,
        [parameter(Mandatory, ParameterSetName = "TargetGroup")][string]$TargetGroup,
        [parameter(Mandatory, ParameterSetName = "TargetMailbox")][string[]]$TargetMailbox,

        [string]$SourceGroup,
        [string[]]$ExcludeUser,
        [string]$UserFilter,
        [switch]$ExcludeHiddenFromAddressList,
        [switch]$IncludeOrgContacts,
        [switch]$BusinessPhoneAsMobile,
        [switch]$IncludeUsersWithoutPhone,
        [switch]$IncludeUsersWithoutEmail,
        [switch]$IncludeDisabledUsers,
        [switch]$IncludeGuests,

        [ValidateRange(1, 16)][int]$ThrottleLimit = 4
    )
    function Split-List ($Values) {
        return $Values | ForEach-Object { $_ -split "," } | ForEach-Object { $_.Trim() } | Where-Object { $_ }
    }
    Assert-Permission -GroupMember:([bool]($TargetGroup -or $SourceGroup)) -OrgContact:$IncludeOrgContacts

    $excluded = @(Split-List $ExcludeUser)
    $directorySplat = @{}
    foreach ($key in $PSBoundParameters.Keys) {
        if ($key -in (Get-Command Get-GALDirectoryUser).Parameters.Keys) {
            $directorySplat[$key] = $PSBoundParameters[$key]
        }
    }
    $directorySplat.ExcludeUser = $excluded
    $directoryUsers = @(Get-GALDirectoryUser @directorySplat)
    if (-not $directoryUsers) {
        throw "No directory users match the filters, stopping because syncing an empty list would remove every contact"
    }

    $mailboxes = @(Get-TargetMailbox -AllUsers:$AllUsers -TargetGroup $TargetGroup -TargetMailbox @(Split-List $TargetMailbox) -ExcludeUser $excluded)
    if (-not $mailboxes) {
        Write-Warning "No target mailboxes found"
        return
    }
    Write-VerboseEvent "Syncing $($directoryUsers.Count) contacts to $($mailboxes.Count) mailbox(es), $ThrottleLimit at a time"

    $syncSplat = @{
        ContactFolderName   = $ContactFolderName
        DirectoryUser       = $directoryUsers
        WhatIf              = [bool]$WhatIfPreference
        # a mailbox that was named explicitly and is unavailable is most likely a typo
        FailWhenUnavailable = ($PSCmdlet.ParameterSetName -eq "TargetMailbox")
    }
    $manifest = Join-Path -Path $MyInvocation.MyCommand.Module.ModuleBase -ChildPath "GAL-Sync.psd1"
    $session = $script:galSyncData
    $verbose = $VerbosePreference
    $results = $mailboxes | ForEach-Object -ThrottleLimit $ThrottleLimit -Parallel {
        $VerbosePreference = $using:verbose
        $module = Get-Module -Name GAL-Sync
        if (-not $module) {
            # share the connection (and token refreshes) with the runspace that started the sync
            $module = Import-Module -Name $using:manifest -PassThru -Verbose:$false
            & $module { param ($session) $script:galSyncData = $session } $using:session
        }
        $syncSplat = $using:syncSplat
        Sync-GALMailbox -Mailbox $_ @syncSplat
    }
    return $results
}