Updating the the logo shown by ADFS (Active Directory Federated Services) this needs to be updated on the Federation servers (not the WAP servers) so first we need to check the current theme which does not "blow you away" with the details:
Get-AdfsWebTheme -Name default
This will then return the current theme with little options to look at as you can see below:
The current ADFS login looks like this:
We now need to update the logo with the new version which will be the "Logo" attribute which we can do with this command:
Set-AdfsWebTheme -TargetName default -Logo @{Path="C:\temp\logo.jpg"}
When that command is executed you will immediately see the new logo on the ADFS login page:
What are the supported logo requirements?
- The logo file should ideally be less than 500 KB
- Recommended dimensions are 260x35 pixels
- Supported formats include JPG, PNG, and GIF
- Make sure the path to your logo file is correct
What about the WAP servers, how do they get the logo?
The WAP (Web Application Proxy) servers are the devices that serve the website so do you not update the logo on those servers?
No, theme or appearance changes (including logos), those must be made on the ADFS servers first. The WAP servers will then receive these changes through their established connection with ADFS.
- Make the logo change on your internal ADFS federation servers using the Set-AdfsWebTheme command
- The WAP servers will automatically receive these changes through their existing connection with ADFS
GUI Options ?
Not that you should be looking for a GUI all the time, but I have thought about a GUI option for this and for this all you will need is the ADFS server name to test the connection then a logo options box that appliers best practices to your logo as below:
To upload the logo to the Federation server click the Upload button and the magic will be complete, if you have more than one ADFS servers you only need to specify one as the new configuration will be replicated to the other servers automatically.
If you would like that Powershell code contact me using the contact form.
To upload the logo to the Federation server click the Upload button and the magic will be complete, if you have more than one ADFS servers you only need to specify one as the new configuration will be replicated to the other servers automatically.
If you would like that Powershell code contact me using the contact form.