如何通过PowerShell为ADFS应用组设置自定义Web主题？

我们在ADFS 2016中管理WS-FED/SAML应用时，可通过Set-AdfsRelyingPartyWebTheme为指定信赖方设置自定义Web主题，但对于通过**应用组（Application Groups）**创建的OAuth应用（NativeClientApplication + WebApiApplication），ADFS 2016原生没有对应PowerShell命令，且Set-AdfsNativeClientApplication、Set-AdfsApplicationGroup均不支持主题设置参数，可通过以下方案解决：

方案1：使用全局Web主题（适合所有OAuth应用共用同一主题） #

如果所有OAuth应用可以使用同一个自定义主题，直接将全局主题设置为目标自定义主题即可。已单独设置主题的WS-FED/SAML信赖方会优先使用自身配置，不受全局主题影响。

执行PowerShell命令：

# 将已创建的自定义主题设为全局激活主题
Set-AdfsWebConfig -ActiveThemeName "MyCustomLoginTheme"

方案2：自定义登录页面逻辑，按客户端ID切换主题 #

若需为不同OAuth应用配置不同主题，可通过修改ADFS登录页面的ASP.NET代码，根据请求中的client_id参数动态加载对应主题资源：

1. 导出默认Web主题资源到本地目录：

Export-AdfsWebTheme -Name default -DirectoryPath "C:\ADFS_Custom_Login"

2. 打开导出目录下的login.aspx，在Page_Load事件中添加主题切换逻辑（示例）：

protected void Page_Load(object sender, EventArgs e)
{
    string clientId = Request.QueryString["client_id"];
    string targetTheme = "default";

    // 根据OAuth应用的Client ID映射对应主题
    switch(clientId)
    {
        case "你的原生客户端应用ID":
            targetTheme = "MyCustomLoginTheme";
            break;
        case "另一个客户端应用ID":
            targetTheme = "AnotherCustomTheme";
            break;
    }

    // 加载目标主题的资源
    var theme = AdfsWebTheme.GetTheme(targetTheme);
    if(theme != null)
    {
        // 添加主题样式表
        foreach(var sheet in theme.StyleSheets)
        {
            Page.Header.Controls.Add(new LiteralControl($"<link rel='stylesheet' href='{sheet.Source}' />"));
        }
        // 按需添加主题脚本、图片等资源
        foreach(var script in theme.Scripts)
        {
            Page.Header.Controls.Add(new LiteralControl($"<script src='{script.Source}'></script>"));
        }
    }
}

3. 将修改后的资源导入为新的自定义主题并激活：

# 创建基于默认主题的自定义主题
New-AdfsWebTheme -Name "DynamicOAuthTheme" -SourceName default
# 导入修改后的样式和脚本
Set-AdfsWebTheme -TargetName "DynamicOAuthTheme" -StyleSheet @{Path="C:\ADFS_Custom_Login\css\style.css"} -Script @{Path="C:\ADFS_Custom_Login\script\script.js"}
# 设置全局使用该动态主题
Set-AdfsWebConfig -ActiveThemeName "DynamicOAuthTheme"

注意：修改ADFS登录页面前需备份原始资源，且需全面测试所有登录流程，避免影响现有应用。

方案3：升级至ADFS 2019或更高版本 #

ADFS 2019及后续版本已支持为应用组设置自定义Web主题，提供了对应PowerShell命令，若有服务器升级计划，这是最原生的解决方案。

内容的提问来源于stack exchange，提问作者DominikAmon