使用 MOMAgent.msi 手动安装 Windows 代理

可以使用 MOMAgent.msi 从命令行或使用安装向导部署 System Center Operations Manager 代理。 通过命令行部署代理也称为手动安装。 有关受支持的操作系统版本的列表，请参阅 Microsoft Monitoring Agent 操作系统要求。

使用任一方法来手动部署代理之前，请确保满足以下条件：

• 用于运行 MOMAgent.msi 的帐户必须在要安装代理的计算机上具有管理权限。

• 使用安装向导或从命令行安装的每个代理都必须获得管理组的批准。 有关详细信息，请参阅处理手动代理安装。

• 如果向域控制器手动部署了代理，并且后来部署了 Active Directory 管理包，则在部署管理包的过程中可能发生错误。 Active Directory 帮助程序对象用于 Windows 域控制器上的 Active Directory 管理包。 在使用发现向导部署代理时，会正常自动安装“Active Directory 管理包”帮助程序对象。 若要防止发生错误，或从已经发生的错误中恢复，需要在受影响的域控制器上手动安装 Windows 安装程序包 OomADs.msi。 该文件可以位于 %ProgramFiles%\Microsoft Monitoring Agent\Agent\HelperObjects 文件夹中的域控制器上。

• 必须将管理组 (或单一管理服务器) 配置为接受随 MOMAgent.msi 安装的代理，否则它们将自动被拒绝，因此不会显示在操作控制台中。 有关详细信息，请参阅处理手动代理安装。 如果将管理组或服务器配置为接受手动安装的代理，则在手动安装代理大约一小时之后，代理将显示在控制台中。

注意

有关代理端口要求的信息，请参阅代理与管理服务器之间的通信。

可以在 Operations Manager 安装介质中和 System Center Operations Manager 管理服务器上的以下文件夹中找到 MOMAgent.msi：%ProgramFiles%\Microsoft System Center\Operations Manager\Server\AgentManagement<platform>。

使用代理安装向导部署 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。 要使用来自 Active Directory 的管理组设置，请使用 1。
   USE_MANUALLY_SPECIFIED_SETTINGS=={0|1}	如果 USE_SETTINGS_FROM_AD=1，则 USE_MANUALLY_SPECIFIED_SETTINGS 必须等于 0。
   MANAGEMENT_GROUP=MG 名称	指定将管理计算机的管理组。
   MANAGEMENT_SERVER_DNS=MS 名称	指定管理服务器的完全限定的域名。 要使用网关服务器，请输入网关服务器的 FQDN MANAGEMENT_SERVER_DNS。
   MANAGEMENT_SERVER_AD_NAME=AD 名称	如果计算机的 DNS 名称和 Active Directory 名称不同，请使用此参数以设置为完全限定的 Active Directory 域服务名称。
   SECURE_PORT=端口号	设置运行状况服务端口号：
   ENABLE_ERROR_REPORTING={0|1}	可选参数。 将此参数与 1 配合使用，可以选择将错误报告转发给 Microsoft。 如果未包含此参数，则代理安装默认为 0，这将选择退出错误报告转发。
   QUEUE_ERROR_REPORTS={0|1}	可选参数。 将此参数与 1 一起使用可对错误报告进行排队，使用 0 可立即发送报告。 如果未包含此参数，则代理安装默认为 0。
   INSTALLDIR=路径	可选参数。 如果想要将代理安装到默认安装路径以外的其他文件夹，请使用此参数。 请注意，\Agent 将附加到此值之后。
   ACTIONS_USE_COMPUTER_ACCOUNT={0|1}	指示是使用指定的用户帐户 (0) 还是使用本地系统帐户 (1)。
   ACTIONSUSER=用户名	将代理操作帐户设置为 UserName。 如果指定了 ACTIONS_USE_COMPUTER_ACCOUNT=0，则需要此参数。
   ACTIONSDOMAIN= DomainName	设置使用 ACTIONSUSER 参数标识的代理操作帐户的域。
   ACTIONSPASSWORD= Password	使用 ACTIONSUSER 参数标识的用户的密码。
   NOAPM=1	可选参数。 安装无 .NET 应用程序性能监视功能的 Operations Manager 代理。 如果使用 AVIcode 5.7，则 NOAPM=1 会保留 AVIcode 代理。 如果使用 AVIcode 5.7 并使用不带 NOAPM=1 的 momagent.msi 安装 Operations Manager 代理，则 AVIcode 代理将无法正常工作，并且将生成警报。
   AcceptEndUserLicenseAgreement=1	用于指定你接受最终用户许可协议 (EULA)。 使用 /qn 执行代理的完全无提示安装时，必须使用此参数。

从命令行安装代理的示例

以下示例显示从命令行手动安装 MOMAgent.msi Windows Installer 安装程序包的不同方法。 可以执行新代理的安装、从以前的 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

使用 PowerShell 部署禁用 APM 的代理

下面的示例演示如何从禁用应用程序性能监视 (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

后续步骤

• 若要使用发现向导从操作控制台中部署 Windows 代理，请查看使用发现向导在 Windows 上安装代理。

• 如果想要使用发现向导从命令行安装 Nano 服务器代理或使用脚本或其他自动化解决方案使部署自动化，请查看在 Nano 服务器上安装代理。

• 若要了解如何在 Windows 计算机上从早期版本升级代理，请参阅如何将代理升级到 System Center Operations Manager 。

• 若要了解如何管理 Windows 代理和可用选项的配置设置，请查看配置 Windows 代理。

• 若要了解需要执行哪些选项和步骤才能从 Windows 计算机中正确卸载代理，请查看 从基于 Windows 的计算机卸载代理。