使用 MOMAgent.msi 手動安裝 Windows 代理程式

重要

此版本的 Operations Manager 已終止支援。 建議您 升級至 Operations Manager 2022

您可以使用 MOMAgent.msi 從命令行或使用安裝精靈部署 System Center Operations Manager 代理程式。 從命令列部署代理程式也稱為手動安裝。 如需支援的作業系統版本清單,請參閱 Microsoft Monitoring Agent 作業系統需求

在您可以使用上述兩種方法手動部署代理程式之前,請確保已符合下列條件:

  • 用來執行 MOMAgent.msi 的帳戶必須具有安裝代理程式之電腦上的系統管理許可權。

  • 使用安裝精靈或透過命令列安裝的每個代理程式都必須經過管理群組核准。 如需詳細資訊,請參閱 Process Manual Agent Installations

  • 若將代理程式手動部署到網域控制站,並於稍後部署 Active Directory 管理組件,則可能會在部署管理組件時發生錯誤。 Windows 網域控制站上的 Active Directory 管理組件會使用 Active Directory 協助程式物件。 使用探索精靈部署代理程式時,Active Directory 管理組件協助程式物件通常會自動安裝。 為了避免發生錯誤,或是從已發生的錯誤中復原,您必須在受影響的網域控制站上手動安裝 Windows 安裝程式套件 OomADs.msi。 該檔案位於網域控制站上的 %ProgramFiles%\Microsoft Monitoring Agent\Agent\HelperObjects 中。

  • 管理群組 (或單一管理伺服器) 必須設定為接受隨 MOMAgent.msi 安裝的代理程式,否則系統會自動拒絕它們,因此不會顯示在 Operations 控制台中。 如需詳細資訊,請參閱 Process Manual Agent Installations。 如果手動安裝代理程式之後,將管理群組或伺服器設定為接受手動安裝的代理程式,則大約一小時之後會在主控台中顯示代理程式。

注意

如需代理程式連接埠需求的相關資訊,請參閱代理程式與管理伺服器之間的通訊

您可以在 Operations Manager 安裝媒體中找到 MOMAgent.msi,也可以在 System Center - Operations Manager 管理伺服器上的下列資料夾中找到:%ProgramFiles%\Microsoft System Center 2016\Operations Manager\Server\AgentManagement<平台>

MOMAgent.msi 位於 Operations Manager 安裝媒體和 System Center - Operations Manager 管理伺服器 - %ProgramFiles%\Microsoft System Center\Operations Manager\Server\AgentManagement<平臺上>的下列資料夾中。

重要

System Center 2016 Operations Manager 和 1801 版代理程式的應用程式效能監視 (APM) 功能,在 .NET Framework 2.0 執行階段下執行的 IIS 應用程式集區下,會造成當機。 根據預設,在 Windows 電腦上安裝代理程式時,APM 元件預設會安裝。 在您部署代理程式時,若要避免發生問題並防止目標 Windows 伺服器上 APM 元件的安裝,請新增 NOAPM=true 參數

使用代理程式安裝精靈部署 Operations Manager 代理程式

請遵循下列步驟,使用代理程式安裝精靈部署 Operations Manager 代理程式:

  1. 使用本機系統管理員許可權來登入您要安裝代理程式的計算機。

  2. 在 Operations Manager 安裝媒體上,按兩下 Setup.exe

  3. [選擇性安裝] 中,選取 [ 本機代理程式]。

  4. 在 [歡迎] 頁面上,選取 [下一步] 。

  5. 在 [ 重要注意事項 ] 頁面上,檢閱 Microsoft 軟體授權條款,然後選取 [我同意]。

  6. 在 [ 目的地資料夾] 頁面上,將安裝資料夾保留為預設值,或選取 [ 變更 ] 並輸入路徑,然後選取 [ 下一步]。

  7. 在 [代理程式安裝選項] 頁面上,您可以選擇是否要「將代理程式連線到 Operations Manager」 。 當您將代理程式與 Operations Manager 連線時,可以手動選擇此代理程式即將參與監視的管理群組。 如果您未選取此選項,代理程式仍然可以在本機收集應用程式效能監視數據。 您可以在 [控制台] 的 [監視代理程式] 項目中變更選擇。

  8. 在 [管理群組設定] 頁面上,執行下列動作:

    a. 在 [ 管理組名 ] 欄位中輸入管理群組的名稱,然後在 [ 管理 伺服器] 欄位中輸入 (哪個伺服器?) 伺服器名稱。

    注意

    若要使用閘道伺服器,請在 [管理伺服器] 文字方塊中輸入閘道伺服器名稱。

    b. 輸入 管理伺服器埠的值,或保留預設值 5723。

    c. 輸入 [下一步]。

  9. 在 [ 代理程式動作帳戶] 頁面上,將它保留為 [ 本機系統] 的預設值,或選取 [ 網域] 或 [本機計算機帳戶] ;輸入 使用者帳戶密碼網域或本機計算機;然後選取 [ 下一步]。

  10. 在 [ 準備安裝 ] 頁面上,檢閱設定,然後選取 [ 安裝 ] 以顯示 [ 安裝 Microsoft Monitoring Agent] 頁面。

  11. 當 [ 正在完成 Microsoft Monitoring Agent 安裝精靈 ] 頁面出現時,選取 [ 完成]。

從命令行部署 Operations Manager 代理程式

請遵循下列步驟,從命令行部署 Operations Manager 代理程式:

  1. 使用具有本機系統管理員許可權的帳戶登入您要安裝代理程式的計算機。

  2. 以系統管理員身分開啟命令提示字元。

  3. 執行下列命令:

    
    %WinDir%\System32\msiexec.exe /i path\Directory\MOMAgent.msi /qn USE_SETTINGS_FROM_AD={0|1} USE_MANUALLY_SPECIFIED_SETTINGS={0|1} MANAGEMENT_GROUP=MGname MANAGEMENT_SERVER_DNS=MSname MANAGEMENT_SERVER_AD_NAME =MSname SECURE_PORT=PortNumber ACTIONS_USE_COMPUTER_ACCOUNT={0|1} ACTIONSUSER=UserName ACTIONSDOMAIN=DomainName ACTIONSPASSWORD=Password AcceptEndUserLicenseAgreement=1
    
    

    注意

    請確定針對您要安裝代理程式的計算機使用正確的 32 位或 64 位版本的 MOMAgent.msi。

    其中:

    參數
    USE_SETTINGS_FROM_AD={0|1} 表示是否將在命令列上設定管理群組設定內容。 如果要在命令列設定內容,請使用 0。 使用 1 可使用 Active Directory 的管理群組設定。
    USE_MANUALLY_SPECIFIED_SETTINGS=={0|1} 如果 USE_SETTINGS_FROM_AD=1,則 USE_MANUALLY_SPECIFIED_SETTINGS 必須等於 0。
    MANAGEMENT_GROUP=MGname 指定將管理電腦的管理群組。
    MANAGEMENT_SERVER_DNS=MSname 指定管理伺服器的完整網域名稱。 若要使用匣道伺服器,請將閘道伺服器 FQDN 輸入為 MANAGEMENT_SERVER_DNS
    MANAGEMENT_SERVER_AD_NAME=ADname 如果電腦的 DNS 和 Active Directory 名稱不同,請使用此參數設定為完整的 Active Directory 網域服務名稱。
    SECURE_PORT=PortNumber 設定健全狀況服務連接埠號碼。
    ENABLE_ERROR_REPORTING={0|1} 選擇性參數。 使用此參數搭配 1 ,選擇加入錯誤報告轉寄給 Microsoft。 如果您未包含此參數,代理程式安裝預設為 0,這會退出宣告錯誤報告轉送。
    QUEUE_ERROR_REPORTS={0|1} 選擇性參數。 使用此參數搭配 1 將錯誤報告排入佇列,或搭配 0 立即傳送報告。 如果您沒有包含此參數,代理程式安裝預設為 0
    INSTALLDIR=path 選擇性參數。 如果您想要將代理程式安裝到預設安裝路徑以外的資料夾,請使用此參數。 請注意,\Agent 將會附加至此值。
    ACTIONS_USE_COMPUTER_ACCOUNT={0|1} 指出要使用指定的使用者帳戶 (0) 或本機系統帳戶 (1)。
    ACTIONSUSER=UserName 將代理程式動作帳戶設定為 UserName。 如果您前面指定 ACTIONS_USE_COMPUTER_ACCOUNT=0,就需要此參數。
    ACTIONSDOMAIN= DomainName 設定使用 ACTIONSUSER 參數識別之代理程式動作帳戶的網域。
    ACTIONSPASSWORD= Password 設定使用 ACTIONSUSER 參數識別之使用者的密碼。
    NOAPM=1 選擇性參數。 安裝 Operations Manager 代理程式,但不包括 .NET 應用程式效能監視。 如果您使用AVIcode 5.7,NOAPM=1 會就地離開AVIcode代理程式。 如果您使用 AVIcode 5.7 並使用不含 NOAPM=1 的 momagent.msi 來安裝 Operations Manager 代理程式,則 AVIcode 代理程式將無法正常運作,而且會產生警示。
    AcceptEndUserLicenseAgreement=1 用來指定您接受使用者授權合約 (EULA)。 使用 /qn 來執行代理程式完全無訊息安裝時,此為必要參數。

從命令列安裝代理程式的範例

下列範例示範手動從命令列安裝 MOMAgent.msi Windows 安裝程式套件的數種不同方式。 您可以執行代理程式的新安裝、從舊版 Operations Manager 升級代理程式、將代理程式解除安裝,或是變更代理程式的設定 (例如與代理程式相關聯的管理群組或管理伺服器)。

使用特定動作帳戶安裝代理程式

下列範例顯示全新代理程式安裝並使用特定動作帳戶。

msiexec.exe /i path\Directory\MOMAgent.msi /qn /l*v %temp%\OMAgentinstall.log USE_SETTINGS_FROM_AD=0 MANAGEMENT_GROUP=<MG_Name> MANAGEMENT_SERVER_DNS=<MSDNSName> MANAGEMENT_SERVER_AD_NAME=<MSDNSName> ACTIONS_USE_COMPUTER_ACCOUNT=0 ACTIONSUSER=<AccountUser> ACTIONSDOMAIN=<AccountDomain> ACTIONSPASSWORD=<AccountPassword> USE_MANUALLY_SPECIFIED_SETTINGS=1 AcceptEndUserLicenseAgreement=1

使用本機系統帳戶安裝代理程式

下列範例顯示全新代理程式安裝並使用本機系統作為動作帳戶。

msiexec.exe /i path\Directory\MOMAgent.msi /qn /l*v %temp%\OMAgentinstall.log USE_SETTINGS_FROM_AD=0 MANAGEMENT_GROUP=<MG_Name> MANAGEMENT_SERVER_DNS=<MSDNSName> MANAGEMENT_SERVER_AD_NAME=<MSDNSName> ACTIONS_USE_COMPUTER_ACCOUNT=1 USE_MANUALLY_SPECIFIED_SETTINGS=1 AcceptEndUserLicenseAgreement=1

使用 Active Directory 整合和特定動作帳戶安裝代理程式

下列範例使用 Active Directory 和特定動作帳戶安裝代理程式。

msiexec /i path\Directory\MOMAgent.msi /qn /l*v %temp%\OMAgentInstall.log USE_SETTINGS_FROM_AD=1 USE_MANUALLY_SPECIFIED_SETTINGS=0 ACTIONS_USE_COMPUTER_ACCOUNT=0 ACTIONSUSER=<AccountUser> ACTIONSDOMAIN=<AccountDomain> ACTIONSPASSWORD=<AccountPassword> AcceptEndUserLicenseAgreement=1

使用 Active Directory 整合和本機系統帳戶安裝代理程式

下列範例使用 Active Directory 和本機系統帳戶作為動作帳戶來安裝代理程式。

msiexec /i path\Directory\MOMAgent.msi /qn /l*v %temp%\OMAgentInstall.log USE_SETTINGS_FROM_AD=1 ACTIONS_USE_COMPUTER_ACCOUNT=1 USE_MANUALLY_SPECIFIED_SETTINGS=0 AcceptEndUserLicenseAgreement=1

從舊版 Operations Manager 升級代理程式

下列範例會升級代理程式。

msiexec /i path\Directory\MOMAgent.msi /qn /l*v %temp%\OMAgentUpgrade.log AcceptEndUserLicenseAgreement=1

解除安裝代理程式

下列範例會解除安裝代理程式。

msiexec /x path\Directory\MOMAgent.msi /qn /l*v %temp%\OMAgentUninstall.log

在 APM 已停用的情況下使用 PowerShell 部署代理程式

下列範例顯示如何在應用程式效能監視 (APM) 元件已停用的情況下,從 PowerShell 安裝 Windows 代理程式。

$PrimaryMS = Get-SCOMManagementServer -Name <MSDNSName>
Install-SCOMAgent -DNSHostName 'ComputerA.contoso.com' -PrimaryManagementServer $PrimaryMS -NoAPM

使用 PowerShell 修復代理程式並停用 APM

下列範例顯示如何從 PowerShell 修復 Windows 代理程式並停用應用程式效能監視 (APM) 元件。

Get-SCOMAgent -DNSHostName "ComputerA.contoso.net" | Repair-SCOMAgent -NoAPM

後續步驟