Copy-OnPremToCloudDistributionGroupMembership.ps1


Description

Purpose

Copies the distribution group membership from an on-premise distribution group to a cloud distribution group.

Detailed Description

This function copies the distribution group membership from an on-premise distribution group to a cloud distribution group.

Back to Top

Usage

Example 1

Copy-OnPremToCloudDistributionGroupMembership -OnPremGroup "OnPremGroup1" -CloudGroup "CloudGroup1"

Copies the distribution group membership from OnPremGroup1 to CloudGroup1.

Back to Top

Notes

Author: Unknown Date: Unknown

Back to Top


Script

Function Copy-OnPremToCloudDistributionGroupMembership {
    <#
    .SYNOPSIS
    Copies the distribution group membership from an on-premise distribution group to a cloud distribution group.
    
    .DESCRIPTION
    This function copies the distribution group membership from an on-premise distribution group to a cloud distribution group.
    
    .PARAMETER OnPremGroup
    The name of the on-premise distribution group.
    
    .PARAMETER CloudGroup
    The name of the cloud distribution group.
    
    .EXAMPLE
    Copy-OnPremToCloudDistributionGroupMembership -OnPremGroup "OnPremGroup1" -CloudGroup "CloudGroup1"
    Copies the distribution group membership from OnPremGroup1 to CloudGroup1.
    
    .NOTES
    Author: Unknown
    Date: Unknown
    #>
    [CmdletBinding(
        SupportsShouldProcess = $true
    )]
    param (
        [Parameter( Mandatory = $true,
            HelpMessage = "Enter the name of the on-premise distribution group."
        )]
        [string]
        $OnPremGroup,

        [Parameter( Mandatory = $true,
            HelpMessage = "Enter the name of the cloud distribution group."
        )]
        [string]
        $CloudGroup
    )

    process {
        if ($PSCmdlet.ShouldProcess("$CloudGroup", "Copy On-Premise Group $OnPremGroup Memberships")) {
            # Get members of the on-premise distribution group
            $OnPremGroupMembers = Get-DistributionGroupMember -Identity $OnPremGroup -ResultSize Unlimited

            # Get members of the cloud distribution group
            $CloudGroupMembers = Get-DistributionGroupMember -Identity $CloudGroup -ResultSize Unlimited

            # Add members to the cloud distribution group
            foreach ($Member in $OnPremGroupMembers) {
                if ($CloudGroupMembers -notcontains $Member) {
                    Add-DistributionGroupMember -Identity $CloudGroup -Member $Member.PrimarySmtpAddress -ErrorAction SilentlyContinue
                }
            }
        }
    }
}

Back to Top

Download

Please feel free to copy parts of the script or if you would like to download the entire script, simply click the download button. You can download the complete repository in a zip file by clicking the Download link in the menu bar on the left hand side of the page.


Report Issues

You can report an issue or contribute to this site on GitHub. Simply click the button below and add any relevant notes. I will attempt to respond to all issues as soon as possible.

Issue


Back to Top