Verbinden von Windows-Computern mit dem Log Analytics-Dienst in AzureConnect Windows computers to the Log Analytics service in Azure

Dieser Artikel beschreibt die Schritte, mit denen Sie Windows-Computer in Ihrer lokalen Infrastruktur mit OMS-Arbeitsbereichen verbinden können, indem Sie eine benutzerdefinierte Version des Microsoft Monitoring Agents (MMA) verwenden.This article shows the steps to connect Windows computers in your on-premises infrastructure to OMS workspaces by using a customized version of the Microsoft Monitoring Agent (MMA). Sie müssen Agents für alle Computer, die aufgenommen werden sollen, installieren und verbinden, damit diese Daten an den Log Analytics-Dienst übermitteln und um diese Daten anzuzeigen und zu bearbeiten.You need to install and connect agents for all of the computers that you want to onboard in order for them to send data to the Log Analytics service and to view and act on that data. Jeder Agent kann Berichte zu mehreren Arbeitsbereichen erstellen.Each agent can report to multiple workspaces.

Sie können Agents über das Setup, eine Befehlszeile oder durch eine Konfiguration des gewünschten Zustands in Azure Automation installieren.You can install agents using Setup, command line, or with Desired State Configuration (DSC) in Azure Automation.

Hinweis

Für virtuelle Computer in Azure können Sie die Installation vereinfachen, indem Sie die VM-Erweiterung verwenden.For virtual machines running in Azure, you can simplify installation by using the virtual machine extension.

Auf Computern mit Internetverbindung nutzt der Agent die Internetverbindung, um Daten an OMS zu senden.On computers with Internet connectivity, the agent uses the connection to the Internet to send data to OMS. Bei Computern ohne Internetverbindung können Sie einen Proxy oder das OMS-Gateway verwenden.For computers that do not have Internet connectivity, you can use a proxy or the OMS Gateway.

Sie können Ihre Windows-Computer ganz einfach mit OMS verbinden, indem Sie die drei folgenden Schritte ausführen:Connecting your Windows computers to OMS is straightforward using three simple steps:

  1. Laden Sie OMS-Portal die Setup-Datei für den Agent herunter.Download the agent setup file from the OMS portal
  2. Installieren Sie den Agent mit der von Ihnen bevorzugten Methode.Install the agent using the method you choose
  3. Konfigurieren Sie den Agent, oder fügen Sie bei Bedarf zusätzliche Arbeitsbereiche hinzu.Configure the agent or add additional workspaces, if necessary

Das folgende Diagramm zeigt die Beziehung zwischen Ihren Windows-Computern und OMS nach der Installation und Konfiguration der Agents.The following diagram shows the relationship between your Windows computers and OMS after you’ve installed and configured agents.

oms-direct-agent-diagram

Wenn laut Ihren IT-Sicherheitsrichtlinien Computer in Ihrem Netzwerk keine Verbindung mit dem Internet herstellen dürfen, können Sie Ihre Computer so konfigurieren, dass eine Verbindung zum OMS-Gateway hergestellt wird.If your IT security policies do not allow computers on your network to connect to the Internet, you can configure your computers to connect to the OMS Gateway. Weitere Informationen und Schritte zum Konfigurieren Ihrer Server für die Kommunikation mit dem OMS-Dienst über ein OMS-Gateway finden Sie unter Verbinden von Computern mit der OMS über das OMS-Gateway.For more information and steps on how to configure your servers to communicate through an OMS Gateway to the OMS service, see Connect computers to OMS using the OMS Gateway.

Systemanforderungen und erforderliche KonfigurationSystem requirements and required configuration

Prüfen Sie vor der Installation oder Bereitstellung der Agents die folgenden Details, um sicherzustellen, dass die Anforderungen erfüllt sind.Before you install or deploy agents, review the following details to ensure you meet the requirements.

  • Sie können den OMS MMA nur auf Computern installieren, auf denen Windows Server 2008 SP1 oder höher oder Windows 7 SP1 oder höher ausgeführt wird.You can only install the OMS MMA on computers running Windows Server 2008 SP 1 or later or Windows 7 SP1 or later.
  • Sie benötigen ein Azure-Abonnement.You need an Azure subscription. Weitere Informationen finden Sie unter Erste Schritte mit Log Analytics.For more information, see Get started with Log Analytics.
  • Jeder Windows-Computer muss über HTTPS oder das OMS-Gateway eine Verbindung mit dem Internet herstellen können.Each Windows computer must be able to connect to the Internet using HTTPS or to the OMS Gateway. Diese Verbindung kann direkt, über einen Proxy oder über das OMS-Gateway hergestellt werden.This connection can be direct, via a proxy, or through the OMS Gateway.
  • Sie können den OMS MMA auf eigenständigen Computern, Servern und virtuellen Computern installieren.You can install the OMS MMA on stand-alone computers, servers, and virtual machines. Informationen zum Verbinden von in Azure gehosteten virtuellen Computern mit OMS finden Sie unter Connect Azure virtual machines to Log Analytics (Herstellen einer Verbindung zwischen Azure-VMs und Log Analytics).If you want to connect Azure-hosted virtual machines to OMS, see Connect Azure virtual machines to Log Analytics.
  • Der Agent muss den TCP-Port 443 für verschiedene Ressourcen verwenden.The agent needs to use TCP port 443 for various resources.

NetzwerkNetwork

Damit Windows-Agents eine Verbindung mit dem OMS-Dienst herstellen und sich bei diesem registrieren können, müssen sie Zugriff auf Netzwerkressourcen, einschließlich der Portnummern und Domänen-URLs, haben.For Windows agents to connect to and register with the OMS service, they must have access to network resources, including the port numbers and domain URLs.

  • Für Proxy-Server müssen Sie sicherstellen, dass die entsprechenden Proxy-Serverressourcen in Agenteinstellungen konfiguriert sind.For proxy servers, you need to ensure that the appropriate proxy server resources are configured in agent settings.
  • Für Firewalls, die den Zugriff auf das Internet einschränken, müssen Ihre Netzwerktechniker die Firewall so konfigurieren, dass OMS Zugriff erhält.For firewalls that restrict access to the Internet, you or your networking engineers need to configure your firewall to permit access to OMS. In den Agenteinstellungen ist keine Aktion erforderlich.No action is needed in agent settings.

Die folgende Tabelle zeigt die für die Kommunikation erforderlichen Ressourcen.The following table shows resources needed for communication.

Hinweis

In einigen der folgenden Ressourcen wird Operational Insights erwähnt, wobei es sich um einen früheren Namen von Log Analytics handelt.Some of the following resources mention Operational Insights, which was a previous name for Log Analytics.

Agent-RessourceAgent Resource PortsPorts Umgehung der HTTPS-ÜberprüfungBypass HTTPS inspection
.ods.opinsights.azure.com.ods.opinsights.azure.com 443443 JaYes
.oms.opinsights.azure.com.oms.opinsights.azure.com 443443 JaYes
.blob.core.windows.net.blob.core.windows.net 443443 JaYes
.azure-automation.net.azure-automation.net 443443 JaYes

Herunterladen der Setup-Datei von OMSDownload the agent setup file from OMS

  1. Klicken Sie im OMS-Portal auf der Seite Übersicht auf die Kachel Einstellungen.In the OMS portal, on the Overview page, click the Settings tile. Klicken Sie oben auf die Registerkarte Verbundene Datenquellen .Click the Connected Sources tab at the top.
    Registerkarte „Verbundene Datenquellen“Connected Sources tab
  2. Klicken Sie auf Windows-Server und dann auf Windows-Agent herunterladen für den entsprechenden Prozessortyp, um die Setupdatei herunterzuladen.Click Windows Servers and then click Download Windows Agent applicable to your computer processor type to download the setup file.
  3. Klicken Sie rechts von Arbeitsbereichs-IDauf das Kopiersymbol, und fügen Sie die ID in den Editor ein.On the right of Workspace ID, click the copy icon and paste the ID into Notepad.
  4. Klicken Sie rechts von Primärschlüsselauf das Kopiersymbol, und fügen Sie den Schlüssel in den Editor ein.On the right of Primary Key, click the copy icon and paste the key into Notepad.

Installieren des Agents über SetupInstall the agent using setup

  1. Führen Sie Setup aus, um den Agent auf einem Computer zu installieren, den Sie verwalten möchten.Run Setup to install the agent on a computer that you want to manage.
  2. Klicken Sie auf der Seite Willkommenauf Weiter.On the Welcome page, click Next.
  3. Lesen Sie die Seite „Lizenzbedingungen“ durch, und klicken Sie anschließend auf Ich stimme zu.On the License Terms page, read the license and then click I Agree.
  4. Auf der Seite „Zielordner“ können Sie den Standardinstallationsordner entweder ändern oder beibehalten. Klicken Sie anschließend auf Weiter.On the Destination Folder page, change or keep the default installation folder and then click Next.
  5. Wählen Sie auf der Seite „Agent-Setupoptionen“ aus, ob der Agent mit Azure Log Analytics (OMS) oder Operations Manager verbunden werden soll. Sie können die Auswahl aber auch leer lassen, wenn Sie den Agent später konfigurieren möchten.On the Agent Setup Options page, you can choose to connect the agent to Azure Log Analytics (OMS), Operations Manager, or you can leave the choices blank if you want to configure the agent later. Klicken Sie auf Weiter. Click Next.

    • Wenn Sie eine Verbindung mit Azure Log Analytics (OMS) herstellen möchten, fügen Sie die Arbeitsbereichs-ID und den Arbeitsbereichsschlüssel (Primärschlüssel) ein, die Sie im vorherigen Schritt in Editor kopiert haben, und klicken Sie auf Weiter.If you chose to connect to Azure Log Analytics (OMS), paste the Workspace ID and Workspace Key (Primary Key) that you copied into Notepad in the previous procedure and then click Next.
      Arbeitsbereichs-ID und Primärschlüssel einfügenpaste Workspace ID and Primary Key
    • Wenn Sie eine Verbindung mit Operations Manager herstellen möchten, geben Sie den Namen der Verwaltungsgruppe, den Namen des Verwaltungsservers und den Verwaltungsserverport ein, und klicken Sie anschließend auf Weiter.If you chose to connect to Operations Manager, type the Management Group Name, Management Server name, and Management Server Port, and then click Next. Wählen Sie auf der Seite „Agentaktionskonto“ entweder das lokale Systemkonto oder ein lokales Domänenkonto aus, und klicken Sie auf Weiter.On the Agent Action Account page, choose either the Local System account or a local domain account and then click Next.
      VerwaltungsgruppenkonfigurationAgentaktionskontomanagement group configurationagent action account
  6. Überprüfen Sie Ihre Auswahl auf der Seite „Bereit zum Installieren“, und klicken Sie dann auf Installieren.On the Ready to Install page, review your choices and then click Install.

  7. Klicken Sie auf der Seite „Die Konfiguration wurde erfolgreich abgeschlossen“ auf Fertig stellen.On the Configuration completed successfully page, click Finish.
  8. Nach Abschluss wird der Microsoft Monitoring Agent in der Systemsteuerung angezeigt.When complete, the Microsoft Monitoring Agent appears in Control Panel. Dort können Sie Ihre Konfiguration überprüfen und sicherstellen, dass der Agent mit Operational Insights (OMS) verbunden ist.You can review your configuration there and verify that the agent is connected to Operational Insights (OMS). Wenn die Verbindung mit OMS hergestellt ist, zeigt der Agent die folgende Meldung an: The Microsoft Monitoring Agent has successfully connected to the Microsoft Operations Management Suite serviceWhen connected to OMS, the agent displays a message stating: The Microsoft Monitoring Agent has successfully connected to the Microsoft Operations Management Suite service.

Konfigurieren von ProxyeinstellungenConfigure proxy settings

Mit dem folgenden Verfahren können Sie Proxyeinstellungen für den Microsoft Monitoring Agent über die Systemsteuerung konfigurieren.You can use the following procedure to configure proxy settings for the Microsoft Monitoring Agent using Control Panel. Sie müssen diese Schritte für jeden Server ausführen.You need to use this procedure for each server. Wenn Sie viele Server konfigurieren müssen, ist es möglicherweise einfacher, diesen Prozess mithilfe eines Skripts zu automatisieren.If you have many servers that you need to configure, you might find it easier to use a script to automate this process. Wenn dies der Fall ist, finden Sie entsprechende Anweisungen unter So konfigurieren Sie Proxyeinstellungen für den Microsoft Monitoring Agent mithilfe eines Skripts.If so, see the next procedure To configure proxy settings for the Microsoft Monitoring Agent using a script.

So konfigurieren Sie Proxyeinstellungen für den Microsoft Monitoring Agent über die SystemsteuerungTo configure proxy settings for the Microsoft Monitoring Agent using Control Panel

  1. Öffnen Sie die Systemsteuerung.Open Control Panel.
  2. Öffnen Sie Microsoft Monitoring Agent.Open Microsoft Monitoring Agent.
  3. Klicken Sie auf die Registerkarte Proxyeinstellungen .Click the Proxy Settings tab.
    Registerkarte „Proxyeinstellungen“proxy settings tab
  4. Wählen Sie Proxyserver verwenden aus, und geben Sie die URL und gegebenenfalls die Portnummer ein (siehe dazu das Beispiel oben).Select Use a proxy server and type the URL and port number, if one is needed, similar to the example shown. Wenn der Proxyserver eine Authentifizierung erfordert, geben Sie den Benutzernamen und das Kennwort für den Zugriff auf den Proxyserver ein.If your proxy server requires authentication, type the username and password to access the proxy server.

Überprüfen der Agentkonnektivität mit OMSVerify agent connectivity to OMS

Sie können mithilfe der folgenden Schritte problemlos überprüfen, ob die Agents mit OMS kommunizieren:You can easily verify whether your agents are communicating with OMS using the following procedure:

  1. Öffnen Sie auf dem Computer mit dem Windows-Agent-die Systemsteuerung.On the computer with the Windows agent, open Control Panel.
  2. Öffnen Sie Microsoft Monitoring Agent.Open Microsoft Monitoring Agent.
  3. Klicken Sie auf die Registerkarte „Azure Log Analytics (OMS)“.Click the Azure Log Analytics (OMS) tab.
  4. In der Statusspalte sollte angezeigt werden, dass der Agent erfolgreich mit dem Operations Management Suite-Dienst verbunden wurde.In the Status column, you should see that the agent connected successfully to the Operations Management Suite service.

Agent verbunden

So konfigurieren Sie Proxyeinstellungen für den Microsoft Monitoring Agent mithilfe eines SkriptsTo configure proxy settings for the Microsoft Monitoring Agent using a script

Kopieren Sie das folgende Beispiel, aktualisieren Sie es mit den tatsächlichen Informationen für Ihre Umgebung, und speichern Sie es mit der Dateinamenerweiterung PS1. Führen Sie das Skript dann auf jedem Computer aus, der eine direkte Verbindung mit dem OMS-Dienst herstellt.Copy the following sample, update it with information specific to your environment, save it with a PS1 file name extension, and then run the script on each computer that connects directly to the OMS service.

param($ProxyDomainName="http://proxy.contoso.com:80", $cred=(Get-Credential))

# First we get the Health Service configuration object.  We need to determine if we
#have the right update rollup with the API we need.  If not, no need to run the rest of the script.
$healthServiceSettings = New-Object -ComObject 'AgentConfigManager.MgmtSvcCfg'

$proxyMethod = $healthServiceSettings | Get-Member -Name 'SetProxyInfo'

if (!$proxyMethod)
{
     Write-Output 'Health Service proxy API not present, will not update settings.'
     return
}

Write-Output "Clearing proxy settings."
$healthServiceSettings.SetProxyInfo('', '', '')

$ProxyUserName = $cred.username

Write-Output "Setting proxy to $ProxyDomainName with proxy username $ProxyUserName."
$healthServiceSettings.SetProxyInfo($ProxyDomainName, $ProxyUserName, $cred.GetNetworkCredential().password)

Installieren des Agents über die BefehlszeileInstall the agent using the command line

  • Ändern Sie das folgende Beispiel, und verwenden Sie es dann zur Installation des Agents über die Befehlszeile.Modify and then use the following example to install the agent using the command line. Das Beispiel führt eine vollständig automatische Installation aus.The example performs a fully silent installation.

    Hinweis

    Wenn Sie einen Agent aktualisieren möchten, müssen Sie die Skripting-API für Log Analytics verwenden.If you want to upgrade an agent, you need to use the Log Analytics scripting API. Im nächsten Abschnitt finden Sie Informationen zum Aktualisieren eines Agents.See the next section to upgrade an agent.

    MMASetup-AMD64.exe /Q:A /R:N /C:"setup.exe /qn ADD_OPINSIGHTS_WORKSPACE=1 OPINSIGHTS_WORKSPACE_ID=<your workspace id> OPINSIGHTS_WORKSPACE_KEY=<your workspace key> AcceptEndUserLicenseAgreement=1"
    

Der Agent verwendet IExpress als sein Self-Extractor mithilfe des /c Befehls.The agent uses IExpress as its self-extractor using the /c command. Weitere Informationen zu den Befehlszeilenswitches finden Sie unter Befehlszeilenoptionen für IExpress-Softwareupdatepakete. Sie können anschließend das Beispiel aktualisieren, um es an Ihre Bedürfnisse anzupassen.You can see the command-line switches at Command-line switches for IExpress and then update the example to suit your needs.

MMA-spezifische OptionenMMA-specific options HinweiseNotes
ADD_OPINSIGHTS_WORKSPACEADD_OPINSIGHTS_WORKSPACE 1 = Konfigurieren des Agents, sodass Berichte an einen Arbeitsbereich übermittelt werden1 = Configure the agent to report to a workspace
OPINSIGHTS_WORKSPACE_IDOPINSIGHTS_WORKSPACE_ID Arbeitsbereichs-ID (GUID) für den hinzuzufügenden ArbeitsbereichWorkspace Id (guid) for the workspace to add
OPINSIGHTS_WORKSPACE_KEYOPINSIGHTS_WORKSPACE_KEY Arbeitsbereichsschlüssel, der für die erste Authentifizierung beim Arbeitsbereich verwendet wirdWorkspace key used to initially authenticate with the workspace
OPINSIGHTS_WORKSPACE_AZURE_CLOUD_TYPEOPINSIGHTS_WORKSPACE_AZURE_CLOUD_TYPE Angabe der Cloudumgebung, in der sich der Arbeitsbereich befindetSpecify the cloud environment where the workspace is located
0 = Azure Commercial Cloud (Standard)0 = Azure commercial cloud (default)
1 = Azure Government1 = Azure Government
OPINSIGHTS_PROXY_URLOPINSIGHTS_PROXY_URL URI für den zu verwendenden ProxyURI for the proxy to use
OPINSIGHTS_PROXY_USERNAMEOPINSIGHTS_PROXY_USERNAME Benutzername für den Zugriff auf einen authentifizierten ProxyUsername to access an authenticated proxy
OPINSIGHTS_PROXY_PASSWORDOPINSIGHTS_PROXY_PASSWORD Kennwort für den Zugriff auf einen authentifizierten ProxyPassword to access an authenticated proxy

Hinweis

Um zu vermeiden, dass Sie die Längenbegrenzung der Befehlszeile von IExpress erreichen, installieren Sie den Agent ohne konfigurierten Arbeitsbereich, und verwenden Sie dann ein Skript, um die Konfiguration für den Arbeitsbereich festzulegen.To avoid hitting the command-line length limit of IExpress, install the agent with no workspace configured and then use a script to set configuration for the workspace.

Hinweis

Falls Command line option syntax error. angezeigt wird, wenn Sie den Parameter OPINSIGHTS_WORKSPACE_AZURE_CLOUD_TYPE verwenden, können Sie folgende Problemumgehung verwenden:If you get a Command line option syntax error. when using the OPINSIGHTS_WORKSPACE_AZURE_CLOUD_TYPE parameter, you can use the following workaround:

MMASetup-AMD64.exe /C /T:.\MMAExtract
cd .\MMAExtract
setup.exe /qn ADD_OPINSIGHTS_WORKSPACE=1 OPINSIGHTS_WORKSPACE_AZURE_CLOUD_TYPE=1 OPINSIGHTS_WORKSPACE_ID=<your workspace id> OPINSIGHTS_WORKSPACE_KEY=<your workspace key> AcceptEndUserLicenseAgreement=1

Hinzufügen eines Arbeitsbereichs mithilfe eines SkriptsAdd a workspace using a script

Fügen Sie einen Arbeitsbereich hinzu, indem Sie die Skripting-API des Log Analytics-Agents mit dem folgenden Beispiel verwenden:Add a workspace using the Log Analytics agent scripting API with the following example:

$mma = New-Object -ComObject 'AgentConfigManager.MgmtSvcCfg'
$mma.AddCloudWorkspace($workspaceId, $workspaceKey)
$mma.ReloadConfiguration()

Verwenden Sie das folgende Beispielskript, um einen Arbeitsbereich in Azure für die US-Regierung hinzuzufügen:To add a workspace in Azure for US Government, use the following script sample:

$mma = New-Object -ComObject 'AgentConfigManager.MgmtSvcCfg'
$mma.AddCloudWorkspace($workspaceId, $workspaceKey, 1)
$mma.ReloadConfiguration()

Hinweis

Wenn Sie bereits die Befehlszeile oder Skripts zum Installieren oder Konfigurieren des Agents verwendet haben, sollten Sie wissen, dass EnableAzureOperationalInsights durch AddCloudWorkspace ersetzt wurde.If you've used the command line or script previously to install or configure the agent, EnableAzureOperationalInsights was replaced by AddCloudWorkspace.

Installieren des Agents mithilfe von DSC in Azure AutomationInstall the agent using DSC in Azure Automation

Sie können das folgende Skriptbeispiel verwenden, um den Agent über DSC in Azure Automation zu installieren.You can use the following script example to install the agent using DSC in Azure Automation. Mit diesem Beispiel wird der vom URI-Wert identifizierte 64-Bit-Agent installiert.The example installs the 64-bit agent, identified by the URI value. Sie können auch die 32-Bit-Version installieren, indem Sie den URI-Wert ersetzen.You can also use the 32-bit version by replacing the URI value. Die URIs für beide Versionen lauten:The URIs for both versions are:

Hinweis

Mit diesem Beispielverfahren und -skript wird kein vorhandener Agent aktualisiert.This procedure and script example will not upgrade an existing agent.

  1. Importieren Sie das DSC-Modul xPSDesiredStateConfiguration von http://www.powershellgallery.com/packages/xPSDesiredStateConfiguration in Azure Automation.Import the xPSDesiredStateConfiguration DSC Module from http://www.powershellgallery.com/packages/xPSDesiredStateConfiguration into Azure Automation.
  2. Erstellen Sie Variablenassets in Azure Automation für OPSINSIGHTS_WS_ID und OPSINSIGHTS_WS_KEY.Create Azure Automation variable assets for OPSINSIGHTS_WS_ID and OPSINSIGHTS_WS_KEY. Legen Sie für OPSINSIGHTS_WS_ID Ihre OMS Log Analytics-Arbeitsbereichs-ID und für OPSINSIGHTS_WS_KEY den Primärschlüssel Ihres Arbeitsbereichs fest.Set OPSINSIGHTS_WS_ID to your OMS Log Analytics workspace ID and set OPSINSIGHTS_WS_KEY to the primary key of your workspace.
  3. Verwenden Sie das folgende Skript, und speichern Sie es als MMAgent.ps1Use the following script and save it as MMAgent.ps1
  4. Ändern Sie das folgende Beispiel, und verwenden Sie es dann zur Installation des Agents über DSC in Azure Automation.Modify and then use the following example to install the agent using DSC in Azure Automation. Importieren Sie „MMAgent.ps1“ in Azure Automation über die Azure Automation-Schnittstelle oder das Cmdlet.Import MMAgent.ps1 into Azure Automation by using the Azure Automation interface or cmdlet.
  5. Weisen Sie der Konfiguration einen Knoten zu.Assign a node to the configuration. Innerhalb von 15 Minuten prüft der Knoten die Konfiguration, und der MMA wird per Pushvorgang auf den Knoten übertragen.Within 15 minutes, the node checks its configuration and the MMA is pushed to the node.
Configuration MMAgent
{
    $OIPackageLocalPath = "C:\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

    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 ADD_OPINSIGHTS_WORKSPACE=1 OPINSIGHTS_WORKSPACE_ID=' + $OPSINSIGHTS_WS_ID + ' OPINSIGHTS_WORKSPACE_KEY=' + $OPSINSIGHTS_WS_KEY + ' AcceptEndUserLicenseAgreement=1"'
            DependsOn = "[xRemoteFile]OIPackage"
        }
    }
}

Abrufen des aktuellen ProductId-WertsGet the latest ProductId value

Der ProductId value im Skript „MMAgent.ps1“ ist für jede Agent-Version eindeutig.The ProductId value in the MMAgent.ps1 script is unique to each agent version. Wenn eine aktualisierte Version eines Agents veröffentlicht wird, ändert sich der ProductId-Wert.When an updated version of each agent is published, the ProductId value changes. Wenn sich der ProductId-Wert also künftig ändert, können Sie die Agent-Version mithilfe eines einfachen Skripts suchen.So, when the ProductId changes in the future, you can find the agent version using a simple script. Nachdem Sie die aktuelle Version des Agents auf einem Testserver installiert haben, können Sie mit dem folgenden Skript den ProductId-Wert der Installation abrufen.After you have the latest agent version installed on a test server, you can use the following script to get the installed ProductId value. Mithilfe des aktuellen ProductId-Werts können Sie den Wert im Skript „MMAgent.ps1“ aktualisieren.Using the latest ProductId value, you can update the value in the MMAgent.ps1 script.

$InstalledApplications  = Get-ChildItem hklm:\SOFTWARE\Microsoft\Windows\CurrentVersion\Uninstall


foreach ($Application in $InstalledApplications)

{

     $Key = Get-ItemProperty $Application.PSPath

     if ($Key.DisplayName -eq "Microsoft Monitoring Agent")

     {

        $Key.DisplayName

        Write-Output ("Product ID is: " + $Key.PSChildName.Substring(1,$Key.PSChildName.Length -2))

     }

}  

Manuelles Konfigurieren eines Agents oder Hinzufügen zusätzlicher ArbeitsbereicheConfigure an agent manually or add additional workspaces

Wenn Sie Agents installiert, aber noch nicht konfiguriert haben, oder wenn der Agent Berichte zu mehreren Arbeitsbereichen erstellen soll, können Sie die Agents mithilfe der folgenden Informationen aktivieren oder neu konfigurieren.If you've installed agents but did not configure them or if you want the agent to report to multiple workspaces, you can use the following information to enable an agent or reconfigure it. Nachdem Sie den Agent konfiguriert haben, registriert dieser sich beim Agent-Dienst und ruft die erforderlichen Konfigurationsinformationen und Management Packs ab, die die Lösung enthalten.After you've configured the agent, it will register with the agent service and will get necessary configuration information and management packs that contain solution information.

  1. Öffnen Sie nach der Installation des Microsoft Monitoring Agents die Systemsteuerung.After you've installed the Microsoft Monitoring Agent, open Control Panel.
  2. Öffnen Sie Microsoft Monitoring Agent, und klicken Sie dann auf die Registerkarte Azure Log Analytics (OMS).Open Microsoft Monitoring Agent and then click the Azure Log Analytics (OMS) tab.
  3. Klicken Sie auf Hinzufügen, um das Feld Log Analytics-Arbeitsbereich hinzufügen zu öffnen.Click Add to open the Add a Log Analytics Workspace box.
  4. Fügen Sie die Arbeitsbereichs-ID und den Arbeitsbereichsschlüssel (Primärschlüssel) des Arbeitsbereichs ein, den Sie hinzufügen möchten. (Sie hatten diese Informationen zuvor in Editor kopiert.) Klicken Sie anschließend auf OK.Paste the Workspace ID and Workspace Key (Primary Key) that you copied into Notepad in a previous procedure for the workspace that you want to add and then click OK.
    Operational Insights konfigurierenconfigure Operational Insights

Nachdem die Daten von Computern erfasst wurden, die vom Agent überwacht werden, wird die Anzahl der von OMS überwachten Computer im OMS-Portal auf der Registerkarte Verbundene Datenquellen in den Einstellungen unter Server verbunden angezeigt.After data is collected from computers monitored by the agent, the number of computers monitored by OMS will appear in the OMS portal on the Connected Sources tab in Settings as Servers Connected.

So deaktivieren Sie einen AgentTo disable an agent

  1. Öffnen Sie nach der Installation des Agents die Systemsteuerung.After installing the agent, open Control Panel.
  2. Öffnen Sie Microsoft Monitoring Agent, und klicken Sie dann auf die Registerkarte Azure Log Analytics (OMS) .Open Microsoft Monitoring Agent and then click the Azure Log Analytics (OMS) tab.
  3. Wählen Sie einen Arbeitsbereich aus, und klicken Sie dann auf Entfernen.Select a workspace and then click Remove. Wiederholen Sie diesen Schritt für alle anderen Arbeitsbereiche.Repeat this step for all other workspaces.

Konfigurieren von Agents zum Berichten an eine Operations Manager-Verwaltungsgruppe (optional)Optionally, configure agents to report to an Operations Manager management group

Wenn Sie Operations Manager in Ihrer IT-Infrastruktur verwenden, können Sie auch den MMA-Agent als Operations Manager-Agent nutzen.If you use Operations Manager in your IT infrastructure, you can also use the MMA agent as an Operations Manager agent.

So konfigurieren Sie MMA-Agents zum Berichten an eine Operations Manager-VerwaltungsgruppeTo configure MMA agents to report to an Operations Manager management group

  1. Öffnen Sie auf dem Computer, auf dem der Agent installiert ist, die Systemsteuerung.On the computer where the agent is installed, open Control Panel.
  2. Öffnen Sie Microsoft Monitoring Agent, und klicken Sie dann auf die Registerkarte Operations Manager.Open Microsoft Monitoring Agent and then click the Operations Manager tab.
    Microsoft Monitoring Agent – Registerkarte „Operations Manager“Microsoft Monitoring Agent Operations Manager tab
  3. Wenn Ihre Operations Manager-Server über eine Integration mit Active Directory verfügen, klicken Sie auf Verwaltungsgruppenzuweisungen aus AD DS automatisch aktualisieren.If your Operations Manager servers have integration with Active Directory, click Automatically update management group assignments from AD DS.
  4. Klicken Sie auf Hinzufügen, um das Dialogfeld Verwaltungsgruppe hinzufügen zu öffnen.Click Add to open the Add a Management Group dialog box.
    Microsoft Monitoring Agent – Verwaltungsgruppe hinzufügenMicrosoft Monitoring Agent Add a Management Group
  5. Geben Sie im Feld Verwaltungsgruppenname den Namen Ihrer Verwaltungsgruppe ein.In Management group name box, type the name of your management group.
  6. Geben Sie im Feld Primärer Verwaltungsserver den Computernamen des primären Verwaltungsservers ein.In the Primary management server box, type the computer name of the primary management server.
  7. Geben Sie im Feld Verwaltungsserverport die TCP-Portnummer ein.In the Management server port box, type the TCP port number.
  8. Wählen Sie unter Agentaktionskontodas lokale Systemkonto oder ein lokales Domänenkonto aus.Under Agent Action Account, choose either the Local System account or a local domain account.
  9. Klicken Sie zum Schließen des Dialogfelds Verwaltungsgruppe hinzufügen auf OK. Klicken Sie anschließend zum Schließen des Dialogfelds Eigenschaften von Microsoft Monitoring Agent auf OK.Click OK to close the Add a Management Group dialog box and then click OK to close the Microsoft Monitoring Agent Properties dialog box.

Nächste SchritteNext steps