Windows-agent handmatig installeren met MOMAgent.msi

Belangrijk

Deze versie van Operations Manager heeft het einde van de ondersteuning bereikt. U wordt aangeraden een upgrade uit te voeren naar Operations Manager 2022.

U kunt gebruiken MOMAgent.msi om System Center Operations Manager-agents te implementeren vanaf de opdrachtregel of met behulp van de installatiewizard. De installatie van agents vanaf de opdrachtregel wordt ook wel handmatige installatie genoemd. Zie Microsoft Monitoring Agent System Requirements (Besturingssysteemvereisten voor Microsoft Monitoring Agent) voor een lijst van de ondersteunde besturingssysteemversies.

Voordat u een van deze methoden gebruikt om de agent handmatig te implementeren, controleert u of aan de volgende voorwaarden is voldaan:

  • Het account dat wordt gebruikt om MOMAgent.msi uit te voeren, moet beheerdersbevoegdheden hebben op de computer waarop u de agent installeert.

  • Elke agent die met de wizard Setup of vanaf de opdrachtregel wordt geïnstalleerd, moet door een beheergroep zijn goedgekeurd. Zie Handmatige agentinstallaties verwerken voor meer informatie.

  • Als een agent handmatig op een domeincontroller is geïmplementeerd en het Active Directory management pack later wordt geïmplementeerd, kunnen er fouten optreden tijdens de implementatie van het management pack. Het Active Directory-helperobject wordt gebruikt door het Active Directory management pack op Windows-domeincontrollers. Het helperobject voor het Active Directory management pack wordt doorgaans automatisch geïnstalleerd wanneer de agent met de detectiewizard wordt geïmplementeerd. Om te voorkomen dat er fouten optreden of om te herstellen van fouten die al zijn opgetreden, moet u het Windows Installer-pakket OomADs.msi handmatig installeren op de desbetreffende domeincontroller. Het bestand bevindt zich op de domeincontroller in de map %ProgramFiles%\Microsoft Monitoring Agent\Agent\HelperObjects .

  • Een beheergroep (of één beheerserver) moet worden geconfigureerd om agents te accepteren die zijn geïnstalleerd met MOMAgent.msi, anders worden ze automatisch geweigerd en daarom niet weergegeven in de Operations-console. Zie Handmatige agentinstallaties verwerken voor meer informatie. Als de beheergroep of -server is geconfigureerd voor het accepteren van handmatig geïnstalleerde agents, worden deze agents ongeveer één uur na de handmatige installatie weergegeven in de console.

Notitie

Zie Communicatie tussen agents en beheerservers voor meer informatie over poortvereisten voor agents.

MOMAgent.msi vindt u in het Operations Manager-installatiemedium en in de volgende map op een System Center - Operations Manager-beheerserver %ProgramFiles%\Microsoft System Center 2016\Operations Manager\Server\AgentManagement-platform<>.

MOMAgent.msi vindt u in het installatiemedium van Operations Manager en in de volgende map op een System Center - Operations Manager-beheerserver - %ProgramFiles%\Microsoft System Center\Operations Manager\Server\AgentManagement-platform<>.

Belangrijk

De functie Application Performance Monitoring (APM) in System Center 2016 Operations Manager en versie 1801-agent veroorzaakt een crash met IIS-toepassingsgroepen die worden uitgevoerd onder de runtime .NET Framework 2.0. Wanneer de agent is geïnstalleerd op een Windows-computer, worden de APM-onderdelen standaard geïnstalleerd. Als u problemen wilt voorkomen en de installatie van de APM-onderdelen op windows-doelservers wilt voorkomen wanneer u de agent implementeert, voegt u de NOAPM=true parameter toe

De Operations Manager-agent implementeren met de wizard Agent instellen

Volg deze stappen om de Operations Manager-agent te implementeren met de wizard Agent instellen:

  1. Gebruik lokale beheerdersbevoegdheden om u aan te melden bij de computer waarop u de agent wilt installeren.

  2. Dubbelklik op Setup.exe op de Operations Manager-installatiemedia.

  3. Selecteer in Optionele installatiesde optie Lokale agent.

  4. Op de pagina Welkom selecteert u Volgende.

  5. Bekijk op de pagina Belangrijke kennisgeving de licentievoorwaarden voor Microsoft-software en selecteer Ik ga akkoord.

  6. Laat op de pagina Doelmap de standaardinstelling voor de installatiemap staan of selecteer Wijzigen en typ een pad en selecteer Volgende.

  7. U kunt op de pagina Installatieopties voor agent kiezen of u de agent wilt koppelen aan Operations Manager. Wanneer u de agent aan Operations Manager koppelt, kunt u handmatig de beheergroep kiezen waarin deze agent deelneemt bij het bewaken. Als u deze optie niet selecteert, kan de agent nog steeds gegevens voor bewaking van toepassingsprestaties lokaal verzamelen. U kunt uw selectie wijzigen via het item Monitoring Agent in het Configuratiescherm.

  8. Voer op de pagina Beheergroep configureren de volgende handelingen uit:

    a. Voer de naam van de beheergroep in het veld Naam van beheergroep in en de servernaam (welke server?) in het veld Beheerserver .

    Notitie

    Als u een gatewayserver wilt gebruiken, voert u de naam van de gatewayserver in het tekstvak Beheerserver in.

    b. Voer een waarde in voor Poort van beheerserver of laat de standaardwaarde 5723 staan.

    c. Voer Volgende in.

  9. Laat op de pagina Actieaccount van agent de standaardwaarde Lokaal systeem staan of selecteer Domein of Lokale computeraccount. voer het gebruikersaccount, wachtwoord en domein of lokale computer in; en selecteer Volgende.

  10. Controleer op de pagina Gereed voor installatie de instellingen en selecteer Installeren om de pagina Microsoft Monitoring Agent installeren weer te geven.

  11. Wanneer de pagina Microsoft Monitoring Agent-installatiewizard voltooien wordt weergegeven, selecteert u Voltooien.

De Operations Manager-agent implementeren vanaf de opdrachtregel

Volg deze stappen om de Operations Manager-agent te implementeren vanaf de opdrachtregel:

  1. Meld u aan bij de computer waarop u de agent wilt installeren met behulp van een account met lokale beheerdersbevoegdheden.

  2. Open een opdrachtprompt als beheerder.

  3. Voer de volgende opdracht uit:

    
    %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
    
    

    Notitie

    Zorg ervoor dat u de juiste 32-bits of 64-bits versie van MOMAgent.msi gebruikt voor de computer waarop u de agent installeert.

    Hierbij

    Parameter Waarde
    USE_SETTINGS_FROM_AD={0|1} Hiermee wordt aangegeven waar de eigenschappen van de beheergroep worden ingesteld op de opdrachtregel. Gebruik 0 als u de eigenschappen wilt instellen op de opdrachtregel. Gebruik 1 als u de instellingen van de beheergroep in Active Directory wilt gebruiken.
    USE_MANUALLY_SPECIFIED_SETTINGS=={0|1} Als USE_SETTINGS_FROM_AD=1, moet u USE_MANUALLY_SPECIFIED_SETTINGS instellen op 0.
    MANAGEMENT_GROUP=beheergroepnaam Hiermee geeft u de beheergroep op die de computer beheert.
    MANAGEMENT_SERVER_DNS=beheerservernaam Hiermee geeft u de FQDN-naam (Fully Qualified Domain Name) van de beheerserver op. Als u een gatewayserver wilt gebruiken, geeft u de FQDN van de gatewayserver op als MANAGEMENT_SERVER_DNS.
    MANAGEMENT_SERVER_AD_NAME=AD-naam Gebruik deze parameter als de DNS- en Active Directory-namen van de computer verschillen om de FQDN-naam van Active Directory Domain Services in te stellen.
    SECURE_PORT=poortnummer Hiermee stelt u het poortnummer van de health-service in.
    ENABLE_ERROR_REPORTING={0|1} Optionele parameter. Gebruik deze parameter met 1 om u aan te melden voor het doorsturen van foutenrapport naar Microsoft. Als u deze parameter niet opneemt, wordt de standaardwaarde van de installatie van de agent ingesteld op 0, waardoor het doorsturen van foutenrapport wordt uitgeschakeld.
    QUEUE_ERROR_REPORTS={0|1} Optionele parameter. Gebruik deze parameter met 1 om foutrapporten in de wachtrij te plaatsen of met 0 om rapporten onmiddellijk te verzenden. Als u deze parameter niet opneemt, wordt de installatie van de agent standaard ingesteld op 0.
    INSTALLDIR=pad Optionele parameter. Gebruik deze parameter als u de agent wilt installeren in een andere map dan het standaardinstallatiepad. Houd er rekening mee dat \Agent wordt toegevoegd aan deze waarde.
    ACTIONS_USE_COMPUTER_ACCOUNT={0|1} Hiermee geeft u aan of u een opgegeven gebruikersaccount (0) of het lokale systeemaccount (1) wilt gebruiken.
    ACTIONSUSER=gebruikersnaam Hiermee wordt het actie-account van de agent ingesteld op gebruikersnaam. Deze parameter is vereist als u ACTIONS_USE_COMPUTER_ACCOUNT=0 hebt opgegeven.
    ACTIONSDOMAIN=domeinnaam Hiermee stelt u het domein in voor het actieaccount van de agent dat u opgeeft met de parameter ACTIONSUSER.
    ACTIONSPASSWORD=wachtwoord Hiermee geeft u het wachtwoord op voor de gebruiker die u opgeeft met de parameter ACTIONSUSER.
    NOAPM=1 Optionele parameter. Hiermee wordt de Operations Manager-agent geïnstalleerd zonder bewaking van .NET-toepassingsprestaties. Als u AVIcode 5.7 gebruikt, laat NOAPM=1 de AVIcode-agent staan. Als u AVIcode 5.7 gebruikt en de Operations Manager-agent installeert met behulp van momagent.msi zonder NOAPM=1, werkt de AVIcode-agent niet goed en wordt er een waarschuwing gegenereerd.
    AcceptEndUserLicenseAgreement=1 Hiermee geeft u aan dat u de gebruiksrechtovereenkomst accepteert. Deze parameter is vereist wanneer u /qn gebruikt om een volledig stille installatie van de agent uit te voeren.

Voorbeelden van het installeren van de agent vanaf de opdrachtregel

De volgende voorbeelden tonen verschillende manieren waarop u het Windows Installer-pakket MOMAgent.msi handmatig kunt installeren vanaf de opdrachtregel. U kunt nieuwe agents installeren, agents uit vorige versies van Operations Manager bijwerken, agents verwijderen of de configuratie van een agent wijzigen (zoals de beheergroep of beheerserver die aan de agent is gekoppeld).

Agent installeren met een specifiek actie-account

In het volgende voorbeeld wordt een agent geïnstalleerd met een specifiek actie-account.

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

Agent installeren met het lokale systeemaccount

In het volgende voorbeeld wordt een agent geïnstalleerd met het lokale systeemaccount als actie-account.

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

Agent installeren met Active Directory-integratie en een specifiek actie-account

In het volgende voorbeeld wordt een agent geïnstalleerd met Active Directory en een specifiek actie-account.

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

Agent installeren met Active Directory-integratie en het lokale systeemaccount

In het volgende voorbeeld wordt een agent geïnstalleerd met Active Directory en het lokale systeemaccount als actie-account.

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

Agent van een vorige versie van Operations Manager bijwerken

In het volgende voorbeeld wordt een agent bijgewerkt.

msiexec /i path\Directory\MOMAgent.msi /qn /l*v %temp%\OMAgentUpgrade.log AcceptEndUserLicenseAgreement=1

Agent verwijderen

In het volgende voorbeeld wordt een agent verwijderd.

msiexec /x path\Directory\MOMAgent.msi /qn /l*v %temp%\OMAgentUninstall.log

De agent implementeren met APM uitgeschakeld met Behulp van PowerShell

In het volgende voorbeeld ziet u hoe u de Windows-agent installeert vanuit PowerShell met het onderdeel Application Performance Monitoring (APM) uitgeschakeld.

$PrimaryMS = Get-SCOMManagementServer -Name <MSDNSName>
Install-SCOMAgent -DNSHostName 'ComputerA.contoso.com' -PrimaryManagementServer $PrimaryMS -NoAPM

De agent herstellen en APM uitschakelen met behulp van PowerShell

In het volgende voorbeeld ziet u hoe u de Windows-agent herstelt vanuit PowerShell en het onderdeel Application Performance Monitoring (APM) uitschakelt.

Get-SCOMAgent -DNSHostName "ComputerA.contoso.net" | Repair-SCOMAgent -NoAPM

Volgende stappen