在 Windows 计算机上安装 Log Analytics 代理

以下步骤使用计算机上的代理安装向导在 Azure 和 Azure 政府云中安装和配置 Log Analytics 代理。 若要了解如何将代理配置为同时向 System Center Operations Manager 管理组报告，请参阅 通过代理设置向导部署 Operations Manager 代理。

1. 在 Log Analytics 工作区中，从导航到之前的 Windows Server 页中，根据 Windows作系统的处理器体系结构选择要下载的相应 下载 Windows 代理 版本。

2. 运行安装程序在计算机上安装该代理。

3. 在欢迎页面上，单击下一个。

4. 在“许可条款”页面上阅读许可协议，然后单击“我接受”。

5. 在“目标文件夹”页面上更改或保留默认安装文件夹，然后单击“下一步”。

6. 在“代理安装选项”页上，选择将代理连接到 Azure Log Analytics，单击“下一步”。

7. 在 Azure Log Analytics 页上，执行以下作：

   1. 粘贴前面复制的“工作区 ID”和“工作区密钥(主密钥)”。 如果计算机需要向 Azure 政府云中的 Log Analytics 工作区报告，请在 Azure 云下拉列表中选择 Azure 美国政府。
   2. 如果计算机需要通过代理服务器来与 Log Analytics 通信，请单击“高级”并提供代理服务器的 URL 和端口号。 如果代理服务器要求身份验证，请键入用于在代理服务器上进行身份验证的用户名和密码，并单击“下一步”。

8. 提供所需的配置设置后，单击“下一步”。

   

9. 在“准备安装”页上检查所做的选择，并单击“安装”。

10. 在“配置已成功完成”页上，单击“完成”。

完成后，Microsoft Monitoring Agent 将显示在“控制面板”中。 若要确认它正在向 Log Analytics 报告，请查看 验证代理与 Log Analytics 的连接。

代理的下载文件是一个独立安装包。 代理和支持文件的安装程序包含在包中，需要提取才能使用以下示例所示的命令行正确安装。

下表突出显示了安装代理支持的特定参数，包括使用 Automation DSC 部署时。

1. 若要提取代理安装文件，请在以管理员权限运行的命令提示符下运行 MMASetup-<platform>.exe /c。 系统会提示输入要提取文件的路径。 或者，可以通过传递参数 MMASetup-<platform>.exe /c /t:<Full Path>来指定路径。

2. 若要以无提示方式安装代理并将其配置为向 Azure 商业云中的工作区报告，请从提取安装文件的文件夹输入：

   setup.exe /qn NOAPM=1 ADD_OPINSIGHTS_WORKSPACE=1 OPINSIGHTS_WORKSPACE_AZURE_CLOUD_TYPE=0 OPINSIGHTS_WORKSPACE_ID="<your workspace ID>" OPINSIGHTS_WORKSPACE_KEY="<your workspace key>" AcceptEndUserLicenseAgreement=1
   

   或者，若要将代理配置为向 Azure 美国政府云报告，请输入：

   setup.exe /qn NOAPM=1 ADD_OPINSIGHTS_WORKSPACE=1 OPINSIGHTS_WORKSPACE_AZURE_CLOUD_TYPE=1 OPINSIGHTS_WORKSPACE_ID="<your workspace ID>" OPINSIGHTS_WORKSPACE_KEY="<your workspace key>" AcceptEndUserLicenseAgreement=1
   

   或者，若要将代理配置为向由世纪互联云运营的 Microsoft Azure 汇报，请输入：

   setup.exe /qn NOAPM=1 ADD_OPINSIGHTS_WORKSPACE=1 OPINSIGHTS_WORKSPACE_AZURE_CLOUD_TYPE=2 OPINSIGHTS_WORKSPACE_ID="<your workspace ID>" OPINSIGHTS_WORKSPACE_KEY="<your workspace key>" AcceptEndUserLicenseAgreement=1
   

   注释

   参数的字符串值 OPINSIGHTS_WORKSPACE_ID 和 OPINSIGHTS_WORKSPACE_KEY 需要用双引号括起来，以指示 Windows Installer 解释为包的有效选项。

可以使用以下脚本示例通过 Azure 自动化 DSC 安装代理。 如果没有自动化帐户，请参阅 Azure 自动化入门 ，了解在使用 Automation DSC 之前创建所需的自动化帐户的要求和步骤。 如果不熟悉 Automation DSC，请查看 Automation DSC 入门。

以下示例安装由值标识 URI 的 64 位代理。 还可以通过替换 URI 值来使用 32 位版本。 这两个版本的 URI 为：

• Windows 64 位代理：https://go.microsoft.com/fwlink/?LinkId=828603
• Windows 32 位代理：https://go.microsoft.com/fwlink/?LinkId=828604

代理包的 32 位和 64 位版本具有不同的产品代码，发布的新版本也具有唯一标识。 产品代码是用于标识应用程序或产品的主要 GUID，由 Windows Installer ProductCode 属性表示。 ProductId MMAgent.ps1 脚本中的值必须与 32 位或 64 位代理安装程序包中的产品代码匹配。

若要直接从代理安装包中检索产品代码，可以使用 Windows Installer 开发人员的 Windows SDK 组件（这是 Windows 软件开发工具包的组件）中的 Orca.exe，或使用 PowerShell，以Microsoft有价值专业（MVP）编写 的示例脚本 为例。 对于任一方法，首先需要从 MMASetup 安装包中提取 MOMagent.msi 文件，如使用命令行安装代理的说明的第一步中所述。

1. 将 xPSDesiredStateConfiguration DSC 模块从 https://www.powershellgallery.com/packages/xPSDesiredStateConfiguration 导入到 Azure 自动化。

2. 为 OPSINSIGHTS_WS_ID 和 OPSINSIGHTS_WS_KEY创建 Azure 自动化变量资产。 将OPSINSIGHTS_WS_ID设置为 Log Analytics 工作区 ID，并将OPSINSIGHTS_WS_KEY设置为工作区的主键。

3. 复制脚本并将其另存为 MMAgent.ps1。

   Configuration MMAgent
   {
       $OIPackageLocalPath = "C:\Deploy\MMASetup-AMD64.exe"
       $OPSINSIGHTS_WS_ID = Get-AutomationVariable -Name "OPSINSIGHTS_WS_ID"
       $OPSINSIGHTS_WS_KEY = Get-AutomationVariable -Name "OPSINSIGHTS_WS_KEY"
   
       Import-DscResource -ModuleName xPSDesiredStateConfiguration
       Import-DscResource -ModuleName PSDesiredStateConfiguration
   
       Node OMSnode {
           Service OIService
           {
               Name = "HealthService"
               State = "Running"
               DependsOn = "[Package]OI"
           }
   
           xRemoteFile OIPackage {
               Uri = "https://go.microsoft.com/fwlink/?LinkId=828603"
               DestinationPath = $OIPackageLocalPath
           }
   
           Package OI {
               Ensure = "Present"
               Path = $OIPackageLocalPath
               Name = "Microsoft Monitoring Agent"
               ProductId = "8A7F2C51-4C7D-4BFD-9014-91D11F24AAE2"
               Arguments = '/C:"setup.exe /qn NOAPM=1 ADD_OPINSIGHTS_WORKSPACE=1 OPINSIGHTS_WORKSPACE_ID=' + $OPSINSIGHTS_WS_ID + ' OPINSIGHTS_WORKSPACE_KEY=' + $OPSINSIGHTS_WS_KEY + ' AcceptEndUserLicenseAgreement=1"'
               DependsOn = "[xRemoteFile]OIPackage"
           }
       }
   }
   
   

4. 更新脚本中的ProductId值，将其替换为使用前面推荐的方法从最新版本的代理安装包中提取的产品代码。

5. 将 MMAgent.ps1 配置脚本导入 自动化帐户。

6. 将 Windows 计算机或节点分配给配置。 在 15 分钟内，节点会检查其配置，并将代理推送到节点。