Installieren des Log Analytics-Agents auf Windows-Computern

Mit den folgenden Schritten wird der Log Analytics-Agent in Azure und Azure Government Cloud mithilfe des Setup-Assistenten für den Agent auf Ihrem Computer installiert und konfiguriert. Wenn Sie erfahren möchten, wie Sie den Agent so konfigurieren, dass er auch an eine System Center Operations Manager-Verwaltungsgruppe berichtet, lesen Sie Bereitstellen des Operations Manager-Agents mit dem Agent-Setup-Assistenten.

1. Wählen Sie in Ihrem Log Analytics-Arbeitsbereich auf der Seite Windows-Server, auf die Sie zuvor navigiert sind, die entsprechende Version für Windows-Agent herunterladen aus, um den Download abhängig von der Prozessorarchitektur des Windows-Betriebssystems auszuführen.
2. Führen Sie Setup aus, um den Agent auf Ihrem Computer zu installieren.
3. Klicken Sie auf der Seite Willkommenauf Weiter.
4. Lesen Sie die Seite Lizenzbedingungen durch, und klicken Sie anschließend auf Ich stimme zu.
5. Auf der Seite Zielordner können Sie den Standardinstallationsordner entweder ändern oder beibehalten. Klicken Sie anschließend auf Weiter.
6. Wählen Sie auf der Seite Agent-Setupoptionen aus, dass der Agent mit Azure Log Analytics verbunden werden soll, und klicken Sie dann auf Weiter.
7. Führen Sie auf der Seite Azure Log Analytics Folgendes aus:
   1. Fügen Sie die Arbeitsbereichs-ID und den Arbeitsbereichsschlüssel (Primärschlüssel) ein, die Sie zuvor kopiert haben. Wenn der Computer in einen Log Analytics-Arbeitsbereich in Azure Government Cloud melden soll, wählen Sie Azure US-Regierung aus der Dropdownliste Azure Cloud aus.
   2. Wenn der Computer über einen Proxyserver mit dem Log Analytics-Dienst kommunizieren muss, klicken Sie auf Erweitert, und stellen Sie die URL sowie die Portnummer des Proxyservers bereit. Wenn der Proxyserver eine Authentifizierung erfordert, geben Sie den Benutzernamen und das Kennwort für die Authentifizierung mit dem Proxyserver ein, und klicken Sie dann auf Weiter.
8. Wenn Sie die Bereitstellung der erforderlichen Konfigurationseinstellungen abgeschlossen haben, klicken Sie auf Weiter.
   
   
9. Überprüfen Sie Ihre Auswahl auf der Seite Bereit zum Installieren, und klicken Sie dann auf Installieren.
10. Klicken Sie auf der Seite Die Konfiguration wurde erfolgreich abgeschlossen auf Fertig stellen.

Nach Abschluss wird der Microsoft Monitoring Agent in der Systemsteuerung angezeigt. Informationen zum Überprüfen, ob er Berichte an Log Analytics übermittelt, finden Sie unter Überprüfen der Agent-Konnektivität mit Log Analytics.

Die heruntergeladene Datei für den Agent ist ein eigenständiges Installationspaket. Das Setupprogramm für den Agent und die unterstützenden Dateien sind im Paket enthalten und müssen extrahiert werden, um eine ordnungsgemäße Installation über die in den folgenden Beispielen gezeigte Befehlszeile durchführen zu können.

In der folgenden Tabelle sind die spezifischen Parameter aufgeführt, die im Setup (auch bei der Bereitstellung mit Automation DSC) für den Agent unterstützt werden.

1. Um die Installationsdateien des Agents zu extrahieren, führen Sie an einer Eingabeaufforderung mit erhöhten Rechten MMASetup-<platform>.exe /c aus. Sie werden nach dem Pfad gefragt, in den die Dateien extrahiert werden sollen. Alternativ können Sie den Pfad angeben, indem Sie die Argumente MMASetup-<platform>.exe /c /t:<Full Path> übergeben.

2. Für die automatische Installation des Agents und seine Konfiguration zum Übermitteln von Berichten an einen Arbeitsbereich in der kommerziellen Azure-Cloud extrahieren Sie die Setupdateien aus dem Ordner und geben Folgendes ein:

   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
   

   Zum Konfigurieren des Agents zum Übermitteln von Berichten an die Azure US Government-Cloud geben Sie Folgendes ein:

   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
   

   Oder um den Agenten so zu konfigurieren, dass er an Microsoft Azure, betrieben von 21Vianet Cloud berichtet, geben Sie Folgendes ein:

   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
   

   Hinweis

   Die Zeichenfolgenwerte für die Parameter OPINSIGHTS_WORKSPACE_ID und OPINSIGHTS_WORKSPACE_KEY müssen in doppelte Anführungszeichen gesetzt werden, damit Windows Installer angewiesen wird, diese als gültige Optionen für das Paket zu interpretieren.

Sie können das folgende Skriptbeispiel verwenden, um den Agent mit Azure Automation DSC zu installieren. Wenn Sie über kein Automation-Konto verfügen, finden Sie unter Erste Schritte mit Azure Automation Informationen zu den Anforderungen und Schritten zum Erstellen eines Automation-Kontos, die vor der Verwendung von Automation DSC erforderlich sind. Wenn Sie nicht mit Automation DSC vertraut sind, finden Sie entsprechende Informationen unter Erste Schritte mit Azure Automation DSC.

Im folgenden Beispiel wird der vom URI-Wert identifizierte 64-Bit-Agent installiert. Sie können auch die 32-Bit-Version installieren, indem Sie den URI-Wert ersetzen. Die URIs für beide Versionen lauten:

• Windows-64-Bit-Agent:https://go.microsoft.com/fwlink/?LinkId=828603
• Windows-32-Bit-Agent:https://go.microsoft.com/fwlink/?LinkId=828604

Die 32-Bit- und die 64-Bit-Version des Agent-Pakets weisen unterschiedliche Produktcodes auf. Auch neu veröffentlichten Versionen ist ein eindeutiger Wert zugewiesen. Der Produktcode ist eine GUID, die als hauptsächliche Identifikation einer Anwendung oder eines Produkts dient und durch die Windows Installer-Eigenschaft ProductCode angegeben wird. Der Wert ProductId im Skript MMAgent.ps1 muss mit dem Produktcode aus dem Installationspaket für den 32-Bit- oder 64-Bit-Agent übereinstimmen.

Den Produktcode können Sie mithilfe von „Orca.exe“ aus Windows SDK Components for Windows Installer Developers, bei dem es sich um eine Komponente des Windows Software Development Kit handelt, oder über PowerShell entsprechend einem von einem MVP (Microsoft Valuable Professional) geschriebenen Beispielskript direkt aus dem Installationspaket für den Agent abrufen. Bei beiden Vorgehensweisen müssen Sie zunächst die Datei MOMagent.msi aus dem MMASetup-Installationspaket extrahieren, wie im ersten Schritt der Anleitung zur Installation des Agents über die Befehlszeile erläutert.

1. Importieren Sie das DSC-Modul „xPSDesiredStateConfiguration“ aus https://www.powershellgallery.com/packages/xPSDesiredStateConfiguration in Azure Automation.

2. Erstellen Sie Variablenassets in Azure Automation für OPSINSIGHTS_WS_ID und OPSINSIGHTS_WS_KEY. Legen Sie für OPSINSIGHTS_WS_ID Ihre Log Analytics-Arbeitsbereichs-ID und für OPSINSIGHTS_WS_KEY den Primärschlüssel Ihres Arbeitsbereichs fest.

3. Kopieren Sie das Skript, und speichern Sie es unter „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. Aktualisieren Sie den Wert ProductId im Skript mithilfe der zuvor empfohlenen Methoden mit dem Produktcode, den Sie aus der neuesten Version des Agent-Installationspakets extrahiert haben.

5. Importieren Sie das Konfigurationsskript „MMAgent.ps1“ in Ihr Automation-Konto.

6. Weisen Sie einen Windows-Computer oder -Knoten der Konfiguration hinzu. Innerhalb von 15 Minuten prüft der Knoten die Konfiguration, und der Agent wird auf den Knoten gepusht.