Upgrade Web Application Proxy (WAP) for ADFS to 2016/2019

upgrade-web -application-proxy-for-adfs-2016-01

During the migration to ADFS 2016/2019, also the Web Application Proxy (WAP) must be upgraded accordingly in order to align all components to same version.

In an Office 365 environment, the WAP component is used to perform SSO outside the LAN.

upgrade-web -application-proxy-for-adfs-2016-02

Although the following procedure uses Windows Server 2016, the WAP upgrade procedure is the same also for Windows Server 2019.


Install WAP to the new server

First step of the procedure is the installation of the Web Application Proxy (WAP) service to the new Windows Server 2016. From Server Manager click Manage in the top-right side of the screen and select Add Roles and Features.

upgrade-web -application-proxy-for-adfs-2016-03

Click Next to start the wizard.

upgrade-web -application-proxy-for-adfs-2016-04

Select Roles-based or feature-based installation then click Next.

upgrade-web -application-proxy-for-adfs-2016-05

Select the server to install and click Next.

upgrade-web -application-proxy-for-adfs-2016-06

Select Remote Access role and click Next.

upgrade-web -application-proxy-for-adfs-2016-07

No additional features are required here. Click Next.

upgrade-web -application-proxy-for-adfs-2016-08

Click Next.

upgrade-web -application-proxy-for-adfs-2016-09

Select Web Application Proxy role and click Add Features to include required features.

upgrade-web -application-proxy-for-adfs-2016-10

Make sure Web Application Proxy is selected then click Next.

upgrade-web -application-proxy-for-adfs-2016-11

Select Restart the destination server automatically if required and click Yes to confirm.

upgrade-web -application-proxy-for-adfs-2016-12

Click Install to proceed with WAP installation.

upgrade-web -application-proxy-for-adfs-2016-13

The selected role is being installed.

upgrade-web -application-proxy-for-adfs-2016-14

When the installation completes, click Close to exit the wizard.

upgrade-web -application-proxy-for-adfs-2016-15

Click the exclamation mark in the menu and click on the Open the Web Application Proxy Wizard link.

upgrade-web -application-proxy-for-adfs-2016-16

Click Next to continue.

upgrade-web -application-proxy-for-adfs-2016-17

Specify the Federation service name to use and the credentials of the local admin account on the federation servers.

upgrade-web -application-proxy-for-adfs-2016-18

Select from the drop-down menu the SSL certificate to be used by the ADFS Proxy.

upgrade-web -application-proxy-for-adfs-2016-19

Once the correct SSL certificate has been selected, click Next.

upgrade-web -application-proxy-for-adfs-2016-20

Click Configure to proceed with WAP configuration.

upgrade-web -application-proxy-for-adfs-2016-21

The AD FS proxy is being configured.

upgrade-web -application-proxy-for-adfs-2016-22

When the WAP role has been configured successfully, click Close to exit the wizard.

upgrade-web -application-proxy-for-adfs-2016-23


Check servers connection

From the new Windows Server 2016, run the following cmdlet to check current connected servers that are part of the cluster. You should see the old (2012R2) and the new (2016) WAP servers connected. Note the ConfigurationVersion is reported as Windows Server 2012 R2.

PS: C:\> Get-WebApplicationProxyConfiguration

upgrade-web -application-proxy-for-adfs-2016-24

Run the same command also from the old WAP Server:

PS: C:\> Get-WebApplicationProxyConfiguration

upgrade-web -application-proxy-for-adfs-2016-25


Remove old server

To remove the old server from the cluster, run the following cmdlet from the old (2012R2) server:

PS: C:\> Set-WebApplicationProxyConfiguration -ConnectedServersName <new-server>

upgrade-web -application-proxy-for-adfs-2016-26

Check once again current connected servers that are part of the cluster. This time the ConnectServersName reports only the new configured Windows Server 2016.

PS: C:\> Get-WebApplicationProxyConfiguration

upgrade-web -application-proxy-for-adfs-2016-27

Perform same check also in the new Windows Server 2016 to get additional details.

PS: C:\> Get-WebApplicationProxyConfiguration

upgrade-web -application-proxy-for-adfs-2016-28


Decommission old server

If you don't need to keep the old server, you can safely remove it. From Server Manager select Manage > Remove Roles and Features.

upgrade-web -application-proxy-for-adfs-2016-29

Go through the wizard and remove the Remote Access role.

upgrade-web -application-proxy-for-adfs-2016-30

Click Remove to confirm role removal.

upgrade-web -application-proxy-for-adfs-2016-31


Upgrade the ConfigurationVersion

Because the current version is still configured as Windows Server 2012 R2, we need to upgrade to 2016 to complete the upgrade procedure. From the Windows Server 2016 run the following cmdlet:

PS: C:\> Set-WebApplicationProxyConfiguration -UpgradeConfigurationVersion

upgrade-web -application-proxy-for-adfs-2016-32

Check the configured version with the following cmdlet:

PS: C:\> Get-WebApplicationProxyConfiguration

upgrade-web -application-proxy-for-adfs-2016-33

The current ConfigurationVersion is now reported as Windows Server 2016.

The upgrade procedure of the WAP Server has been completed successfully. If you don't have any, you can now publish your Web Applications.



  1. Mehdi 26/05/2021
    • Paolo Valsecchi 27/05/2021
      • Samit 23/12/2021
  2. bhargava 10/02/2022