Note: 仅开始升级,并计划完成。 不建议在长时间内保持 AD FS 处于混合模式状态,因为在混合模式状态下 AD FS 会导致场出现问题。
将 Windows Server 2012 R2 或 2016 AD FS 场升级到 Windows Server 2019
以下文档将介绍如何在使用 WID 数据库时将 AD FS 场升级到 Windows Server 2019 中的 AD FS。
AD FS 场行为级别 (FBL)
在 Windows Server 2016 AD FS 中,引入了场行为级别 (FBL) 。 此设置决定了 AD FS 场可使用的功能。
下表按 Windows Server 版本列出了 FBL 值:
| Windows Server 版本 | FBL | AD FS 配置数据库名称 |
|---|---|---|
| 2012 R2 | 1 | AdfsConfiguration |
| 2016 | 3 | AdfsConfigurationV3 |
| 2019 | 4 | AdfsConfigurationV4 |
Note: 升级 FBL 会创建新的 AD FS 配置数据库。 请参阅上表,了解每个 Windows Server AD FS 版本和 FBL 值的配置数据库的名称
新的 vs 升级场
默认情况下,新 AD FS 场中的 FBL 与安装的第一个场节点的 Windows Server 版本的值相匹配。
更高版本的 AD FS 服务器可以联接到 AD FS 2012 R2 或2016场,场将与现有节点 () 在同一 FBL 上运行。 如果在同一场中运行的多个 Windows Server 版本在最低版本的 FBL 值中运行,则您的场称为 "mixed"。 但是,在引发 FBL 之前,你将无法利用更高版本的功能。 使用混合场:
-
管理员可以将新的 Windows Server 2019 联合服务器添加到现有 Windows Server 2012 R2 或2016场。 因此,场处于 "混合模式",并以与原始场相同的场行为级别进行操作。 为确保服务器场的行为一致,不能配置或使用较新的 Windows Server AD FS 版本的功能。
-
在可以引发 FBL 之前,管理员必须从场中删除以前的 Windows Server 版本的 AD FS 节点。 对于 WID 场,请注意,这需要将一个新的 Windows Server 2019 联合服务器提升为场中主节点的角色。
-
在场中的所有联合服务器都处于同一 Windows Server 版本后,可以引发 FBL。 因此,可以配置并使用任何新 AD FS Windows Server 2019 功能。
请注意,在混合场模式下,AD FS 场无法在 Windows Server 2019 AD FS 中引入的任何新功能或功能。 这意味着要尝试新功能的组织在引发 FBL 之前无法执行此操作。 因此,如果你的组织希望在引发 FBL 之前测试新功能,则需要部署单独的场来实现此目的。
的其余部分提供了有关将 Windows Server 2019 联合服务器添加到 Windows Server 2016 或 2012 R2 环境,然后将 FBL 提升为 Windows Server 2019 的步骤。 在下面的体系结构关系图中所述的测试环境中执行这些步骤。
Note: 必须先删除所有 Windows Server 2016 或 2012 R2 节点,然后才能移到 Windows Server 2019 FBL 中的 AD FS。 你不能只是将 Windows Server 2016 或 2012 R2 OS 升级到 Windows Server 2019,并使其成为一个2019节点。 需要将其删除,并将其替换为新的2019节点。
Note: 如果在 AD FS 中配置了 AlwaysOnAvailability 组或合并复制,请在升级前删除所有 ADFS 数据库的所有复制,并将所有节点指向主 SQL 数据库。 执行此工作后,按所述执行场升级。 升级后,将 AlwaysOnAvailability 组或合并复制添加到新的数据库。
将 AD FS 场升级到 Windows Server 2019 场行为级别
-
使用服务器管理器在 Windows Server 2019 上安装 Active Directory 联合身份验证服务角色
-
使用 AD FS 配置向导将新的 Windows Server 2019 服务器加入现有 AD FS 场。
屏幕截图显示了如何将新的 Windows Server 2019 服务器加入现有 AD FS 场。
- 在 Windows Server 2019 联合服务器上,打开 AD FS 管理。 请注意,由于此联合服务器不是主服务器,因此管理功能不可用。
显示 A D F S 窗口的屏幕截图。
- 在 Windows Server 2019 服务器上,打开提升的 PowerShell 命令窗口并运行以下 cmdlet:
Set-AdfsSyncProperties -Role PrimaryComputer
终端窗口的屏幕截图,显示如何使用 Set-AdfsSyncProperties Role PrimaryComputer cmdlet。
- 在以前配置为主服务器的 AD FS 服务器上,打开提升的 PowerShell 命令窗口并运行以下 cmdlet:
Set-AdfsSyncProperties -Role SecondaryComputer -PrimaryComputerName {FQDN}
终端窗口的屏幕截图,显示如何使用 Set-AdfsSyncProperties-Role SecondaryComputer-PrimaryComputerName {FQDN} cmdlet。
- 现在,在 Windows Server 2016 联合服务器上打开 AD FS 管理。 请注意,现在将显示所有管理员功能,因为主角色已传输到此服务器。
屏幕截图显示 Windows Server 2016 联合服务器打开 AD FS 管理 "窗口。
- 如果要将 AD FS 2012 R2 场升级到2016或2019,场升级要求 AD 架构至少为级别85。 若要使用 Windows Server 2016 安装介质升级架构,请打开命令提示符并导航到 support\adprep directory。 运行以下内容:
adprep /forestprep
显示如何导航到 support\adprep 目录的屏幕截图。
完成运行后 adprep /domainprep
Note: 在运行下一步骤之前,请通过从 "设置" 运行 Windows 更新确保 Windows Server 处于最新状态。 继续这一过程,直到不需要进一步更新。
显示如何运行 adprep/domainprep。的屏幕截图
- 现在,在 Windows Server 2016 服务器上打开 PowerShell 并运行以下 cmdlet:
Note: 在运行下一步骤之前,必须将所有 2012 R2 服务器从场中删除。
Invoke-AdfsFarmBehaviorLevelRaise
显示如何运行 Invoke-AdfsFarmBehaviorLevelRaise cmdlet 的终端窗口的屏幕截图。
- 出现提示时,键入 Y。这将开始提升级别。 完成此过程后,您已成功地引发了 FBL。
终端窗口的屏幕截图,显示何时键入 Y。
- 现在,如果你开始 AD FS 管理,你将看到为之后 AD FS 版本添加了新功能
显示已添加的新功能的屏幕截图。
- 同样,可以使用 PowerShell cmdlet:
Get-AdfsFarmInformation显示当前的 FBL。
升级
- 若要将 WAP 服务器升级到最新级别,请在每个 Web 应用程序代理上,通过在提升的窗口中执行以下 PowerShell cmdlet 来重新配置 WAP:
$trustcred = Get-Credential -Message "Enter Domain Administrator credentials"
Install-WebApplicationProxy -CertificateThumbprint {SSLCert} -fsname fsname -FederationServiceTrustCredential $trustcred
通过运行以下 Powershell cmdlet,从群集中删除旧服务器,并仅保留运行最新服务器版本的 WAP 服务器。
Set-WebApplicationProxyConfiguration -ConnectedServersName WAPServerName1, WAPServerName2
通过运行 Get-WebApplicationProxyConfiguration cmdlet 检查 WAP 配置。 ConnectedServersName 将反映从上一个命令运行的服务器。
Get-WebApplicationProxyConfiguration
Note: 如果 ConfigurationVersion 是 Windows Server 2016,请跳过下一步。 对于 Windows Server 2016/2019 上的 Web 应用程序代理,这是正确的值。
若要升级 WAP 服务器的 ConfigurationVersion,请运行以下 Powershell 命令。
Set-WebApplicationProxyConfiguration -UpgradeConfigurationVersion
这将完成 WAP 服务器的升级。
Note: 如果执行了具有混合证书信任的 Windows Hello 企业版,则 AD FS 2019 中存在已知的 PRT 问题。 可能会在 ADFS 管理事件日志中遇到此错误:收到的 Oauth 请求无效。 禁止客户端 'NAME' 访问作用域为 'ugs' 的资源。 若要修正此错误,请执行以下操作:
- 启动 AD FS 管理控制台。 浏览到“服务”>“作用域说明”
- 右键单击“作用域说明”,选择“添加作用域说明”
- 在名称下键入“ugs”,然后单击“应用”>“确定”
- 以管理员身份启动 PowerShell
- 执行“Get-AdfsApplicationPermission”命令。 查找 ScopeNames :{openid, aza},其中包含 ClientRoleIdentifier。 记下 ObjectIdentifier。
- 执行“Set-AdfsApplicationPermission -TargetIdentifier <步骤 5 中的 ObjectIdentifier> -AddScope 'ugs'”命令
- 重启 ADFS 服务。
- 在客户端上执行以下操作:重启客户端。 系统会提示用户预配 WHFB。
- 如果未弹出预配窗口,则需收集 NGC 跟踪日志并进行进一步的故障排除。
历史资料。此文对应 2021-03-23 的中文文档快照,适用产品版本和命令行为以原文为准。
来源与署名:Microsoft 和文档贡献者(原始作者元数据 billmath)。固定版本原文。文档采用 CC BY 4.0,示例代码采用 MIT 授权。本站将 Markdown 转为 HTML,规范化链接,移除外部媒体和导航标记。
