This repository has been archived by the owner on Sep 17, 2023. It is now read-only.
-
Notifications
You must be signed in to change notification settings - Fork 13
Commit
This commit does not belong to any branch on this repository, and may belong to a fork outside of the repository.
Copy permissions added, DomainController parameter added
- Loading branch information
Showing
2 changed files
with
222 additions
and
143 deletions.
There are no files selected for viewing
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
| Original file line number | Diff line number | Diff line change |
|---|---|---|
| @@ -1,141 +1,172 @@ | ||
| <# | ||
| .SYNOPSIS | ||
| Copy a selected receive connectors and it's configuration to other Exchange Servers | ||
| Thomas Stensitzki | ||
| THIS CODE IS MADE AVAILABLE AS IS, WITHOUT WARRANTY OF ANY KIND. THE ENTIRE | ||
| RISK OF THE USE OR THE RESULTS FROM THE USE OF THIS CODE REMAINS WITH THE USER. | ||
| Version 1.0, 2014-12-03 | ||
| Please send ideas, comments and suggestions to [email protected] | ||
| .LINK | ||
| More information can be found at http://www.granikos.eu/en/scripts | ||
| .DESCRIPTION | ||
| This script copies a receive connector from a source Exchange Server to a single target | ||
| Exchange server or to all Exchange servers | ||
| .NOTES | ||
| Requirements | ||
| - Windows Server 2008 R2 SP1, Windows Server 2012 or Windows Server 2012 R2 | ||
| Revision History | ||
| -------------------------------------------------------------------------------- | ||
| 1.0 Initial community release | ||
| .PARAMETER ConnectorName | ||
| Name of the connector the new IP addresses should be added to | ||
| .EXAMPLE | ||
| .\Copy-ReceiveConnector.ps1 -SourceServer MBX01 -ConnectorName nikos-one-RC2 -TargetServer MBX2 | ||
| .EXAMPLE | ||
| .\Copy-ReceiveConnector.ps1 -SourceServer MBX01 -ConnectorName nikos-one-RC1 -CopyToAllOther | ||
| #> | ||
|
|
||
| param( | ||
| [parameter(Mandatory=$true,HelpMessage='Source Exchange server to copy from',ParameterSetName="CRC")] | ||
| [string] $SourceServer, | ||
| [parameter(Mandatory=$true,HelpMessage='Name of the receive connector to copy',ParameterSetName="CRC")] | ||
| [string] $ConnectorName, | ||
| [parameter(Mandatory=$false,HelpMessage='Target Exchange server to copy the selected receive connector to',ParameterSetName="CRC")] | ||
| [string] $TargetServer = "", | ||
| [parameter(Mandatory=$false,HelpMessage='Copy to all other Exchange servers',ParameterSetName="CRC")] | ||
| [switch] $CopyToAllOther | ||
| ) | ||
|
|
||
| Set-StrictMode -Version Latest | ||
|
|
||
| $sourceRC = $null | ||
|
|
||
| ### FUNCTIONS ----------------------------- | ||
|
|
||
| function CopyToServer([string]$TargetServerName) { | ||
|
|
||
| $sourceRC = Get-ReceiveConnector -Server $SourceServer | ?{$_.Name -eq $ConnectorName} -ErrorAction SilentlyContinue | ||
|
|
||
| $targetRC = Get-ReceiveConnector -Server $TargetServerName | ?{$_.Name -eq $ConnectorName} -ErrorAction SilentlyContinue | ||
|
|
||
| if(($sourceRC -ne $null) -and ($targetRC -eq $null)){ | ||
| Write-Verbose "Adding new receive connector to $serverName" | ||
|
|
||
| New-ReceiveConnector -Name $sourceRC.Name ` | ||
| -TransportRole $sourceRC.TransportRole ` | ||
| -RemoteIPRanges $sourceRC.RemoteIPRanges ` | ||
| -Bindings $sourceRC.Bindings ` | ||
| -Banner $sourceRC.Banner ` | ||
| -ChunkingEnabled $sourceRC.ChunkingEnabled ` | ||
| -DefaultDomain $sourceRC.DefaultDomain ` | ||
| -DeliveryStatusNotificationEnabled $sourceRC.DeliveryStatusNotificationEnabled ` | ||
| -EightBitMimeEnabled $sourceRC.EightBitMimeEnabled ` | ||
| -DomainSecureEnabled $sourceRC.DomainSecureEnabled ` | ||
| -LongAddressesEnabled $sourceRC.LongAddressesEnabled ` | ||
| -OrarEnabled $sourceRC.OrarEnabled ` | ||
| -Comment $sourceRC.Comment ` | ||
| -Enabled $sourceRC.Enabled ` | ||
| -ConnectionTimeout $sourceRC.ConnectionTimeout ` | ||
| -ConnectionInactivityTimeout $sourceRC.ConnectionInactivityTimeout ` | ||
| -MessageRateLimit $sourceRC.MessageRateLimit ` | ||
| -MaxInboundConnection $sourceRC.MaxInboundConnection ` | ||
| -MaxInboundConnectionPerSource $sourceRC.MaxInboundConnectionPerSource ` | ||
| -MaxInboundConnectionPercentagePerSource $sourceRC.MaxInboundConnectionPercentagePerSource ` | ||
| -MaxHeaderSize $sourceRC.MaxHeaderSize ` | ||
| -MaxHopCount $sourceRC.MaxHopCount ` | ||
| -MaxLocalHopCount $sourceRC.MaxLocalHopCount ` | ||
| -MaxLogonFailures $sourceRC.MaxLogonFailures ` | ||
| -MaxMessageSize $sourceRC.MaxMessageSize ` | ||
| -MaxProtocolErrors $sourceRC.MaxProtocolErrors ` | ||
| -MaxRecipientsPerMessage $sourceRC.MaxRecipientsPerMessage ` | ||
| -PermissionGroups $sourceRC.PermissionGroups ` | ||
| -PipeliningEnabled $sourceRC.PipeLiningEnabled ` | ||
| -ProtocolLoggingLevel $sourceRC.ProtocolLoggingLevel ` | ||
| -RequireEHLODomain $sourceRC.RequireEHLODomain ` | ||
| -RequireTLS $sourceRC.RequireTLS ` | ||
| -EnableAuthGSSAPI $sourceRC.EnableAuthGSSAPI ` | ||
| -ExtendedProtectionPolicy $sourceRC.ExtendedProtectionPolicy ` | ||
| -SizeEnabled $sourceRC.SizeEnabled ` | ||
| -TarpitInterval $sourceRC.TarpitInterval ` | ||
| -EnhancedStatusCodesEnabled $sourceRC.EnhancedStatusCodesEnabled ` | ||
| -Server $TargetServerName | ||
| } | ||
| else { | ||
| Write-Output "Receive connector is null or target connector already exists, nothing to do here." | ||
| } | ||
| } | ||
|
|
||
| function CopyToAllServers { | ||
| Write-Verbose "Copy receive connector to all other Exchange servers" | ||
|
|
||
| $frontendServers = Get-ExchangeServer | ?{($_.AdminDisplayVersion.Major -eq 15) -and (([string]$_.ServerRole).Contains("ClientAccess")) -and ($_.Name -ne $SourceServer)} | ||
|
|
||
| foreach($server in $frontendServers){ | ||
| Write-Output "Adding to server: $server" | ||
| CopyToServer $server | ||
| } | ||
|
|
||
| Write-Verbose "Copying to all Exchange servers done" | ||
| } | ||
|
|
||
| ### MAIN ---------------------------------- | ||
|
|
||
| if($ViewEntireForest) { | ||
| Write-Verbose "Setting ADServerSettings -ViewEntireForest $true" | ||
| Set-ADServerSettings -ViewEntireForets $true | ||
| } | ||
|
|
||
| if((-not $CopyToAllOther) -and ($TargetServer -eq "")){ | ||
| Write-Output "You need to either specific a dedicated target server using the -TargetServer " | ||
| Write-Output "attribute or select the -CopyToAllOther switch" | ||
| break | ||
| } | ||
| elseif($TargetServer -ne ""){ | ||
| # Copy to a single Exchange server | ||
| CopyToServer $TargetServer | ||
| } | ||
| elseif($CopyToAllOther){ | ||
| # Copy to all other Exchange servers | ||
| CopyToAllServers | ||
| } | ||
| <# | ||
| .SYNOPSIS | ||
| Copy a selected receive connector and it's configuration and permissions to other Exchange Servers | ||
| Thomas Stensitzki | ||
| THIS CODE IS MADE AVAILABLE AS IS, WITHOUT WARRANTY OF ANY KIND. THE ENTIRE | ||
| RISK OF THE USE OR THE RESULTS FROM THE USE OF THIS CODE REMAINS WITH THE USER. | ||
| Version 1.1, 2015-06-18 | ||
| Please send ideas, comments and suggestions to [email protected] | ||
| .LINK | ||
| More information can be found at http://www.granikos.eu/en/scripts | ||
| .DESCRIPTION | ||
| This script copies a receive connector from a source Exchange Server to a single target | ||
| Exchange server or to all Exchange servers. | ||
| Configured permissions are copied as well | ||
| .NOTES | ||
| Requirements | ||
| - Windows Server 2008 R2 SP1, Windows Server 2012 or Windows Server 2012 R2 | ||
| Revision History | ||
| -------------------------------------------------------------------------------- | ||
| 1.0 Initial community release | ||
| 1.1 Domain Controller parameter added, permissions group copy added | ||
| .PARAMETER ConnectorName | ||
| Name of the connector the new IP addresses should be added to | ||
| .PARAMETER SourceServer | ||
| Name of the receive connector to copy | ||
| .PARAMETER TargetServer | ||
| Target Exchange server to copy the selected receive connector to | ||
| .PARAMETER DomainController | ||
| Domain Controller name | ||
| .PARAMETER CopyToAllOther | ||
| Switch to copy to all other Exchange servers | ||
| .EXAMPLE | ||
| .\Copy-ReceiveConnector.ps1 -SourceServer MBX01 -ConnectorName nikos-one-RC2 -TargetServer MBX2 -DomainController MYDC1.mcsmemail.de | ||
| .EXAMPLE | ||
| .\Copy-ReceiveConnector.ps1 -SourceServer MBX01 -ConnectorName nikos-one-RC1 -CopyToAllOther -DomainController MYDC1.mcsmemail.de | ||
| #> | ||
|
|
||
| param( | ||
| [parameter(Mandatory=$true,HelpMessage='Source Exchange server to copy from')] | ||
| [string] $SourceServer, | ||
| [parameter(Mandatory=$true,HelpMessage='Name of the receive connector to copy')] | ||
| [string] $ConnectorName, | ||
| [parameter(Mandatory=$false,HelpMessage='Target Exchange server to copy the selected receive connector to')] | ||
| [string] $TargetServer = "", | ||
| [parameter(Mandatory=$true,HelpMessage='Domain Controller name')] | ||
| [string] $DomainController = "", | ||
| [parameter(Mandatory=$false,HelpMessage='Copy to all other Exchange servers')] | ||
| [switch] $CopyToAllOther | ||
| ) | ||
|
|
||
| Set-StrictMode -Version Latest | ||
|
|
||
| Import-Module ActiveDirectory | ||
|
|
||
| $sourceRC = $null | ||
|
|
||
| ### FUNCTIONS ----------------------------- | ||
|
|
||
| function CopyToServer([string]$TargetServerName) { | ||
|
|
||
| $sourceRC = Get-ReceiveConnector -Server $SourceServer | ?{$_.Name -eq $ConnectorName} -ErrorAction SilentlyContinue | ||
|
|
||
| $targetRC = Get-ReceiveConnector -Server $TargetServerName | ?{$_.Name -eq $ConnectorName} -ErrorAction SilentlyContinue | ||
|
|
||
| if(($sourceRC -ne $null) -and ($targetRC -eq $null)){ | ||
| Write-Verbose "Adding new receive connector to $serverName" | ||
|
|
||
| # clear permission groups for Exchange Server 2013 (thanks to Jeffery Land, https://jefferyland.wordpress.com) | ||
| $tempPermissionGroups = @($sourceRC.PermissionGroups) -split ", " | Select-String -Pattern "Custom" -NotMatch | ||
| $temp = "$($tempPermissionGroups)" | ||
| $sourceRC.PermissionGroups = $temp.Replace(" ", ", ") | ||
|
|
||
| # create new Receive Connector | ||
| New-ReceiveConnector -Name $sourceRC.Name ` | ||
| -TransportRole $sourceRC.TransportRole ` | ||
| -RemoteIPRanges $sourceRC.RemoteIPRanges ` | ||
| -Bindings $sourceRC.Bindings ` | ||
| -Banner $sourceRC.Banner ` | ||
| -ChunkingEnabled $sourceRC.ChunkingEnabled ` | ||
| -DefaultDomain $sourceRC.DefaultDomain ` | ||
| -DeliveryStatusNotificationEnabled $sourceRC.DeliveryStatusNotificationEnabled ` | ||
| -EightBitMimeEnabled $sourceRC.EightBitMimeEnabled ` | ||
| -DomainSecureEnabled $sourceRC.DomainSecureEnabled ` | ||
| -LongAddressesEnabled $sourceRC.LongAddressesEnabled ` | ||
| -OrarEnabled $sourceRC.OrarEnabled ` | ||
| -Comment $sourceRC.Comment ` | ||
| -Enabled $sourceRC.Enabled ` | ||
| -ConnectionTimeout $sourceRC.ConnectionTimeout ` | ||
| -ConnectionInactivityTimeout $sourceRC.ConnectionInactivityTimeout ` | ||
| -MessageRateLimit $sourceRC.MessageRateLimit ` | ||
| -MaxInboundConnection $sourceRC.MaxInboundConnection ` | ||
| -MaxInboundConnectionPerSource $sourceRC.MaxInboundConnectionPerSource ` | ||
| -MaxInboundConnectionPercentagePerSource $sourceRC.MaxInboundConnectionPercentagePerSource ` | ||
| -MaxHeaderSize $sourceRC.MaxHeaderSize ` | ||
| -MaxHopCount $sourceRC.MaxHopCount ` | ||
| -MaxLocalHopCount $sourceRC.MaxLocalHopCount ` | ||
| -MaxLogonFailures $sourceRC.MaxLogonFailures ` | ||
| -MaxMessageSize $sourceRC.MaxMessageSize ` | ||
| -MaxProtocolErrors $sourceRC.MaxProtocolErrors ` | ||
| -MaxRecipientsPerMessage $sourceRC.MaxRecipientsPerMessage ` | ||
| -PermissionGroups $sourceRC.PermissionGroups ` | ||
| -PipeliningEnabled $sourceRC.PipeLiningEnabled ` | ||
| -ProtocolLoggingLevel $sourceRC.ProtocolLoggingLevel ` | ||
| -RequireEHLODomain $sourceRC.RequireEHLODomain ` | ||
| -RequireTLS $sourceRC.RequireTLS ` | ||
| -EnableAuthGSSAPI $sourceRC.EnableAuthGSSAPI ` | ||
| -ExtendedProtectionPolicy $sourceRC.ExtendedProtectionPolicy ` | ||
| -SizeEnabled $sourceRC.SizeEnabled ` | ||
| -TarpitInterval $sourceRC.TarpitInterval ` -EnhancedStatusCodesEnabled $sourceRC.EnhancedStatusCodesEnabled ` -Server $TargetServerName | ||
|
|
||
| # fetch non inherited permissons from source connector | ||
| $sourcePermissions = Get-ReceiveConnector -Identity $sourceRC | Get-ADPermission | where {$_.IsInherited -eq $false} | ||
|
|
||
| # set access rights on target connector | ||
| $sourcePermissions | foreach { | ||
| Get-ReceiveConnector "$($TargetServerName)\$($sourceRC.Name)" | Add-ADPermission -DomainController $DomainController -User $_.User -Deny:$_.Deny -AccessRights $_.AccessRights -ExtendedRights $_.ExtendedRights | ||
| } | ||
| } | ||
| else { | ||
| Write-Output "Receive connector is null or target connector already exists, nothing to do here." | ||
| } | ||
| } | ||
|
|
||
| function CopyToAllServers { | ||
| Write-Verbose "Copy receive connector to all other Exchange servers" | ||
|
|
||
| $frontendServers = Get-ExchangeServer | ?{($_.AdminDisplayVersion.Major -eq 15) -and (([string]$_.ServerRole).Contains("ClientAccess")) -and ($_.Name -ne $SourceServer)} | ||
|
|
||
| foreach($server in $frontendServers){ | ||
| Write-Output "Adding to server: $server" | ||
| CopyToServer $server | ||
| } | ||
|
|
||
| Write-Verbose "Copying to all Exchange servers done" | ||
| } | ||
|
|
||
| ### MAIN ---------------------------------- | ||
|
|
||
| if($ViewEntireForest) { | ||
| Write-Verbose "Setting ADServerSettings -ViewEntireForest $true" | ||
| Set-ADServerSettings -ViewEntireForets $true | ||
| } | ||
|
|
||
| if((-not $CopyToAllOther) -and ($TargetServer -eq "")){ | ||
| Write-Output "You need to either specific a dedicated target server using the -TargetServer " | ||
| Write-Output "attribute or select the -CopyToAllOther switch" | ||
| break | ||
| } | ||
| elseif($TargetServer -ne ""){ | ||
| # Copy to a single Exchange server | ||
| CopyToServer $TargetServer | ||
| } | ||
| elseif($CopyToAllOther){ | ||
| # Copy to all other Exchange servers | ||
| CopyToAllServers | ||
| } | ||
|
|
||
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
| Original file line number | Diff line number | Diff line change |
|---|---|---|
| @@ -1,2 +1,50 @@ | ||
| # Copy-ReceiveConnector | ||
| Copy Exchange Server 2013 receive connector settings | ||
| .SYNOPSIS | ||
| Copy a selected receive connector and it's configuration and permissions to other Exchange Servers | ||
|
|
||
| Thomas Stensitzki | ||
|
|
||
| THIS CODE IS MADE AVAILABLE AS IS, WITHOUT WARRANTY OF ANY KIND. THE ENTIRE | ||
| RISK OF THE USE OR THE RESULTS FROM THE USE OF THIS CODE REMAINS WITH THE USER. | ||
|
|
||
| Version 1.1, 2015-06-18 | ||
|
|
||
| Please send ideas, comments and suggestions to [email protected] | ||
|
|
||
| .LINK | ||
| More information can be found at http://www.granikos.eu/en/scripts | ||
|
|
||
| .DESCRIPTION | ||
| This script copies a receive connector from a source Exchange Server to a single target | ||
| Exchange server or to all Exchange servers. | ||
|
|
||
| Configured permissions are copied as well | ||
|
|
||
| .NOTES | ||
| Requirements | ||
| - Windows Server 2008 R2 SP1, Windows Server 2012 or Windows Server 2012 R2 | ||
|
|
||
| Revision History | ||
| -------------------------------------------------------------------------------- | ||
| 1.0 Initial community release | ||
| 1.1 Domain Controller parameter added, permissions group copy added | ||
|
|
||
| .PARAMETER ConnectorName | ||
| Name of the connector the new IP addresses should be added to | ||
|
|
||
| .PARAMETER SourceServer | ||
| Name of the receive connector to copy | ||
|
|
||
| .PARAMETER TargetServer | ||
| Target Exchange server to copy the selected receive connector to | ||
|
|
||
| .PARAMETER DomainController | ||
| Domain Controller name | ||
|
|
||
| .PARAMETER CopyToAllOther | ||
| Switch to copy to all other Exchange servers | ||
|
|
||
| .EXAMPLE | ||
| .\Copy-ReceiveConnector.ps1 -SourceServer MBX01 -ConnectorName nikos-one-RC2 -TargetServer MBX2 -DomainController MYDC1.mcsmemail.de | ||
|
|
||
| .EXAMPLE | ||
| .\Copy-ReceiveConnector.ps1 -SourceServer MBX01 -ConnectorName nikos-one-RC1 -CopyToAllOther -DomainController MYDC1.mcsmemail.de |