Rozwiązywanie problemów z agentem usługi Log Analytics dla systemu Windows

2025-04-18

Ten artykuł zawiera pomoc w rozwiązywaniu problemów z błędami, które mogą wystąpić w przypadku agenta usługi Log Analytics dla systemu Windows w usłudze Azure Monitor i sugeruje możliwe rozwiązania ich rozwiązywania.

Narzędzie do rozwiązywania problemów z usługą Log Analytics

Agent usługi Log Analytics dla narzędzia do rozwiązywania problemów z systemem Windows to kolekcja skryptów programu PowerShell, które ułatwiają znajdowanie i diagnozowanie problemów z agentem usługi Log Analytics. Jest on automatycznie dołączany do agenta podczas instalacji. Uruchomienie narzędzia powinno być pierwszym krokiem w diagnozowaniu problemu.

Korzystanie z narzędzia do rozwiązywania problemów

Otwórz wiersz polecenia programu PowerShell jako administrator na maszynie, na której zainstalowano agenta usługi Log Analytics.
Przejdź do katalogu, w którym znajduje się narzędzie:

cd "C:\Program Files\Microsoft Monitoring Agent\Agent\Troubleshooter"
Wykonaj skrypt główny przy użyciu tego polecenia:

.\GetAgentInfo.ps1
Wybierz scenariusz rozwiązywania problemów.
Postępuj zgodnie z instrukcjami na konsoli. Należy pamiętać, że kroki śledzenia dzienników wymagają ręcznej interwencji w celu zatrzymania zbierania dzienników. Jeśli problem się powtarza, odczekaj określony czas i wybierz "s", aby zatrzymać zapis i przejść do następnego kroku.

Lokalizacja pliku wyników jest rejestrowana po zakończeniu, a nowe okno eksploratora otwiera się, podświetlając je.

Instalacja

Narzędzie do rozwiązywania problemów jest automatycznie uwzględniane podczas instalacji agenta usługi Log Analytics w wersji 10.20.18053.0 i nowszej.

Objęte scenariusze

Narzędzie do rozwiązywania problemów sprawdza następujące scenariusze:

Agent nie zgłasza danych ani brakuje danych pulsu.
Wdrożenie rozszerzenia agenta kończy się niepowodzeniem.
Agent ulega awarii.
Agent zużywa dużo procesora CPU lub pamięci.
Problemy związane z instalacją i dezinstalacją.
Dzienniki niestandardowe mają problemy.
Brama OMS ma problemy.
Liczniki wydajności mają problemy.
Nie można zbierać dzienników agentów.

Uwaga

Uruchom narzędzie do rozwiązywania problemów, gdy wystąpi problem. Pierwsze dzienniki pomogą naszemu zespołowi pomocy technicznej w szybszym rozwiązywaniu problemu.

Ważne źródła rozwiązywania problemów

Aby ułatwić rozwiązywanie problemów związanych z agentem usługi Log Analytics dla systemu Windows, agent rejestruje zdarzenia w dzienniku zdarzeń systemu Windows, w szczególności w obszarze Aplikacja i usługi\Operations Manager.

Problemy z połączeniem

Jeśli agent komunikuje się za pośrednictwem serwera proxy lub zapory, ograniczenia mogą uniemożliwiać komunikację z komputera źródłowego i usługi Azure Monitor. Jeśli komunikacja jest zablokowana z powodu nieprawidłowej konfiguracji, rejestracja w obszarze roboczym może zakończyć się niepowodzeniem podczas próby zainstalowania agenta lub skonfigurowania agenta po konfiguracji w celu raportowania do innego obszaru roboczego. Komunikacja z agentem może zakończyć się niepowodzeniem po pomyślnej rejestracji. W tej sekcji opisano metody rozwiązywania tego typu problemów z agentem systemu Windows.

Sprawdź dokładnie, czy zapora lub serwer proxy jest skonfigurowana tak, aby zezwalała na następujące porty i adresy URL opisane w poniższej tabeli. Upewnij się również, że inspekcja HTTP nie jest włączona dla ruchu internetowego. Może to uniemożliwić bezpieczny kanał TLS między agentem a usługą Azure Monitor.

Zasób agenta	Porty	Kierunek	Pomijanie inspekcji HTTPS
*.ods.opinsights.azure.com	Port 443	Wychodzące	Tak
*.oms.opinsights.azure.com	Port 443	Wychodzące	Tak
*.blob.core.windows.net	Port 443	Wychodzące	Tak
*.agentsvc.azure-automation.net	Port 443	Wychodzące	Tak

Aby uzyskać informacje o zaporze wymagane dla platformy Azure Government, zobacz Zarządzanie platformą Azure Government. Jeśli planujesz używać hybrydowego agenta Runbook usługi Azure Automation do nawiązywania połączenia i rejestrowania w usłudze Automation, aby korzystać z Runbooków lub rozwiązań do zarządzania w swoim środowisku, musi on mieć dostęp do numerów portów i adresów URL opisanych w Konfigurowanie sieci dla hybrydowego agenta Runbook.

Istnieje kilka sposobów sprawdzania, czy agent pomyślnie komunikuje się z usługą Azure Monitor:

Włącz ocenę kondycji agenta usługi Azure Log Analytics w obszarze roboczym. Na panelu Kondycja agenta sprawdź kolumnę Liczba nieodpowiadających agentów, aby szybko zobaczyć, czy agent jest wymieniony.
Uruchom następujące zapytanie, aby potwierdzić, że agent wysyła puls do obszaru roboczego skonfigurowanego do raportowania. Zastąp <ComputerName> rzeczywistą nazwą maszyny.
```
Heartbeat 
| where Computer like "<ComputerName>"
| summarize arg_max(TimeGenerated, * ) by Computer 
```
Jeśli komputer pomyślnie komunikuje się z usługą, zapytanie powinno zwrócić wynik. Jeśli zapytanie nie zwróciło wyniku, najpierw sprawdź, czy agent jest skonfigurowany do raportowania do poprawnego obszaru roboczego. Jeśli jest poprawnie skonfigurowany, przejdź do kroku 3 i wyszukaj dziennik zdarzeń systemu Windows, aby sprawdzić, czy agent rejestruje problem, który może uniemożliwić komunikację z usługą Azure Monitor.
Inną metodą identyfikowania problemu z łącznością jest uruchomienie narzędzia TestCloudConnectivity . Narzędzie jest instalowane domyślnie z agentem w folderze %SystemRoot%\Program Files\Microsoft Monitoring Agent\Agent. W wierszu polecenia z podwyższonym poziomem uprawnień przejdź do folderu i uruchom narzędzie. Narzędzie zwróci wyniki i wskaże, gdzie test nie powiódł się. Na przykład być może był on związany z określonym portem lub adresem URL, który został zablokowany.

Filtruj dziennik zdarzeń programu Operations Manager według źródeł zdarzeń: Moduły Usługi Zdrowia, HealthService i Łącznik Usługi, oraz według poziomu zdarzeń: Ostrzeżenie i Błąd, aby sprawdzić, czy zostały zapisane zdarzenia z poniższej tabeli. Jeśli tak jest, zapoznaj się z krokami rozwiązywania uwzględnionych dla każdego możliwego zdarzenia.

Identyfikator zdarzenia	Źródło	opis	Rozwiązanie
2133 i 2129	Służba zdrowia	Połączenie z usługą przez agenta nie powiodło się.	Ten błąd może wystąpić, gdy agent nie może komunikować się bezpośrednio lub przez zaporę lub serwer proxy do usługi Azure Monitor. Sprawdź ustawienia proxy agenta lub upewnij się, że zapora sieciowa lub proxy zezwala na ruch TCP z komputera do usługi.
2138	moduły Usług Zdrowotnych	Serwer proxy wymaga uwierzytelniania.	Skonfiguruj ustawienia serwera proxy agenta i określ nazwę użytkownika/hasło wymagane do uwierzytelnienia na serwerze proxy.
2129	moduły Usług Zdrowotnych	Połączenie nie powiodło się. Nieudane negocjacje TLS.	Sprawdź ustawienia TCP/IP w karcie sieciowej oraz ustawienia proxy agenta.
2127	moduły Usług Zdrowotnych	Wystąpił błąd podczas wysyłania danych, otrzymano kod błędu.	Jeśli dzieje się to okresowo w ciągu dnia, może to być przypadkowa anomalia, którą można zignorować. Monitoruj, aby zrozumieć, jak często się dzieje. Jeśli dzieje się to często przez cały dzień, najpierw sprawdź konfigurację sieci i ustawienia serwera proxy. Jeśli opis zawiera kod błędu HTTP 404 i po raz pierwszy agent próbuje wysłać dane do usługi, będzie zawierać błąd 500 z wewnętrznym kodem błędu 404. Kod błędu 404 oznacza "nie znaleziono", co oznacza, że obszar magazynowania dla nowego obszaru roboczego jest nadal aprowizowany. Po następnej próbie dane zostaną pomyślnie zapisane w obszarze roboczym zgodnie z oczekiwaniami. Błąd HTTP 403 może wskazywać na problem z uprawnieniami lub poświadczeniami. Z błędem 403 dołączone są dodatkowe informacje, które mogą pomóc w rozwiązaniu problemu.
4000	Łącznik serwisowy	Rozpoznawanie nazw DNS nie powiodło się.	Maszyna nie może rozpoznać adresu internetowego używanego podczas wysyłania danych do usługi. Ten problem może dotyczyć ustawień programu rozpoznawania nazw DNS na maszynie, nieprawidłowych ustawień serwera proxy lub tymczasowego problemu z systemem DNS u dostawcy. Jeśli występuje okresowo, może to być spowodowane przejściowym problemem związanym z siecią.
4001	Łącznik serwisowy	Połączenie z usługą nie powiodło się.	Ten błąd może wystąpić, gdy agent nie może komunikować się bezpośrednio lub przez zaporę lub serwer proxy do usługi Azure Monitor. Sprawdź ustawienia proxy agenta lub upewnij się, że zapora sieciowa lub proxy zezwala na ruch TCP z komputera do usługi.
4002	Łącznik serwisowy	Usługa zwróciła kod stanu HTTP 403 w odpowiedzi na zapytanie. Zapoznaj się z administratorem usługi pod kątem kondycji usługi. Zapytanie zostanie ponowione później.	Ten błąd jest zapisywany podczas początkowej fazy rejestracji agenta. Zobaczysz adres URL podobny do https://<workspaceID>.oms.opinsights.azure.com/AgentService.svc/AgentTopologyRequest. Kod błędu 403 oznacza "zabronione" i może być spowodowany błędnie wtypowanym identyfikatorem lub kluczem obszaru roboczego. Data i godzina mogą być również niepoprawne na komputerze. Jeśli czas jest +/- 15 minut w stosunku do bieżącego czasu, proces wdrażania kończy się niepowodzeniem. Aby rozwiązać ten problem, zaktualizuj datę i/lub godzinę komputera z systemem Windows.

Problemy z zbieraniem danych

Po zainstalowaniu agenta i jego raportowaniu do skonfigurowanego obszaru roboczego lub obszarów roboczych, agent może przestać odbierać konfiguracje, zbierać lub przesyłać dane dotyczące wydajności, dzienników lub innych danych do usługi, w zależności od tego, które funkcje są włączone i przeznaczone dla danego komputera. Musisz określić:

Czy jest to określony typ danych, czy wszystkie dane, które nie są dostępne w obszarze roboczym?
Czy typ danych jest określony przez rozwiązanie, czy określony jako część konfiguracji zbierania danych obszaru roboczego?
Ilu komputerów dotyczy problem? Czy jest to jeden komputer, czy wiele komputerów raportujących do obszaru roboczego?
Czy to działało i zatrzymało się o określonej porze dnia, czy nigdy tego nie zbierano?
Czy zapytanie przeszukiwania dzienników, którego używasz, jest poprawne syntaktycznie?
Czy agent kiedykolwiek otrzymał konfigurację z usługi Azure Monitor?

Pierwszym krokiem rozwiązywania problemów jest ustalenie, czy komputer wysyła zdarzenie pulsu.

Heartbeat 
    | where Computer like "<ComputerName>"
    | summarize arg_max(TimeGenerated, * ) by Computer

Jeśli zapytanie zwraca wyniki, należy określić, czy określony typ danych nie jest zbierany i przekazywany do usługi. Ten problem może być spowodowany tym, że agent nie otrzymuje zaktualizowanej konfiguracji z usługi lub inny objaw uniemożliwiający normalne działanie agenta. Wykonaj poniższe kroki, aby kontynuować rozwiązywanie problemów.

Otwórz wiersz polecenia z podwyższonym poziomem uprawnień na komputerze i uruchom ponownie usługę agenta, wprowadzając polecenie net stop healthservice && net start healthservice.
Otwórz dziennik zdarzeń programu Operations Manager i wyszukaj identyfikatory zdarzeń 7023, 7024, 7025, 7028 i 1210 ze źródłazdarzeń HealthService. Te zdarzenia wskazują, że agent pomyślnie odbiera konfigurację z usługi Azure Monitor i aktywnie monitoruje komputer. Opis zdarzenia o identyfikatorze 1210 również określi w ostatnim wierszu wszystkie rozwiązania i szczegółowe informacje uwzględnione w zakresie monitorowania agenta.

Poczekaj kilka minut. Jeśli oczekiwane dane nie są widoczne w wynikach zapytania lub wizualizacji, w zależności od tego, czy przeglądasz dane z rozwiązania czy analiz Insight, w dzienniku zdarzeń programu Operations Manager wyszukaj Źródła zdarzeńHealthService oraz Moduły usługi zdrowia. Filtruj według poziomu zdarzeniaostrzeżenia i błędu, aby sprawdzić, czy wydarzenia z poniższej tabeli zostały zapisane.

Identyfikator zdarzenia	Źródło	opis	Rozwiązanie
osiem tysięcy	Usługa Zdrowotna	To zdarzenie określi, czy przepływ pracy związany z wydajnością, zdarzeniem lub innym typem zebranych danych nie może zostać przesłany do usługi w celu przetworzenia na przestrzeń roboczą.	Identyfikator zdarzenia 2136 ze źródłowej usługi HealthService jest zapisywany razem z tym zdarzeniem i może wskazywać, że agent nie może komunikować się z usługą. Możliwe przyczyny to błędna konfiguracja ustawień serwera proxy i uwierzytelniania, awaria sieci, albo zapora sieciowa lub serwer proxy, które nie zezwalają na ruch TCP z komputera do usługi.
10102 i 10103	moduły Usług Zdrowotnych	Przepływ pracy nie może rozpoznać źródła danych.	Ten problem może wystąpić, jeśli określony licznik wydajności lub wystąpienie nie istnieje na komputerze lub jest niepoprawnie zdefiniowane w ustawieniach danych obszaru roboczego. Jeśli jest to licznik wydajności określony przez użytkownika, sprawdź, czy określone informacje są zgodne z poprawnym formatem i istnieją na komputerach docelowych.
26002	moduły Usług Zdrowotnych	Przepływ pracy nie może rozpoznać źródła danych.	Ten problem może wystąpić, jeśli określony dziennik zdarzeń systemu Windows nie istnieje na komputerze. Ten błąd można bezpiecznie zignorować, jeśli komputer nie ma zarejestrowanego tego dziennika zdarzeń. W przeciwnym razie, jeśli jest to dziennik zdarzeń określony przez użytkownika, sprawdź, czy podane informacje są poprawne.

Problemy z zablokowanymi certyfikatami w starszych agentach monitorowania firmy Microsoft — zmiana łamiąca kompatybilność

Omówienie zmiany Urzędu Certyfikacji Root

Od 30 czerwca 2023 r. zaplecze Log Analytics nie będzie już akceptować połączeń z MMA odwołujących się do przestarzałego certyfikatu głównego. Te wersje MMA są starsze niż wersja Winter 2020 (Agent usługi Log Analytics) i starsze niż SCOM 2019 UR3 (SCOM). Dowolna wersja, Pakiet: 10.20.18053 / Rozszerzenie: 1.0.18053.0 lub nowsza nie będzie mieć żadnych problemów, a także żadnej wersji powyżej SCOM 2019 UR3. Każdy agent starszy niż ten przestanie działać i przekazywać dane do usługi Log Analytics.

Co dokładnie się zmienia?

W ramach ciągłych działań związanych z bezpieczeństwem w różnych usługach platformy Azure usługa Azure Log Analytics oficjalnie zmieni się z Katalogu głównego urzędu certyfikacji Baltimore CyberTrust na katalog główny urzędu certyfikacji DigiCert Global G2. Ta zmiana wpłynie na komunikację TLS z usługą Log Analytics, jeśli w systemie operacyjnym brakuje nowego certyfikatu głównego urzędu certyfikacji Global G2 firmy DigiCert lub aplikacja odwołuje się do starego głównego urzędu certyfikacji Baltimore. Oznacza to, że usługa Log Analytics nie będzie już akceptować połączeń z programu MMA, które używają tego starego głównego urzędu certyfikacji po wycofaniu.

Produkty rozwiązań

Możliwe, że otrzymałeś powiadomienie o zmianie w oprogramowaniu, nawet jeśli sam nie zainstalowałeś programu Microsoft Monitoring Agent. Dzieje się tak, ponieważ różne produkty platformy Azure korzystają z programu Microsoft Monitoring Agent. Jeśli używasz jednego z tych produktów, możesz być dotknięty, ponieważ korzystają z agenta do analizy dzienników systemu Windows. W przypadku produktów z linkami poniżej mogą istnieć konkretne instrukcje, które będą wymagały uaktualnienia do najnowszego agenta.

Analiza maszyn wirtualnych
System Center Operations Manager (SCOM)
System Center Service Manager (SCSM)
Microsoft Defender for Server
Ochrona punktu końcowego w usłudze Microsoft Defender
Azure Sentinel
Hybrydowy proces roboczy oparty na agencie usługi Azure Automation
Śledzenie zmian i spis usługi Azure Automation
Azure Automation — Update Management

Identyfikowanie i naprawa czynników powodujących zakłócenia

W przypadku wdrożeń z ograniczoną liczbą agentów zdecydowanie zalecamy zaktualizowanie agenta na każdym węźle za pomocą tych instrukcji zarządzania.

W przypadku wdrożeń z wieloma węzłami napisaliśmy skrypt, który wykryje wszelkie naruszenia MMA w ramach subskrypcji, a następnie uaktualni je do najnowszej wersji. Te skrypty muszą być uruchamiane sekwencyjnie, począwszy od updateMMA.ps1, a następnie UpgradeMMA.ps1. W zależności od maszyny skrypt może chwilę potrwać. Aby uniknąć przekroczenia limitu czasu, wymagany jest program PowerShell 7 lub nowszy.

UpdateMMA.ps1 Ten skrypt będzie przeglądać maszyny wirtualne w Twoich subskrypcjach, sprawdzać zainstalowane istniejące MMAs oraz wygenerować plik .csv z listą agentów wymagających uaktualnienia.

UpgradeMMA.ps1 Ten skrypt będzie używać pliku .CSV wygenerowanego w UpdateMMA.ps1, aby zaktualizować wszystkie skrypty MMA wymagające aktualizacji.

Ukończenie obu tych skryptów może trochę potrwać.

UpdateMMA
Uaktualnianie programuMMA

# UpdateMMA.ps1
# This script is to be run per subscription, the customer has to set the az subscription before running this within the terminal scope.
# This script uses parallel processing, modify the $parallelThrottleLimit parameter to either increase or decrease the number of parallel processes
# PS> .\UpdateMMA.ps1 GetInventory
# The above command will generate a csv file with the details of VM's and VMSS that require MMA upgrade. 
# The customer can modify the csv by adding/removing rows if needed
# Update the MMA by running the script again and passing the csv file as parameter as shown below:
# PS> .\UpdateMMA.ps1 Upgrade
# If you don't want to check the inventory, then run the script wiht an additional -no-inventory-check
# PS> .\UpdateMMA.ps1 GetInventory & .\UpdateMMA.ps1 Upgrade


# This version of the script requires Powershell version >= 7 in order to improve performance via ForEach-Object -Parallel
# https://docs.microsoft.com/powershell/scripting/whats-new/migrating-from-windows-powershell-51-to-powershell-7?view=powershell-7.1
if ($PSVersionTable.PSVersion.Major -lt 7) 
{
    Write-Host "This script requires Powershell version 7 or newer to run. Please see https://docs.microsoft.com/powershell/scripting/whats-new/migrating-from-windows-powershell-51-to-powershell-7?view=powershell-7.1."
    exit 1
}

$parallelThrottleLimit = 16
$mmaFixVersion = [version]"10.20.18053.0"

function GetVmsWithMMAInstalled
{
    param(
        $fileName
    )

    $vmList = az vm list --show-details --query "[?powerState=='VM running'].{ResourceGroup:resourceGroup, VmName:name}" | ConvertFrom-Json
    
    if(!$vmList)
    {
        Write-Host "Cannot get the VM list, this script can only detect the running VM's"
        return
    }

    $vmsCount = $vmList.Length
    
    $vmParallelThrottleLimit = $parallelThrottleLimit
    if ($vmsCount -lt $vmParallelThrottleLimit) 
    {
        $vmParallelThrottleLimit = $vmsCount
    }

    if($vmsCount -eq 1)
    {
        $vmGroups += ,($vmList[0])
    }
    else
    {
        # split the vm's into batches to do parallel processing
        for ($i = 0; $i -lt $vmsCount; $i += $vmParallelThrottleLimit) 
        { 
            $vmGroups += , ($vmList[$i..($i + $vmParallelThrottleLimit - 1)]) 
        }
    }

    Write-Host "Detected $vmsCount Vm's running in this subscription."
    $hash = [hashtable]::Synchronized(@{})
    $hash.One = 1

    $vmGroups | Foreach-Object -ThrottleLimit $parallelThrottleLimit -Parallel {
        $len = $using:vmsCount
        $hash = $using:hash
        $_ | ForEach-Object {
            $percent = 100 * $hash.One++ / $len
            Write-Progress -Activity "Getting VM Inventory" -PercentComplete $percent
            $vmName = $_.VmName
            $resourceGroup = $_.ResourceGroup
            $responseJson = az vm run-command invoke --command-id RunPowerShellScript --name $vmName -g $resourceGroup --scripts '@UpgradeMMA.ps1' --parameters "functionName=GetMMAVersion" --output json | ConvertFrom-Json
            if($responseJson)
            {
                $mmaVersion = $responseJson.Value[0].message
                if ($mmaVersion) 
                {
                    $extensionName = az vm extension list -g $resourceGroup --vm-name $vmName --query "[?name == 'MicrosoftMonitoringAgent'].name" | ConvertFrom-Json
                    if ($extensionName) 
                    {
                        $installType = "Extension"
                    }
                    else 
                    {
                        $installType = "Installer"
                    }
                    $csvObj = New-Object -TypeName PSObject -Property @{
                        'Name'           = $vmName
                        'Resource_Group' = $resourceGroup
                        'Resource_Type'  = "VM"
                        'Install_Type'   = $installType
                        'Version'        = $mmaVersion
                        "Instance_Id"    = ""
                    }
                    $csvObj | Export-Csv $using:fileName -Append -Force
                } 
            } 
        }
    }
}

function GetVmssWithMMAInstalled
{
    param(
        $fileName
    )

    # get the vmss list which are successfully provisioned
    $vmssList = az vmss list --query "[?provisioningState=='Succeeded'].{ResourceGroup:resourceGroup, VmssName:name}" | ConvertFrom-Json   

    $vmssCount = $vmssList.Length
    Write-Host "Detected $vmssCount Vmss running in this subscription."
    $hash = [hashtable]::Synchronized(@{})
    $hash.One = 1

    $vmssList | Foreach-Object -ThrottleLimit $parallelThrottleLimit -Parallel {
        $len = $using:vmssCount
        $hash = $using:hash
        $percent = 100 * $hash.One++ / $len
        Write-Progress -Activity "Getting VMSS Inventory" -PercentComplete $percent
        $vmssName = $_.VmssName
        $resourceGroup = $_.ResourceGroup

        # get running vmss instance ids
        $vmssInstanceIds = az vmss list-instances --resource-group $resourceGroup --name $vmssName --expand instanceView --query "[?instanceView.statuses[1].displayStatus=='VM running'].instanceId" | ConvertFrom-Json
        if ($vmssInstanceIds.Length -gt 0) 
        {
            $isMMAExtensionInstalled = az vmss extension list -g $resourceGroup --vmss-name $vmssName --query "[?name == 'MicrosoftMonitoringAgent'].name" | ConvertFrom-Json
            if ($isMMAExtensionInstalled ) 
            {
                # check an instance in vmss, if it needs an MMA upgrade. Since the extension is installed at VMSS level, checking for bad version in 1 instance should be fine.
                $responseJson = az vmss run-command invoke --command-id RunPowerShellScript --name $vmssName -g $resourceGroup --instance-id $vmssInstanceIds[0] --scripts '@UpgradeMMA.ps1' --parameters "functionName=GetMMAVersion" --output json | ConvertFrom-Json
                $mmaVersion = $responseJson.Value[0].message
                if ($mmaVersion) 
                {
                    $csvObj = New-Object -TypeName PSObject -Property @{
                        'Name'           = $vmssName
                        'Resource_Group' = $resourceGroup
                        'Resource_Type'  = "VMSS"
                        'Install_Type'   = "Extension"
                        'Version'        = $mmaVersion
                        "Instance_Id"    = ""
                    }
                    $csvObj | Export-Csv $using:fileName -Append -Force
                }
            }
            else 
            {
                foreach ($instanceId in $vmssInstanceIds) 
                {
                    $responseJson = az vmss run-command invoke --command-id RunPowerShellScript --name $vmssName -g $resourceGroup --instance-id $instanceId --scripts '@UpgradeMMA.ps1' --parameters "functionName=GetMMAVersion" --output json | ConvertFrom-Json
                    $mmaVersion = $responseJson.Value[0].message
                    if ($mmaVersion) 
                    {
                        $csvObj = New-Object -TypeName PSObject -Property @{
                            'Name'           = $vmssName
                            'Resource_Group' = $resourceGroup
                            'Resource_Type'  = "VMSS"
                            'Install_Type'   = "Installer"
                            'Version'        = $mmaVersion
                            "Instance_Id"    = $instanceId
                        }
                        $csvObj | Export-Csv $using:fileName -Append -Force
                    }
                }
            }
        }      
    }
}

function Upgrade
{
    param(
        $fileName = "MMAInventory.csv"
    )
    Import-Csv $fileName | ForEach-Object -ThrottleLimit $parallelThrottleLimit -Parallel {
        $mmaVersion = [version]$_.Version
        if($mmaVersion -lt $using:mmaFixVersion)
        {
            if ($_.Install_Type -eq "Extension") 
            {
                if ($_.Resource_Type -eq "VMSS") 
                {
                    # if the extension is installed with a custom name, provide the name using the flag: --extension-instance-name <extension name>
                    az vmss extension set --name MicrosoftMonitoringAgent --publisher Microsoft.EnterpriseCloud.Monitoring --force-update --vmss-name $_.Name --resource-group $_.Resource_Group --no-wait --output none
                }
                else 
                {
                    # if the extension is installed with a custom name, provide the name using the flag: --extension-instance-name <extension name>
                    az vm extension set --name MicrosoftMonitoringAgent --publisher Microsoft.EnterpriseCloud.Monitoring --force-update --vm-name $_.Name --resource-group $_.Resource_Group --no-wait --output none
                }
            }
            else {
                if ($_.Resource_Type -eq "VMSS") 
                {
                    az vmss run-command invoke --command-id RunPowerShellScript --name $_.Name -g $_.Resource_Group --instance-id $_.Instance_Id --scripts '@UpgradeMMA.ps1' --parameters "functionName=UpgradeMMA" --output none
                }
                else 
                {
                    az vm run-command invoke --command-id RunPowerShellScript --name $_.Name -g $_.Resource_Group --scripts '@UpgradeMMA.ps1' --parameters "functionName=UpgradeMMA" --output none
                }
            }
        }
    }
}

function GetInventory
{
    param(
        $fileName = "MMAInventory.csv"
    )

    # create a new file 
    New-Item -Name $fileName -ItemType File -Force
    GetVmsWithMMAInstalled $fileName
    GetVmssWithMMAInstalled $fileName
}

switch ($args.Count)
{
    0 {
        Write-Host "The arguments provided are incorrect."
        Write-Host "To get the Inventory: Run the script as: PS> .\UpdateMMA.ps1 GetInventory"
        Write-Host "To update MMA from Inventory: Run the script as: PS> .\UpdateMMA.ps1 Upgrade"
        Write-Host "To do the both steps together: PS> .\UpdateMMA.ps1 GetInventory & .\UpdateMMA.ps1 Upgrade"
    }
    1 {
        $funcname = $args[0]
        Invoke-Expression "& $funcname"
    }
    2 {
        $funcname = $args[0]
        $funcargs = $args[1]
        Invoke-Expression "& $funcname $funcargs"
    }
}

#UpgradeMMA.ps1

param(
    $functionName
)

$mmaLatestVersion32bitDownloadUrl = "https://go.microsoft.com/fwlink/?LinkId=828604"
$mmaLatestVersion64bitDownloadUrl = "https://go.microsoft.com/fwlink/?LinkId=828603"
$mmaName = 'Microsoft Monitoring Agent'
$mmaFixVersion = [version]"10.20.18053.0"
$regPath = 'HKLM:\Software\Microsoft\Windows\CurrentVersion\Uninstall\*'

function GetMMAVersion
{
    $mmaVersion = (Get-ItemProperty $regPath | Where-Object { $_.DisplayName -eq $mmaName }).DisplayVersion
    return $mmaVersion
}

function MMAUpgradeRequirementCheck
{
    $mmaVersion = [version](GetMMAVersion)
    if ($mmaVersion -and ($mmaVersion -lt $mmaFixVersion)) 
    {
        return $TRUE
    }
    return $FALSE
}

function GetMMAUpgradeUrl
{
    $osArchitecture = (Get-WmiObject Win32_OperatingSystem).OSArchitecture
    if ($osArchitecture -eq "64-bit") 
    {
        $newMMADownloadUrl = $mmaLatestVersion64bitDownloadUrl
    }
    else 
    {
        $newMMADownloadUrl = $mmaLatestVersion32bitDownloadUrl
    }
        
    return $newMMADownloadUrl
}

function UpgradeMMA
{
    $mmaUpgradeRequired = MMAUpgradeRequirementCheck
    if ($mmaUpgradeRequired) 
    {
        $mmaDownloadUrl = GetMMAUpgradeUrl
        if ($mmaDownloadUrl) 
        {
            $downloadedFile = "MMASetup.exe"
            # Download mma exe files
            Invoke-WebRequest "$mmaDownloadUrl" -OutFile $downloadedFile
            if(Test-Path $PSScriptRoot\MMA)
            {
                Remove-Item $PSScriptRoot\MMA -Recurse -Force
            }
            # Extract MMA exe file
            Start-Process -Wait -NoNewWindow -FilePath "$PSScriptRoot\$downloadedFile" -ArgumentList "/c /t:$PSScriptRoot\MMA"
            # Run Setup.exe
            Start-Process -Wait -NoNewWindow -FilePath "MMA\Setup.exe" -ArgumentList "/qn /l*v AgentUpgrade.log AcceptEndUserLicenseAgreement=1"
        }
    }
}

if ($functionName -eq "GetMMAVersion") 
{
    GetMMAVersion
}
elseif ($functionName -eq "UpgradeMMA" ) 
{
    UpgradeMMA
}
else
{
    return "Wrong parameters"
}