安裝 Microsoft Entra Connect Health 代理程式

在本文中，您會了解如何安裝及設定 Microsoft Entra Connect Health 代理程式。

了解如何下載代理程式。

需求

下表列出使用 Microsoft Entra Connect Health 的需求：

新版本的代理程式和自動升級

如果發行新版本的健康情況代理程式，任何現有的已安裝代理程式都會自動更新。

Azure 服務端點的輸出連線

在安裝期間和執行階段，代理程式必須連線至 Microsoft Entra Connect Health 服務端點。 如果防火牆封鎖輸出連線能力，請確定下表中的網址不會預設遭到封鎖。

請勿停用這些網址的安全性監視或檢查。 而是允許這些網址，因為您要允許其他網際網路流量。

這些網址允許與 Microsoft Entra Connect Health 服務端點進行通訊。 在本文稍後的部分中，您會了解如何藉由使用 Test-MicrosoftEntraConnectHealthConnectivity 來檢查輸出連線能力。

下載代理程式

若要下載並安裝 Microsoft Entra Connect Health 代理程式：

• 確定您符合安裝 Microsoft Entra Connect Health 的需求。
• 開始使用適用於 AD FS 的 Microsoft Entra Connect Health：
  • 下載適用於 AD FS 的 Microsoft Entra Connect Health 代理程式。
  • 請參閱安裝指示。
• 開始使用 Microsoft Entra Connect Health 進行同步處理：
  • 下載並安裝最新版本的 Microsoft Entra Connect (英文)。 適用於同步處理的健康情況代理程式會在 Microsoft Entra Connect 安裝 (1.0.9125.0 版或更新版本) 過程中一起安裝。
• 開始使用適用於 AD Domain Services 的 Microsoft Entra Connect Health：
  • 下載適用於 AD Domain Services 的 Microsoft Entra Connect Health 代理程式。
  • 請參閱安裝指示。

安裝 AD FS 的代理程式

若要了解使用 Microsoft Entra Connect Health 代理程式安裝及監視 AD FS 的相關資訊，請參閱＜適用於 AD FS 的 Microsoft Entra Connect Health 代理程式＞。

安裝代理程式進行同步處理

最新版本的 Microsoft Entra Connect 會自動安裝用於同步處理的 Microsoft Entra Connect Health 代理程式。 若要使用 Microsoft Entra Connect 進行同步處理，請下載最新版的 Microsoft Entra Connect (英文) 並加以安裝。

若要確認代理程式已安裝，請在伺服器上尋找下列服務。 如果您已完成設定，這些服務應該已在執行中。 否則，服務會停止，直到設定完成為止。

• Microsoft Entra Connect 代理程式更新程式
• Microsoft Entra Connect Health 代理程式

手動註冊適用於同步處理的 Microsoft Entra Connect Health

如果在您成功安裝 Microsoft Entra Connect 後，適用於同步處理的 Microsoft Entra Connect Health 代理程式註冊失敗，您可以使用 PowerShell 命令來手動註冊該代理程式。

使用下列 PowerShell 命令，手動註冊適用於同步處理的 Microsoft Entra Connect Health 代理程式。 Microsoft Entra Connect Health 服務會在代理程式註冊成功後啟動。

Register-MicrosoftEntraConnectHealthAgent -AttributeFiltering $true -StagingMode $false

此命令採用下列參數：

• AttributeFiltering：$true (預設) 如果 Microsoft Entra Connect 並未同步處理預設屬性集，且已自訂為使用已篩選的屬性集。 否則，請使用 $false。
• StagingMode：$false (預設) 如果 Microsoft Entra Connect 伺服器不是處於檢閱及測試模式。 如果伺服器設定為檢閱及測試模式，請使用 $true。

當系統提示您進行驗證時，請使用您用來設定 Microsoft Entra Connect 的相同全域系統管理員帳戶 (例如 admin@domain.onmicrosoft.com)。

安裝 AD Domain Services 的代理程式

若要啟動代理程式安裝，請按兩下您所下載的 .exe 檔案。 在第一個視窗中，選取 [安裝]。

出現提示時，使用具有代理程式註冊權限的 Microsoft Entra 帳戶來登入。 根據預設，混合式身分識別系統管理員帳戶具有權限。

登入之後，安裝流程隨即完成，而您可以關閉視窗。

此時，系統應該會自動啟動代理程式服務，讓代理程式將必要資料安全上傳至雲端服務。

若要驗證已安裝代理程式，請在伺服器上尋找下列服務。 如果您已完成設定，這些服務應該已在執行中。 否則，服務會停止，直到設定完成為止。

• Microsoft Entra Connect 代理程式更新程式
• Microsoft Entra Connect Health 代理程式

在多部伺服器上快速安裝代理程式

1. 在 Microsoft Entra ID 中建立使用者帳戶。 使用密碼保護帳戶。

2. 使用入口網站，在 Microsoft Entra Connect Health 中為這個本機 Microsoft Entra 帳戶指派擁有者角色。 將角色指派給所有服務執行個體。

3. 下載本機網域控制站中的 .exe MSI 檔案以進行安裝。

4. 執行下列指令碼。 將參數取代為新的使用者帳戶及其密碼。

   AdHealthAddsAgentSetup.exe /quiet AddsMonitoringEnabled=1 SkipRegistration=1
   Start-Sleep 30
   $userName = "NEWUSER@DOMAIN"
   $secpasswd = ConvertTo-SecureString "PASSWORD" -AsPlainText -Force
   $myCreds = New-Object System.Management.Automation.PSCredential ($userName, $secpasswd)
   import-module "C:\Program Files\Microsoft Azure AD Connect Health Agent\Modules\AdHealthConfiguration"
   
   Register-MicrosoftEntraConnectHealthAgent -Credential $myCreds
   

當您完成時，您可以完成下列一或多項工作，以移除本機帳戶的存取權：

• 針對 Microsoft Entra Connect Health 的本機帳戶，移除角色指派。
• 針對本機帳戶輪替密碼。
• 停用 Microsoft Entra 本機帳戶。
• 刪除 Microsoft Entra 本機帳戶。

使用 PowerShell 註冊代理程式

在您安裝相關的代理程式 setup.exe 檔案之後，視角色而定，您可以使用下列 PowerShell 命令來註冊代理程式。 以系統管理員身分開啟 PowerShell，並執行相關命令：

Register-MicrosoftEntraConnectHealthAgent

Register-MicrosoftEntraConnectHealthAgent -UserPrincipalName upn-of-the-user

這些命令接受 Credential 作為參數，不需互動即可完成註冊，或是在執行 Server Core 的電腦上完成註冊。 請記住這些因素：

• 您可以在以參數形式傳遞的 PowerShell 變數中擷取 Credential。
• 您可以提供具有註冊代理程式權限，以及未啟用多重要素驗證的任何 Microsoft Entra 身分識別。
• 根據預設，全域系統管理員具有註冊代理程式的權限。 您也可以允許較低權限的身分識別來執行此步驟。 若要了解詳細資訊，請參閱＜Azure RBAC＞(機器翻譯)。

    $cred = Get-Credential
    Register-MicrosoftEntraConnectHealthAgent -Credential $cred

設定 Microsoft Entra Connect Health 代理程式使用 HTTP Proxy

您可以設定 Microsoft Entra Connect Health 代理程式使用 HTTP Proxy。

變更代理程式 Proxy 設定

若要設定 Microsoft Entra Connect Health 代理程式使用 HTTP Proxy，您可以：

• 匯入現有的 Proxy 設定。
• 以手動方式指定 Proxy 位址。
• 清除現有的 Proxy 設定。

匯入現有的 Proxy 設定

您可以匯入 Internet Explorer HTTP Proxy 設定，讓 Microsoft Entra Connect Health 代理程式可以使用這些設定。 在每部執行健康情況代理程式的伺服器上，執行下列 PowerShell 命令︰

Set-MicrosoftEntraConnectHealthProxySettings -ImportFromInternetSettings

您可以匯入 WinHTTP Proxy 設定，讓 Microsoft Entra Connect Health 代理程式可以使用這些設定。 在每部執行健康情況代理程式的伺服器上，執行下列 PowerShell 命令︰

Set-MicrosoftEntraConnectHealthProxySettings -ImportFromWinHttp

以手動方式指定 Proxy 位址

您可以手動指定 Proxy 伺服器。 在每部執行健康情況代理程式的伺服器上，執行下列 PowerShell 命令︰

Set-MicrosoftEntraConnectHealthProxySettings -HttpsProxyAddress address:port

以下是範例：

Set-MicrosoftEntraConnectHealthProxySettings -HttpsProxyAddress myproxyserver: 443

在此範例中：

• address 設定可以是可解析的 DNS 伺服器名稱或 IPv4 位址。
• 您可以省略 port。 如果您這麼做，443 是預設連接埠。

清除現有的 Proxy 設定

您可以執行下列命令來清除現有的 Proxy 設定：

Set-MicrosoftEntraConnectHealthProxySettings -NoProxy

讀取目前的 Proxy 設定

您可以執行下列命令來讀取目前的 Proxy 設定：

Get-MicrosoftEntraConnectHealthProxySettings

測試與 Microsoft Entra Connect Health 服務的連線

有時候，Microsoft Entra Connect Health 代理程式與 Microsoft Entra Connect Health 服務可能會中斷連線。 造成此連線中斷的原因包括網路問題、權限問題和其他各種問題。

如果代理程式無法將資料傳送給 Microsoft Entra Connect Health 服務達兩小時以上，入口網站中會出現下列警示：健全狀況服務資料不是最新資料。

您可以執行下列 PowerShell 命令，藉此確認受影響的 Microsoft Entra Connect Health 代理程式是否能將資料上傳至 Microsoft Entra Connect Health 服務：

Test-MicrosoftEntraConnectHealthConnectivity -Role ADFS

Role 參數目前可接受下列值：

• ADFS
• Sync
• ADDS

下一步

請參閱下列相關文章：

• Microsoft Entra Connect Health
• Microsoft Entra Connect Health 作業
• 搭配 AD FS 使用 Microsoft Entra Connect Health
• 使用 Microsoft Entra Connect Health 進行同步處理
• 搭配 AD Domain Services 使用 Microsoft Entra Connect Health
• Microsoft Entra Connect Health 常見問題
• Microsoft Entra Connect Health 版本歷程記錄