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

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

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

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

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

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

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

注意

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

可以在 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= 密码	使用 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 Server 代理，请从命令行或使用脚本或其他自动化解决方案自动执行部署，请查看 Nano Server 上的安装代理。

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

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

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