PowerShell ile Exchange Server Client Access URL’lerini Kolayca Yapılandırılması (Paul Cunningham)

06/01/2026 Okuma süresi: 9dk, 0sn

Microsoft Exchange Server ortamlarında Client Access servislerine ait URL ve namespace yapılandırmaları, kurulum sonrası yapılması gereken en kritik işlemlerden biridir. Autodiscover, OWA, ECP, EWS, ActiveSync, MAPI ve Outlook Anywhere gibi servislerin doğru ve tutarlı URL’ler ile yapılandırılması; Outlook bağlantıları, mobil cihaz senkronizasyonu ve kullanıcı deneyimi açısından büyük önem taşır.

Bu makalede kullanılan PowerShell çözümü, Paul Cunningham tarafından geliştirilen ve Exchange topluluğunda yaygın olarak kullanılan ConfigureExchangeURLs.ps1 script’ine dayanmaktadır.

Kaynak : https://practical365.com/powershell-script-configure-exchange-urls/

Github : https://github.com/cunninghamp/ConfigureExchangeURLs.ps1

Kullanılan Script Hakkında

Bu çalışmada referans alınan ConfigureExchangeURLs.ps1 script’i Exchange Server alanında tanınmış bir uzman olan Paul Cunningham tarafından geliştirilmiştir. Bu Script ilk olarak 2015 yılında yayımlanmış ve aşağıdaki platformlar üzerinden toplulukla paylaşılmıştır:

TechNet Gallery
GitHub

Script’in temel amacı Exchange Server üzerindeki tüm Client Access servisleri için tek ve tutarlı bir namespace (URL) yapılandırmasını hızlı ve hatasız bir şekilde uygulamaktır.

ConfigureExchangeURLs.ps1 Nedir?

ConfigureExchangeURLs.ps1, Exchange Server Client Access servislerinin URL yapılandırmasını otomatikleştiren bir PowerShell script’idir.

Script bir Exchange sunucusu üzerinde yer alan tüm Client Access bileşenlerine aynı internal ve external URL’leri uygular.

Not: Script her servis için ayrı namespace kullanılan karmaşık yapılara yönelik değildir. Standart ve sade Exchange mimarileri için tasarlanmıştır.

<#
.SYNOPSIS
ConfigureExchangeURLs.ps1

.DESCRIPTION 
PowerShell script to configure the Client Access server URLs
for Microsoft Exchange Server 2013/2016. All Client Access server
URLs will be set to the same namespace.

If you are using separate namespaces for each CAS service this script will
not handle that.

The script sets Outlook Anywhere to use NTLM with SSL required by default.
If you have different auth requirements for Outlook Anywhere  use the optional
parameters to set those.

.PARAMETER Server
The name(s) of the server(s) you are configuring.

.PARAMETER InternalURL
The internal namespace you are using.

.PARAMETER ExternalURL
The external namespace you are using.

.PARAMETER InternalSSL
Specifies the internal SSL requirement for Outlook Anywhere. Defaults to True (SSL required).

.PARAMETER ExternalSSL
Specifies the external SSL requirement for Outlook Anywhere. Defaults to True (SSL required).

.EXAMPLE
.\ConfigureExchangeURLs.ps1 -Server sydex1 -InternalURL mail.exchangeserverpro.net -ExternalURL mail.exchangeserverpro.net

.EXAMPLE
.\ConfigureExchangeURLs.ps1 -Server sydex1,sydex2 -InternalURL mail.exchangeserverpro.net -ExternalURL mail.exchangeserverpro.net

.LINK
http://exchangeserverpro.com/powershell-script-configure-exchange-urls/

.NOTES
Written by: Paul Cunningham

Find me on:

* My Blog:	https://paulcunningham.me
* Twitter:	https://twitter.com/paulcunningham
* LinkedIn:	https://au.linkedin.com/in/cunninghamp/
* Github:	https://github.com/cunninghamp

License:

The MIT License (MIT)

Copyright (c) 2015 Paul Cunningham

Permission is hereby granted, free of charge, to any person obtaining a copy
of this software and associated documentation files (the "Software"), to deal
in the Software without restriction, including without limitation the rights
to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
copies of the Software, and to permit persons to whom the Software is
furnished to do so, subject to the following conditions:

The above copyright notice and this permission notice shall be included in all
copies or substantial portions of the Software.

THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
SOFTWARE.

Change Log:
V1.00, 13/11/2014 - Initial version
V1.01, 26/06/2015 - Added MAPI/HTTP URL configuration
V1.02, 27/08/2015 - Improved error handling, can now specify multiple servers to configure at once.
V1.03, 09/09/2015 - ExternalURL can now be $null
V1.04, 17/11/2016 - Removed Outlook Anywhere auth settings, script now sets URLs only
V1.05, 18/11/2016 - Added AutodiscoverSCP option so it can be set to a different URL than other services
#>

#requires -version 2

[CmdletBinding()]
param(
	[Parameter( Position=0,Mandatory=$true)]
	[string[]]$Server,

	[Parameter( Mandatory=$true)]
	[string]$InternalURL,

	[Parameter( Mandatory=$true)]
    [AllowEmptyString()]
	[string]$ExternalURL,

	[Parameter( Mandatory=$false)]
	[string]$AutodiscoverSCP,

    [Parameter( Mandatory=$false)]
    [Boolean]$InternalSSL=$true,

    [Parameter( Mandatory=$false)]
    [Boolean]$ExternalSSL=$true
	)


#...................................
# Script
#...................................

Begin {

    #Add Exchange snapin if not already loaded in the PowerShell session
    if (Test-Path $env:ExchangeInstallPath\bin\RemoteExchange.ps1)
    {
	    . $env:ExchangeInstallPath\bin\RemoteExchange.ps1
	    Connect-ExchangeServer -auto -AllowClobber
    }
    else
    {
        Write-Warning "Exchange Server management tools are not installed on this computer."
        EXIT
    }
}

Process {

    foreach ($i in $server)
    {
        if ((Get-ExchangeServer $i -ErrorAction SilentlyContinue).IsClientAccessServer)
        {
            Write-Host "----------------------------------------"
            Write-Host " Configuring $i"
            Write-Host "----------------------------------------`r`n"
            Write-Host "Values:"
            Write-Host " - Internal URL: $InternalURL"
            Write-Host " - External URL: $ExternalURL"
            Write-Host " - Outlook Anywhere internal SSL required: $InternalSSL"
            Write-Host " - Outlook Anywhere external SSL required: $ExternalSSL"
            Write-Host "`r`n"

            Write-Host "Configuring Outlook Anywhere URLs"
            $OutlookAnywhere = Get-OutlookAnywhere -Server $i
            $OutlookAnywhere | Set-OutlookAnywhere -ExternalHostname $externalurl -InternalHostname $internalurl `
                                -ExternalClientsRequireSsl $ExternalSSL -InternalClientsRequireSsl $InternalSSL `
                                -ExternalClientAuthenticationMethod $OutlookAnywhere.ExternalClientAuthenticationMethod

            if ($externalurl -eq "")
            {
                Write-Host "Configuring Outlook Web App URLs"
                Get-OwaVirtualDirectory -Server $i | Set-OwaVirtualDirectory -ExternalUrl $null -InternalUrl https://$internalurl/owa

                Write-Host "Configuring Exchange Control Panel URLs"
                Get-EcpVirtualDirectory -Server $i | Set-EcpVirtualDirectory -ExternalUrl $null -InternalUrl https://$internalurl/ecp

                Write-Host "Configuring ActiveSync URLs"
                Get-ActiveSyncVirtualDirectory -Server $i | Set-ActiveSyncVirtualDirectory -ExternalUrl $null -InternalUrl https://$internalurl/Microsoft-Server-ActiveSync

                Write-Host "Configuring Exchange Web Services URLs"
                Get-WebServicesVirtualDirectory -Server $i | Set-WebServicesVirtualDirectory -ExternalUrl $null -InternalUrl https://$internalurl/EWS/Exchange.asmx

                Write-Host "Configuring Offline Address Book URLs"
                Get-OabVirtualDirectory -Server $i | Set-OabVirtualDirectory -ExternalUrl $null -InternalUrl https://$internalurl/OAB

                Write-Host "Configuring MAPI/HTTP URLs"
                Get-MapiVirtualDirectory -Server $i | Set-MapiVirtualDirectory -ExternalUrl $null -InternalUrl https://$internalurl/mapi
            }
            else
            {
                Write-Host "Configuring Outlook Web App URLs"
                Get-OwaVirtualDirectory -Server $i | Set-OwaVirtualDirectory -ExternalUrl https://$externalurl/owa -InternalUrl https://$internalurl/owa

                Write-Host "Configuring Exchange Control Panel URLs"
                Get-EcpVirtualDirectory -Server $i | Set-EcpVirtualDirectory -ExternalUrl https://$externalurl/ecp -InternalUrl https://$internalurl/ecp

                Write-Host "Configuring ActiveSync URLs"
                Get-ActiveSyncVirtualDirectory -Server $i | Set-ActiveSyncVirtualDirectory -ExternalUrl https://$externalurl/Microsoft-Server-ActiveSync -InternalUrl https://$internalurl/Microsoft-Server-ActiveSync

                Write-Host "Configuring Exchange Web Services URLs"
                Get-WebServicesVirtualDirectory -Server $i | Set-WebServicesVirtualDirectory -ExternalUrl https://$externalurl/EWS/Exchange.asmx -InternalUrl https://$internalurl/EWS/Exchange.asmx

                Write-Host "Configuring Offline Address Book URLs"
                Get-OabVirtualDirectory -Server $i | Set-OabVirtualDirectory -ExternalUrl https://$externalurl/OAB -InternalUrl https://$internalurl/OAB

                Write-Host "Configuring MAPI/HTTP URLs"
                Get-MapiVirtualDirectory -Server $i | Set-MapiVirtualDirectory -ExternalUrl https://$externalurl/mapi -InternalUrl https://$internalurl/mapi
            }

            Write-Host "Configuring Autodiscover"
            if ($AutodiscoverSCP) {
                Get-ClientAccessServer $i | Set-ClientAccessServer -AutoDiscoverServiceInternalUri https://$AutodiscoverSCP/Autodiscover/Autodiscover.xml
            }
            else {
                Get-ClientAccessServer $i | Set-ClientAccessServer -AutoDiscoverServiceInternalUri https://$internalurl/Autodiscover/Autodiscover.xml
            }


            Write-Host "`r`n"
        }
        else
        {
            Write-Host -ForegroundColor Yellow "$i is not a Client Access server."
        }
    }
}

End {

    Write-Host "Finished processing all servers specified. Consider running Get-CASHealthCheck.ps1 to test your Client Access namespace and SSL configuration."
    Write-Host "Refer to http://exchangeserverpro.com/testing-exchange-server-2013-client-access-server-health-with-powershell/ for more details."

}

#...................................
# Finished
#...................................

GetExchangeURLs.ps1 içeriği;

<#
.SYNOPSIS
GetExchangeURLs.ps1

.DESCRIPTION 
PowerShell script to display the Client Access server URLs
for Microsoft Exchange Server 2013/2016.

.PARAMETER Server
The name(s) of the server(s) you want to view the URLs for.

.EXAMPLE
.\Get-ExchangeURLs.ps1 -Server sydex1

.LINK
http://exchangeserverpro.com/powershell-script-configure-exchange-urls/

.NOTES
Written by: Paul Cunningham

Find me on:

* My Blog:	https://paulcunningham.me
* Twitter:	https://twitter.com/paulcunningham
* LinkedIn:	https://au.linkedin.com/in/cunninghamp/
* Github:	https://github.com/cunninghamp

Change Log:
V1.00, 27/08/2015 - Initial version
#>

#requires -version 2


[CmdletBinding()]
param(
	[Parameter( Position=0,Mandatory=$true)]
	[string[]]$Server
	)


#...................................
# Script
#...................................

Begin {

    #Add Exchange snapin if not already loaded in the PowerShell session
    if (Test-Path $env:ExchangeInstallPath\bin\RemoteExchange.ps1)
    {
	    . $env:ExchangeInstallPath\bin\RemoteExchange.ps1
	    Connect-ExchangeServer -auto -AllowClobber
    }
    else
    {
        Write-Warning "Exchange Server management tools are not installed on this computer."
        EXIT
    }
}

Process {

    foreach ($i in $server)
    {
        if ((Get-ExchangeServer $i -ErrorAction SilentlyContinue).IsClientAccessServer)
        {
            Write-Host "----------------------------------------"
            Write-Host " Querying $i"
            Write-Host "----------------------------------------`r`n"
            Write-Host "`r`n"

            $OA = Get-OutlookAnywhere -Server $i -AdPropertiesOnly | Select InternalHostName,ExternalHostName
            Write-Host "Outlook Anywhere"
            Write-Host " - Internal: $($OA.InternalHostName)"
            Write-Host " - External: $($OA.ExternalHostName)"
            Write-Host "`r`n"

            $OWA = Get-OWAVirtualDirectory -Server $i -AdPropertiesOnly | Select InternalURL,ExternalURL
            Write-Host "Outlook Web App"
            Write-Host " - Internal: $($OWA.InternalURL)"
            Write-Host " - External: $($OWA.ExternalURL)"
            Write-Host "`r`n"

            $ECP = Get-ECPVirtualDirectory -Server $i -AdPropertiesOnly | Select InternalURL,ExternalURL
            Write-Host "Exchange Control Panel"
            Write-Host " - Internal: $($ECP.InternalURL)"
            Write-Host " - External: $($ECP.ExternalURL)"
            Write-Host "`r`n"

            $OAB = Get-OABVirtualDirectory -Server $i -AdPropertiesOnly | Select InternalURL,ExternalURL
            Write-Host "Offline Address Book"
            Write-Host " - Internal: $($OAB.InternalURL)"
            Write-Host " - External: $($OAB.ExternalURL)"
            Write-Host "`r`n"

            $EWS = Get-WebServicesVirtualDirectory -Server $i -AdPropertiesOnly | Select InternalURL,ExternalURL
            Write-Host "Exchange Web Services"
            Write-Host " - Internal: $($EWS.InternalURL)"
            Write-Host " - External: $($EWS.ExternalURL)"
            Write-Host "`r`n"

            $MAPI = Get-MAPIVirtualDirectory -Server $i -AdPropertiesOnly | Select InternalURL,ExternalURL
            Write-Host "MAPI"
            Write-Host " - Internal: $($MAPI.InternalURL)"
            Write-Host " - External: $($MAPI.ExternalURL)"
            Write-Host "`r`n"

            $EAS = Get-ActiveSyncVirtualDirectory -Server $i -AdPropertiesOnly | Select InternalURL,ExternalURL
            Write-Host "ActiveSync"
            Write-Host " - Internal: $($EAS.InternalURL)"
            Write-Host " - External: $($EAS.ExternalURL)"
            Write-Host "`r`n"

            $AutoD = Get-ClientAccessServer $i | Select AutoDiscoverServiceInternalUri
            Write-Host "Autodiscover"
            Write-Host " - Internal SCP: $($AutoD.AutoDiscoverServiceInternalUri)"
            Write-Host "`r`n"

        }
        else
        {
            Write-Host -ForegroundColor Yellow "$i is not a Client Access server."
        }
    }
}

End {

    Write-Host "Finished querying all servers specified."

}

#...................................
# Finished
#...................................

Zorunlu Parametreler

Script’in çalışabilmesi için aşağıdaki parametrelerin girilmesi zorunludur:

-Server

Yapılandırma yapılacak Exchange Server(lar)ın adını belirtir.

-InternalURL

İç ağ kullanıcılarının Exchange servislerine erişeceği URL bilgisidir.

-ExternalURL

İnternet üzerinden erişim için kullanılacak URL bilgisidir.

Opsiyonel Parametreler

İhtiyaca bağlı olarak aşağıdaki parametreler de kullanılabilir:

-AutodiscoverSCP
Autodiscover için farklı bir namespace tanımlamak amacıyla kullanılır.
-InternalSSL
Outlook Anywhere için iç ağda SSL zorunluluğunu belirler (Varsayılan: True).
-ExternalSSL
Outlook Anywhere için dış ağda SSL zorunluluğunu belirler (Varsayılan: True).

Kullanım Örnekleri

Tek Sunucu İçin Örnek Kullanım

.\ConfigureExchangeURLs.ps1 `
-Server EXCH01 `
-InternalURL mail.exchangeserverpro.net `
-ExternalURL mail.exchangeserverpro.net

Birden Fazla Sunucu İçin Örnek Kullanım

.\ConfigureExchangeURLs.ps1 `
-Server EXCH01,EXCH02 `
-InternalURL mail.exchangeserverpro.net `
-ExternalURL mail.exchangeserverpro.net

Autodiscover İçin Ayrı Namespace Kullanımı

.\ConfigureExchangeURLs.ps1 `
-Server EXCH01,EXCH02 `
-InternalURL mail.exchangeserverpro.net `
-ExternalURL mail.exchangeserverpro.net `
-AutodiscoverSCP autodiscover.exchangeserverpro.net

Script Kullanmanın Avantajları

✔ Manuel yapılandırma hatalarını azaltır
✔ Tüm Client Access servislerinde tutarlılık sağlar
✔ Birden fazla Exchange Server’ın hızlıca yapılandırılmasını sağlar
✔ Kurulum sonrası işlemleri önemli ölçüde hızlandırır

Kaynak ve Atıf (Source & Attribution)

Bu makalede kullanılan PowerShell script’i, Paul Cunningham tarafından geliştirilmiştir. Script’in orijinal içeriği ve güncel sürümleri aşağıdaki kaynaklarda yayımlanmıştır:

Paul Cunningham – PowerShell Script to Configure Exchange Server Client Access URLs
TechNet Gallery – ConfigureExchangeURLs.ps1
GitHub – Paul Cunningham Repository

Telif ve kullanım notu: Bu makale script’in orijinal sahibine atıf yapılarak hazırlanmış olup script içeriği üzerinde herhangi bir sahiplik iddiası bulunmamaktadır. Script’in tüm hakları ilgili yazara aittir.

PowerShell ile Exchange Server Client Access URL’lerini Kolayca Yapılandırılması (Paul Cunningham)

Kullanılan Script Hakkında

ConfigureExchangeURLs.ps1 Nedir?

Zorunlu Parametreler

-Server

-InternalURL

-ExternalURL

Opsiyonel Parametreler

Kullanım Örnekleri

Tek Sunucu İçin Örnek Kullanım

Birden Fazla Sunucu İçin Örnek Kullanım

Autodiscover İçin Ayrı Namespace Kullanımı

Script Kullanmanın Avantajları

Kaynak ve Atıf (Source & Attribution)

Benzer Yazılar

Microsoft Exchange’de 6 MB’dan Büyük Ekli Mailleri Tespit Etme ve Raporlama

Exchange Server Event id 1053 “ActiveSync doesn’t have sufficient permissions to create container under Active Directory user” Hatasının Giderilmesi

Exchange Server SE Lisanslama ve Satın Alma Süreci

Exchange Server 2016 ve 2019 Ürün Desteğinin Sonu

Exchange Server 2019’da Event ID 1013 hatasının giderilmesi

Exchange Server’da Mail Header’da Sunucu Adı ve IP Adres Bilgisinin Kaldırılması