Create Copy-ReceiveConnector.ps1

Initial Upload

Copy-ReceiveConnector.ps1

@@ -0,0 +1,141 @@
+<# 
+    .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
+}