使用 gMSAs 針對 SQL Server 安裝與升級失敗進行疑難排解

適用於:Windows 上的 SQL Server

Summary

本文可協助你疑難排解 SQL Server 安裝程式在拒絕或無法驗證供 SQL Server 或 SQL Server Agent 服務使用的群組受管理服務帳戶 (gMSA) 時所發生的 SQL Server 安裝及升級失敗問題。 說明如何檢查被授權取得受管理密碼的主體、測試密碼擷取,以及解決 Active Directory 複製、DNS、安全通道及時間同步問題。

開始前,請先檢視前置條件,並執行 Troubleshoot SQL Server 設置、啟動及 gMSA 驗證失敗的快速驗證清單。

Symptoms

  • 設定報告服務帳號無效或帳號驗證失敗。
  • gMSA 存在,但安裝程式無法設定 SQL Server 或 SQL Server Agent。
  • 故障發生在安裝、維修、新增功能、新增節點或升級期間。

原因

設定必須解析帳號並驗證主機是否能取得並使用其管理密碼。 常見原因包括 Active Directory 複製不完整、授權主體錯誤,或網域連線失敗。

與服務帳號無關的設定失敗則有另外的指引。 在繼續之前,請從設定日誌確認第一次失敗是服務帳號驗證失敗。 關於一般的設定失敗分流,請參見 SQL Server 安裝錯誤,關於日誌位置與結構,請參見「檢視與讀取 SQL Server 設定日誌檔案」。

診斷 gMSA 設定與升級失敗

  1. 在受影響的主機上執行 快速驗證檢查清單 指令。
  2. 確認主機帳號或授權群組是否列在 PrincipalsAllowedToRetrieveManagedPassword。
  3. 搜尋 Summary.txt 並 Detail.txt 尋找第一個服務帳號驗證失敗。

預期結果:Get-ADServiceAccount 會傳回預期的帳戶和已授權的主體,並且 Test-ADServiceAccount 會傳回 True。

解決 gMSA 設定與升級失敗

使用符合你所識別狀況的解決方案。 僅在受影響的主機傳回 TrueTest-ADServiceAccount 後,才重新嘗試設定。

更正被授權取得 gMSA 密碼的主體

  1. 從安裝了 Active Directory PowerShell 模組的管理電腦,檢視目前的設定。

    Get-ADServiceAccount -Identity 'SQLgMSA' `
      -Properties PrincipalsAllowedToRetrieveManagedPassword |
      Select-Object Name, PrincipalsAllowedToRetrieveManagedPassword
    
  2. 確認受影響的 SQL Server 電腦帳號,或包含該帳號的安全群組是否被列出。 如果受影響的 SQL Server 主機或核准的安全群組未被列出PrincipalsAllowedToRetrieveManagedPassword,請透過組織核准的 Active Directory 程序更新 gMSA 設定:

    • 如果您的組織透過 Active Directory 安全群組管理授權主機,請讓 Active Directory 管理員將受影響的電腦帳號加入該核准的群組。 例如:

      Add-ADGroupMember -Identity 'SQL-gMSA-Hosts' `
        -Members 'SQL01$'
      
    • 如果您的組織直接在 gMSA 授權主體,請請 Active Directory 管理員更新 gMSA 並附上完整的核准主體清單。 例如:

      Set-ADServiceAccount -Identity 'SQLgMSA' `
        -PrincipalsAllowedToRetrieveManagedPassword `
        'CONTOSO\SQL-gMSA-Hosts'
      

      注意事項

      該 PrincipalsAllowedToRetrieveManagedPassword 數值為完整的授權主體清單。 在使用 Set-ADServiceAccount 之前,請檢查現有值,並納入所有必須保留授權的主體。 不要無意間移除其他 SQL Server 主機或叢集節點。

  3. 如果您更改了安全群組成員資格,請依照組織的變更流程重新整理受影響電腦的群組成員資格。

  4. 在每台能執行 SQL Server 的主機上,請驗證結果。

    Get-ADServiceAccount -Identity 'SQLgMSA' `
      -Properties PrincipalsAllowedToRetrieveManagedPassword
    
    Test-ADServiceAccount -Identity 'SQLgMSA'
    

    預期結果: 預期的電腦帳戶或核准群組出現在 PrincipalsAllowedToRetrieveManagedPassword,並 Test-ADServiceAccount 返回 True。

欲了解更多資訊,請參閱以下文章:

解決目錄複製、DNS、安全通道或網域控制器連線失敗

  1. 在受影響的 SQL Server 主機上,從提升的 PowerShell 會話中執行以下檢查。 請將 contoso.com 替換為 Active Directory 網域名稱。

    Resolve-DnsName -Name '_ldap._tcp.dc._msdcs.contoso.com' `
      -Type SRV
    
    nltest /dsgetdc:contoso.com
    nltest /sc_verify:contoso.com
    w32tm /query /status
    
  2. 更正檢查判定出的條件:

    • 若 DNS 解析或網域控制器發現失敗,請修正主機的 DNS 用戶端設定,並確認其使用 DNS 伺服器能解析 Active Directory 網域。

    • 若nltest /sc_verify報告安全通道故障,請請 Windows 或 Active Directory 管理員透過組織核准的程序修復該電腦的網域安全通道。

    • 如果時間狀態異常,請在重測前正確同步時間,因為 Active Directory 的認證依賴於準確時間。

    • 如果 SQL Server 主機所連線的網域控制器上未顯示授權主體的變更,請讓 Active Directory 管理員檢查複寫。 例如:

      repadmin /replsummary
      repadmin /showrepl *
      

      Active Directory 複製依賴網路連線、DNS 名稱解析、認證與授權、時間準確度、目錄資料庫以及複製拓撲。 使用repadmin /showrepl並repadmin /replsummary識別 Active Directory 複製失敗。

  3. 在修正根本原因後,重新執行 Test-ADServiceAccount。

    Test-ADServiceAccount -Identity 'SQLgMSA'
    

    預期結果: 發現網域控制器,安全通道驗證成功,時間同步正常,gMSA 設定從被聯絡網域控制器可見,並 Test-ADServiceAccount 回傳 True。

收集診斷資料

如果完成這些步驟後,設定仍無法驗證 gMSA,請從受影響主機收集相同故障間隔的診斷資料。 關於 gMSA 專屬證據及標準 SQL Server 日誌,請參閱 gMSA 故障排除概述中的「收集診斷資料」。 利用這些資料繼續調查或開啟支援案件。