{"id":531425,"date":"2025-09-24T09:53:10","date_gmt":"2025-09-24T09:53:10","guid":{"rendered":"https:\/\/www.ninjaone.com\/?post_type=script_hub&p=531425"},"modified":"2025-09-24T09:53:10","modified_gmt":"2025-09-24T09:53:10","slug":"verifier-les-performances-du-systeme-avec-powershell","status":"publish","type":"script_hub","link":"https:\/\/www.ninjaone.com\/fr\/script-hub\/verifier-les-performances-du-systeme-avec-powershell\/","title":{"rendered":"Comment v\u00e9rifier les performances du syst\u00e8me avec un script PowerShell"},"content":{"rendered":"

Le contr\u00f4le des performances des syst\u00e8mes<\/strong> est essentiel pour une gestion informatique proactive. Qu’il s’agisse de r\u00e9soudre les plaintes des utilisateurs finaux ou d’\u00e9valuer l’\u00e9tat des appareils<\/a> au sein d’une entreprise, les professionnels de l’informatique et les fournisseurs de services g\u00e9r\u00e9s (MSP) ont besoin de m\u00e9thodes fiables et automatis\u00e9es pour mesurer l’utilisation des ressources du syst\u00e8me. Cet article explore un puissant script PowerShell, le troisi\u00e8me script d’une s\u00e9rie d’enqu\u00eates DEX en trois parties, qui capture des statistiques d\u00e9taill\u00e9es sur le processeur, la m\u00e9moire vive, le disque et le r\u00e9seau, les formate pour une sortie HTML et les stocke \u00e9ventuellement dans un champ personnalis\u00e9 NinjaOne WYSIWYG pour une visibilit\u00e9 \u00e0 long terme.<\/p>\n

Contexte<\/h2>\n

Le script 3 s’appuie sur le retour d’information recueilli dans le script 1 du flux de travail de l’enqu\u00eate DEX. Lorsque les donn\u00e9es soumises par l’utilisateur sugg\u00e8rent une d\u00e9gradation de l’exp\u00e9rience, ce script automatise la d\u00e9cision de lancer une v\u00e9rification compl\u00e8te des performances du syst\u00e8me. Il s’agit d’un outil hautement contextuel, parfait pour l’analyse des causes profondes apr\u00e8s la d\u00e9tection d’un d\u00e9calage, d’une utilisation \u00e9lev\u00e9e des ressources<\/a> ou d’autres plaintes.<\/p>\n

En automatisant les contr\u00f4les et en formatant les r\u00e9sultats pour les tableaux de bord NinjaOne, le script simplifie la collaboration entre les \u00e9quipes, les comparaisons historiques et les flux de travail de triage des tickets. Pour les MSP, cela \u00e9limine les conjectures li\u00e9es aux diagnostics \u00e0 distance et ajoute un contexte mesurable aux rapports subjectifs que les utilisateurs fournissent souvent.<\/p>\n

Le script<\/h2>\n
#Requires -Version 5.1\r\n\r\n<#\r\n.SYNOPSIS\r\n    Script 3 of 3 in the DEX Survey experience. Based on the feedback in Script 1, collects system performance data (CPU, memory, disk, and network). The results can optionally be saved to a WYSIWYG custom field.\r\n.DESCRIPTION\r\n    Script 3 of 3 in the DEX Survey experience. Based on the feedback in Script 1, collects system performance data (CPU, memory, disk, and network). The results can optionally be saved to a WYSIWYG custom field.\r\nBy using this script, you indicate your acceptance of the following legal terms as well as our Terms of Use at https:\/\/www.ninjaone.com\/terms-of-use.\r\n    Ownership Rights: NinjaOne owns and will continue to own all right, title, and interest in and to the script (including the copyright). NinjaOne is giving you a limited license to use the script in accordance with these legal terms. \r\n    Use Limitation: You may only use the script for your legitimate personal or internal business purposes, and you may not share the script with another party. \r\n    Republication Prohibition: Under no circumstances are you permitted to re-publish the script in any script library or website belonging to or under the control of any other software provider. \r\n    Warranty Disclaimer: The script is provided \u201cas is\u201d and \u201cas available\u201d, without warranty of any kind. NinjaOne makes no promise or guarantee that the script will be free from defects or that it will meet your specific needs or expectations. \r\n    Assumption of Risk: Your use of the script is at your own risk. You acknowledge that there are certain inherent risks in using the script, and you understand and assume each of those risks. \r\n    Waiver and Release: You will not hold NinjaOne responsible for any adverse or unintended consequences resulting from your use of the script, and you waive any legal or equitable rights or remedies you may have against NinjaOne relating to your use of the script. \r\n    EULA: If you are a NinjaOne customer, your use of the script is subject to the End User License Agreement applicable to you (EULA).\r\n.EXAMPLE\r\n    -DaysSinceLastReboot \"7\" -DurationToPerformTests \"5\" -NumberOfEvents \"5\" -WysiwygCustomField \"WYSIWYG\" -DisplayUserMessage\r\n\r\n    Gathering all user profiles.\r\n    Gathering each user's feedback log location.\r\n\r\n    Checking 'C:\\Users\\tuser1\\AppData\\Local\\NinjaOne-DEX-Survey-Script\\UserDeviceFeedback.log' for user feedback.\r\n    New feedback has been found.\r\n\r\n    A system performance check is needed.\r\n\r\n    Checking for currently logged-in users.\r\n    Sending message to all users.\r\n    Sending message to session Console, display time 150\r\n    Async message sent to session Console\r\n    Sending message to session 31C5CE94259D4006A9E4#0, display time 150\r\n    Async message sent to session 31C5CE94259D4006A9E4#0\r\n    ExitCode: 0\r\n\r\n    Collecting event logs.\r\n    Searching for performance counter localizations.\r\n    Collecting performance metrics for 5 minutes.\r\n    [Warning] The data in one of the performance counter samples is not valid. View the Status property for each PerformanceCounterSample object to make sure it contains valid data.\r\n    [Warning] The data in one of the performance counter samples is not valid. View the Status property for each PerformanceCounterSample object to make sure it contains valid data.\r\n    [Warning] The data in one of the performance counter samples is not valid. View the Status property for each PerformanceCounterSample object to make sure it contains valid data.\r\n    [Warning] The data in one of the performance counter samples is not valid. View the Status property for each PerformanceCounterSample object to make sure it contains valid data.\r\n    [Warning] The data in one of the performance counter samples is not valid. View the Status property for each PerformanceCounterSample object to make sure it contains valid data.\r\n\r\n    ### 12th Gen Intel(R) Core(TM) i9-12900H 2.918 GHz ###\r\n    CPU Average % CPU Minimum % CPU Maximum %\r\n    ------------- ------------- -------------\r\n    41.11%        34.3%         50.31%\r\n\r\n    ### Memory Usage ###\r\n    Total Memory Installed: 4 GB\r\n    RAM Average % RAM Minimum % RAM Maximum %\r\n    ------------- ------------- -------------\r\n    45.27%        44.32%        46.36%\r\n\r\n    ### Top 5 CPU Processes ###\r\n    Process Name  Average CPU % Used Minimum CPU % Used Maximum CPU % Used\r\n    ------------  ------------------ ------------------ ------------------\r\n    tiworker      78.53%             65.87%             97.09%\r\n    ninjarmmagent 0.17%              0.1%               0.29%\r\n    conhost       0.09%              0.03%              0.21%\r\n    svchost       0.08%              0.05%              0.13%\r\n    msmpeng       0.08%              0.03%              0.16%\r\n\r\n    ### Top 5 RAM Processes ###\r\n    Process Name Average RAM % Used Minimum RAM % Used Maximum RAM % Used\r\n    ------------ ------------------ ------------------ ------------------\r\n    tiworker     13.53%             13.08%             14.06%\r\n    msmpeng      3.15%              2.85%              3.54%\r\n    svchost      2.38%              2.37%              2.39%\r\n    powershell   2.25%              2.25%              2.25%\r\n    dwm          0.32%              0.32%              0.32%\r\n\r\n    ### Network Usage ###\r\n    NetworkAdapter          : microsoft hyper-v network adapter\r\n    MacAddress              : 00-17-FB-00-00-00\r\n    Type                    : Wired\r\n    Average Sent & Received : 0 Mbps\r\n    Minimum Sent & Received : 0 Mbps\r\n    Maximum Sent & Received : 0 Mbps\r\n\r\n    ### Disk Usage ###\r\n    DriveLetter  : C\r\n    FreeSpace    : 22.97 GB (46.44%)\r\n    TotalSpace   : 49.47 GB\r\n    PhysicalDisk : Msft Virtual Disk\r\n    MediaType    : Unspecified\r\n    Average IOPS : 83.07 IOPS\r\n    Minimum IOPS : 20.1 IOPS\r\n    Maximum IOPS : 119.06 IOPS\r\n\r\n    ### Top 5 IO Processes (Network & Disk Combined) ###\r\n    Process Name  Average IO Used Minimum IO Used Maximum IO Used\r\n    ------------  --------------- --------------- ---------------\r\n    tiworker      24.8218 Mbps    19.1945 Mbps    31.2237 Mbps\r\n    wmiprvse      0.4951 Mbps     0 Mbps          2.4754 Mbps\r\n    svchost       0.3126 Mbps     0.297 Mbps      0.3608 Mbps\r\n    system        0.1814 Mbps     0.0042 Mbps     0.4999 Mbps\r\n    ninjarmmagent 0.0305 Mbps     0.018 Mbps      0.0766 Mbps\r\n\r\n    Retrieving WinSAT assessment data.\r\n    More info: https:\/\/learn.microsoft.com\/en-us\/previous-versions\/windows\/it-pro\/windows-8.1-and-8\/hh825488(v=win.10)\r\n    ExitCode: 0\r\n    Retrieving WinSAT assessment data.\r\n    Successfully retrieved assessment data.\r\n\r\n    Attempting to set Custom Field 'WYSIWYG'.\r\n    Successfully set Custom Field 'WYSIWYG'!\r\n\r\n    Checking for currently logged-in users.\r\n\r\n    Sending message to all users.\r\n    Sending message to session Console, display time 150\r\n    Async message sent to session Console\r\n    Sending message to session 31C5CE94259D4006A9E4#0, display time 150\r\n    Async message sent to session 31C5CE94259D4006A9E4#0\r\n    ExitCode: 0\r\n\r\n    Updating the feedback log at 'C:\\Users\\tuser1\\AppData\\Local\\NinjaOne-DEX-Survey-Script\\UserDeviceFeedback.log'.\r\n    Updated the log file at 'C:\\Users\\tuser1\\AppData\\Local\\NinjaOne-DEX-Survey-Script\\UserDeviceFeedback.log'.\r\n\r\n    ### Last 2147483646 errors in Application, Security, Setup and System Log. ###\r\n    LogName      : Application\r\n    ProviderName : Microsoft-Windows-Defrag\r\n    Id           : 257\r\n    TimeCreated  : 5\/20\/2025 3:35:45 PM\r\n    Message      : The volume Windows RE Tools was not optimized because an error\r\n                was encountered: Neither Slab Consolidation nor Slab Analysis\r\n                will run if slabs are less than 8 MB. (0x8900002D)\r\n    ....\r\n\r\n.PARAMETER DisplayUserMessage\r\n    Display a message to the end-user informing them that you are collecting performance metrics and that they should not restart the computer.\r\n\r\n.PARAMETER DaysSinceLastReboot\r\n    Specify the number of days by which the system should have been rebooted.\r\n\r\n.PARAMETER DurationToPerformTests\r\n    The duration (in minutes) for which the performance tests should be executed.\r\n\r\n.PARAMETER NumberOfEvents\r\n    The number of error events to retrieve from the Application, Security, Setup, and System event logs.\r\n\r\n.PARAMETER WysiwygCustomField\r\n    Optionally specify the name of a WYSIWYG custom field to store the formatted performance data.\r\n\r\n.NOTES\r\n    Minimum OS Architecture Supported: Windows 10, Windows Server 2016\r\n    Release Notes: Initial Release\r\n#>\r\n\r\n[CmdletBinding()]\r\nparam (\r\n    [Parameter()]\r\n    $DaysSinceLastReboot,\r\n    [Parameter()]\r\n    $DurationToPerformTests = 5,\r\n    [Parameter()]\r\n    $NumberOfEvents,\r\n    [Parameter()]\r\n    [String]$WysiwygCustomField,\r\n    [Parameter()]\r\n    [Switch]$DisplayUserMessage = [System.Convert]::ToBoolean($env:displayUserMessage)\r\n)\r\n\r\nbegin {\r\n    # If script form variables are used, replace command line parameters with their values.\r\n    if ($env:daysSinceLastReboot) { $DaysSinceLastReboot = $env:daysSinceLastReboot }\r\n    if ($env:durationToPerformTests) { $DurationToPerformTests = $env:durationToPerformTests }\r\n    if ($env:numberOfEvents) { $NumberOfEvents = $env:numberOfEvents }\r\n    if ($env:wysiwygCustomFieldName) { $WysiwygCustomField = $env:wysiwygCustomFieldName }\r\n\r\n    # Check if the operating system build version is less than 10240 (Windows 10 or Windows Server 2016 minimum requirement)\r\n    if ([System.Environment]::OSVersion.Version.Build -lt 10240) {\r\n        Write-Host -Object \"`n[Warning] OS build '$([System.Environment]::OSVersion.Version.Build)' detected.\"\r\n        Write-Host -Object \"[Warning] The minimum OS version supported by this script is Windows 10 (10240) or Windows Server 2016 (14393).`n\"\r\n    }\r\n\r\n    # Ensure the value does not contain invalid characters.\r\n    if ($DaysSinceLastReboot -and $DaysSinceLastReboot -match \"[^0-9]\") {\r\n        Write-Host -Object \"[Error] The 'Days Since Last Reboot' value of '$DaysSinceLastReboot' is invalid. It contains invalid characters.\"\r\n        Write-Host -Object \"[Error] Please provide a positive whole number that is greater than or equal to 0 and less than '$([int]::MaxValue)'.\"\r\n        exit 1\r\n    }\r\n\r\n    # Validate the 'Days Since Last Reboot' input.\r\n    if ($DaysSinceLastReboot) {\r\n        try {\r\n            # Attempt to cast the value to a number.\r\n            [int]$DaysSinceLastReboot = $DaysSinceLastReboot\r\n        } catch {\r\n            # If the conversion fails, display an error message and exit the script.\r\n            Write-Host -Object \"[Error] $($_.Exception.Message)\"\r\n            Write-Host -Object \"[Error] The 'Days Since Last Reboot' value of '$DaysSinceLastReboot' is invalid.\"\r\n            Write-Host -Object \"[Error] Please provide a positive whole number that is greater than or equal to 0 and less than '$([int]::MaxValue)'.\"\r\n            exit 1\r\n        }\r\n    }\r\n\r\n    # Ensure the value is non-negative (greater than or equal to 0).\r\n    if ($DaysSinceLastReboot -and $DaysSinceLastReboot -lt 0) {\r\n        Write-Host -Object \"[Error] The 'Days Since Last Reboot' value of '$DaysSinceLastReboot' is invalid. It is less than 0.\"\r\n        Write-Host -Object \"[Error] Please provide a positive whole number that is greater than or equal to 0 and less than '$([int]::MaxValue)'.\"\r\n        exit 1\r\n    }\r\n\r\n    # Ensure the value is less than the maximum allowed value.\r\n    if ($DaysSinceLastReboot -and $DaysSinceLastReboot -ge [int]::MaxValue) {\r\n        Write-Host -Object \"[Error] The 'Days Since Last Reboot' value of '$DaysSinceLastReboot' is invalid. It is greater than or equal to '$([int]::MaxValue)'.\"\r\n        Write-Host -Object \"[Error] Please provide a positive whole number that is greater than or equal to 0 and less than '$([int]::MaxValue)'.\"\r\n        exit 1\r\n    }\r\n\r\n    # Validate the 'Duration To Perform Tests' input.\r\n    if ([string]::IsNullOrWhiteSpace($DurationToPerformTests)) {\r\n        Write-Host -Object \"[Error] Please provide the duration for which you would like to perform the tests using the 'Duration To Perform Tests' box.\"\r\n        exit 1\r\n    }\r\n\r\n    # Ensure the value does not contain invalid characters.\r\n    if ($DurationToPerformTests -match \"[^0-9]\") {\r\n        Write-Host -Object \"[Error] The 'Duration To Perform Tests' value of '$DurationToPerformTests' is invalid. It contains invalid characters.\"\r\n        Write-Host -Object \"[Error] Please provide a positive whole number that's greater than 0 and less than or equal to 60.\"\r\n        exit 1\r\n    }\r\n\r\n    # Validate the 'Duration to Perform Tests input' input.\r\n    if (![string]::IsNullOrWhiteSpace($DurationToPerformTests)) {\r\n        try {\r\n            # Attempt to cast the value to a number.\r\n            [int]$DurationToPerformTests = $DurationToPerformTests\r\n        } catch {\r\n            # If the conversion fails, display an error message and exit the script.\r\n            Write-Host -Object \"[Error] $($_.Exception.Message)\"\r\n            Write-Host -Object \"[Error] The 'Duration to Perform Tests' value of '$DurationToPerformTests' is invalid.\"\r\n            Write-Host -Object \"[Error] Please provide a positive whole number that is greater than 0 and less than or equal to 60.\"\r\n            exit 1\r\n        }\r\n    }\r\n\r\n    # Ensure the duration is between 1 and 60.\r\n    if ($DurationToPerformTests -lt 1 -or $DurationToPerformTests -gt 60) {\r\n        Write-Host -Object \"[Error] The 'Duration To Perform Tests' value of '$DurationToPerformTests' is invalid. It is less than 1 or greater than 60.\"\r\n        Write-Host -Object \"[Error] Please provide a positive whole number that's greater than 0 and less than or equal to 60.\"\r\n        exit 1\r\n    }\r\n\r\n    # Ensure the value does not contain invalid characters.\r\n    if ($NumberOfEvents -and $NumberOfEvents -match \"[^0-9]\") {\r\n        Write-Host -Object \"[Error] The 'Number of Events' value of '$NumberOfEvents' is invalid. It contains invalid characters.\"\r\n        Write-Host -Object \"[Error] Please provide a positive whole number that is greater than or equal to 0 and less than '$([int]::MaxValue)'.\"\r\n        exit 1\r\n    }\r\n\r\n    # Validate the 'Number of Events' input.\r\n    if ($NumberOfEvents) {\r\n        try {\r\n            # Attempt to cast the value to a number.\r\n            [int]$NumberOfEvents = $NumberOfEvents\r\n        } catch {\r\n            # If the conversion fails, display an error message and exit the script.\r\n            Write-Host -Object \"[Error] $($_.Exception.Message)\"\r\n            Write-Host -Object \"[Error] The 'Number of Events' value of '$NumberOfEvents' is invalid.\"\r\n            Write-Host -Object \"[Error] Please provide a positive whole number that is greater than or equal to 0 and less than '$([int]::MaxValue)'.\"\r\n            exit 1\r\n        }\r\n    }\r\n\r\n    # Ensure the value is non-negative (greater than or equal to 0).\r\n    if ($NumberOfEvents -and $NumberOfEvents -lt 0) {\r\n        Write-Host -Object \"[Error] The 'Number of Events' value of '$NumberOfEvents' is invalid. It is less than 0.\"\r\n        Write-Host -Object \"[Error] Please provide a positive whole number that is greater than or equal to 0 and less than '$([int]::MaxValue)'.\"\r\n        exit 1\r\n    }\r\n\r\n    # Ensure the value is less than the maximum allowed value.\r\n    if ($NumberOfEvents -and $NumberOfEvents -ge [int]::MaxValue) {\r\n        Write-Host -Object \"[Error] The 'Number of Events' value of '$NumberOfEvents' is invalid. It is greater than or equal to '$([int]::MaxValue)'.\"\r\n        Write-Host -Object \"[Error] Please provide a positive whole number that is greater than or equal to 0 and less than '$([int]::MaxValue)'.\"\r\n        exit 1\r\n    }\r\n\r\n    function Invoke-LegacyConsoleTool {\r\n        [CmdletBinding()]\r\n        param(\r\n            [Parameter()]\r\n            [String]$FilePath,\r\n            [Parameter()]\r\n            [String[]]$ArgumentList,\r\n            [Parameter()]\r\n            [Int]$Timeout = 30,\r\n            [Parameter()]\r\n            [System.Text.Encoding]$Encoding\r\n        )\r\n\r\n        # Validate that the file path is not null or empty\r\n        if ([String]::IsNullOrWhiteSpace($FilePath)) {\r\n            throw (New-Object System.ArgumentNullException(\"You must provide a file path to the legacy tool you are trying to use.\"))\r\n        }\r\n\r\n        # Validate that a timeout value is provided\r\n        if (!$Timeout) {\r\n            throw (New-Object System.ArgumentNullException(\"You must provide a timeout value.\"))\r\n        }\r\n\r\n        # Check if the file path is not rooted and does not exist in the current directory\r\n        if (!([System.IO.Path]::IsPathRooted($FilePath)) -and !(Test-Path -Path $FilePath -PathType Leaf -ErrorAction SilentlyContinue)) {\r\n            # Retrieve the system PATH environment variable and split it into directories\r\n            $EnvPaths = [System.Environment]::GetEnvironmentVariable(\"PATH\").Split(\";\")\r\n            # Retrieve the PATHEXT environment variable to get executable file extensions\r\n            $PathExts = [System.Environment]::GetEnvironmentVariable(\"PATHEXT\").Split(\";\")\r\n\r\n            $ResolvedPath = $null\r\n            # Iterate through each directory in the PATH environment variable\r\n            foreach ($Directory in $EnvPaths) {\r\n                # Check for each possible file extension in PATHEXT\r\n                foreach ($FileExtension in $PathExts) {\r\n                    # Construct the potential file path\r\n                    $PotentialMatch = Join-Path $Directory ($FilePath + $FileExtension)\r\n                    # If the file exists, set it as the resolved path\r\n                    if (Test-Path $PotentialMatch -PathType Leaf) {\r\n                        $ResolvedPath = $PotentialMatch\r\n                        break\r\n                    }\r\n                }\r\n                # Exit the loop if a resolved path is found\r\n                if ($ResolvedPath) { break }\r\n            }\r\n\r\n            # If a resolved path is found, update the FilePath variable\r\n            if ($ResolvedPath) {\r\n                $FilePath = $ResolvedPath\r\n            }\r\n        }\r\n\r\n        # Check if the file exists at the specified path\r\n        if (!(Test-Path -Path $FilePath -PathType Leaf -ErrorAction SilentlyContinue)) {\r\n            throw (New-Object System.IO.FileNotFoundException(\"Unable to find '$FilePath'.\"))\r\n        }\r\n\r\n        # Ensure the timeout value is at least 30 seconds\r\n        if ($Timeout -lt 30) {\r\n            throw (New-Object System.ArgumentOutOfRangeException(\"You must provide a timeout value that is greater than or equal to 30 seconds.\"))\r\n        }\r\n\r\n        # Initialize a ProcessStartInfo object to configure the process\r\n        $ProcessInfo = New-Object System.Diagnostics.ProcessStartInfo\r\n        $ProcessInfo.FileName = $FilePath\r\n\r\n        # Combine arguments into a single string if provided\r\n        if ($ArgumentList) {\r\n            $ProcessInfo.Arguments = $ArgumentList -join \" \"\r\n        }\r\n\r\n        # Configure the process to run without a shell, without a new window, and with redirected I\/O\r\n        $ProcessInfo.UseShellExecute = $False\r\n        $ProcessInfo.CreateNoWindow = $True\r\n        $ProcessInfo.RedirectStandardInput = $True\r\n        $ProcessInfo.RedirectStandardOutput = $True\r\n        $ProcessInfo.RedirectStandardError = $True\r\n\r\n        # Set the encoding for standard output and error streams\r\n        if (!$Encoding) {\r\n            try {\r\n                # Dynamically load the method to get the OEM code page if not already loaded\r\n                if (-not ([System.Management.Automation.PSTypeName]'NativeMethods.Win32').Type) {\r\n                    $Definition = '[DllImport(\"kernel32.dll\")]' + \"`n\" + 'public static extern uint GetOEMCP();'\r\n                    Add-Type -MemberDefinition $Definition -Name \"Win32\" -Namespace \"NativeMethods\" -ErrorAction Stop\r\n                }\r\n\r\n                # Retrieve the OEM code page and set the encoding\r\n                [int]$OemCodePage = [NativeMethods.Win32]::GetOEMCP()\r\n                $Encoding = [System.Text.Encoding]::GetEncoding($OemCodePage)\r\n            } catch {\r\n                throw $_\r\n            }\r\n        }\r\n        $ProcessInfo.StandardOutputEncoding = $Encoding\r\n        $ProcessInfo.StandardErrorEncoding = $Encoding\r\n\r\n        # Create a new process object and attach the ProcessStartInfo configuration\r\n        $Process = New-Object System.Diagnostics.Process\r\n        $Process.StartInfo = $ProcessInfo\r\n\r\n        # Add properties to store standard output and error streams\r\n        $Process | Add-Member -MemberType NoteProperty -Name StdOut -Value (New-Object System.Collections.Generic.List[string]) -Force | Out-Null\r\n        $Process | Add-Member -MemberType NoteProperty -Name StdErr -Value (New-Object System.Collections.Generic.List[string]) -Force | Out-Null\r\n\r\n        # Start the process\r\n        $Process.Start() | Out-Null\r\n\r\n        $ProcessTimeout = 0\r\n        $TimeoutInMilliseconds = $Timeout * 1000\r\n\r\n        # Initialize string builders to collect output\r\n        $StdOutBuffer = New-Object System.Text.StringBuilder\r\n        $StdErrBuffer = New-Object System.Text.StringBuilder\r\n\r\n        # Monitor the process execution and read output\/error streams\r\n        while (!$Process.HasExited -and $ProcessTimeout -lt $TimeoutInMilliseconds ) {\r\n            # Read standard output to prevent buffer overflow\r\n            while (!$Process.StandardOutput.EndOfStream -and $Process.StandardOutput.Peek() -ne -1) {\r\n                $Char = $Process.StandardOutput.Read()\r\n                if ($Char -ne -1) {\r\n                    $ActualCharacter = [char]$Char\r\n                    if ($ActualCharacter -eq \"`n\") {\r\n                        # Add the completed line to the StdOut collection\r\n                        $Process.StdOut.Add($StdOutBuffer.ToString())\r\n                        $null = $StdOutBuffer.Clear()\r\n                    } elseif ($ActualCharacter -ne \"`r\") {\r\n                        # Append characters to the buffer, excluding carriage returns\r\n                        $null = $StdOutBuffer.Append($ActualCharacter)\r\n                    }\r\n                }\r\n            }\r\n\r\n            # Read standard error to prevent buffer overflow\r\n            while (!$Process.StandardError.EndOfStream -and $Process.StandardError.Peek() -ne -1) {\r\n                $Char = $Process.StandardError.Read()\r\n                if ($Char -ne -1) {\r\n                    $ActualCharacter = [char]$Char\r\n                    if ($ActualCharacter -eq \"`n\") {\r\n                        # Add the completed line to the StdErr collection\r\n                        $Process.StdErr.Add($StdErrBuffer.ToString())\r\n                        $null = $StdErrBuffer.Clear()\r\n                    } elseif ($ActualCharacter -ne \"`r\") {\r\n                        # Append characters to the buffer, excluding carriage returns\r\n                        $null = $StdErrBuffer.Append($ActualCharacter)\r\n                    }\r\n                }\r\n            }\r\n\r\n            # Sleep briefly before polling again to avoid excessive CPU usage\r\n            Start-Sleep -Milliseconds 100\r\n            $ProcessTimeout = $ProcessTimeout + 10\r\n        }\r\n\r\n        # Add final buffered content to StdOut and StdErr properties\r\n        if ($StdOutBuffer.Length -gt 0) {\r\n            $Process.StdOut.Add($StdOutBuffer.ToString())\r\n        }\r\n\r\n        if ($StdErrBuffer.Length -gt 0) {\r\n            $Process.StdErr.Add($StdErrBuffer.ToString())\r\n        }\r\n\r\n        try {\r\n            # Handle timeout scenarios\r\n            if ($ProcessTimeout -ge 300000) {\r\n                throw (New-Object System.ServiceProcess.TimeoutException(\"The process has timed out.\"))\r\n            }\r\n\r\n            # Wait for the process to exit within the remaining timeout period\r\n            $TimeoutRemaining = 300000 - $ProcessTimeout\r\n            if (!$Process.WaitForExit($TimeoutRemaining)) {\r\n                throw (New-Object System.ServiceProcess.TimeoutException(\"The process has timed out.\"))\r\n            }\r\n        } catch {\r\n            # Set the global exit code and dispose of the process\r\n            if ($Process.ExitCode) {\r\n                $GLOBAL:LASTEXITCODE = $Process.ExitCode\r\n            } else {\r\n                $GLOBAL:LASTEXITCODE = 1\r\n            }\r\n\r\n            # Dispose of the process to release resources\r\n            if ($Process) {\r\n                $Process.Dispose()\r\n            }\r\n\r\n            throw $_\r\n        }\r\n\r\n        # Final read of output and error streams to ensure all data is captured\r\n        while (!$Process.StandardOutput.EndOfStream) {\r\n            $Char = $Process.StandardOutput.Read()\r\n            if ($Char -ne -1) {\r\n                $ActualCharacter = [char]$Char\r\n                if ($ActualCharacter -eq \"`n\") {\r\n                    # Add the completed line to the StdOut collection\r\n                    $Process.StdOut.Add($StdOutBuffer.ToString())\r\n                    $null = $StdOutBuffer.Clear()\r\n                } elseif ($ActualCharacter -ne \"`r\") {\r\n                    # Append characters to the buffer, excluding carriage returns\r\n                    $null = $StdOutBuffer.Append($ActualCharacter)\r\n                }\r\n            }\r\n        }\r\n\r\n        while (!$Process.StandardError.EndOfStream) {\r\n            $Char = $Process.StandardError.Read()\r\n            if ($Char -ne -1) {\r\n                $ActualCharacter = [char]$Char\r\n                if ($ActualCharacter -eq \"`n\") {\r\n                    # Add the completed line to the StdErr collection\r\n                    $Process.StdErr.Add($StdErrBuffer.ToString())\r\n                    $null = $StdErrBuffer.Clear()\r\n                } elseif ($ActualCharacter -ne \"`r\") {\r\n                    # Append characters to the buffer, excluding carriage returns\r\n                    $null = $StdErrBuffer.Append($ActualCharacter)\r\n                }\r\n            }\r\n        }\r\n\r\n        if ($Process.StdErr.Count -gt 0) {\r\n            # Set the global exit code\r\n            if ($Process.ExitCode -or $Process.ExitCode -eq 0) {\r\n                $GLOBAL:LASTEXITCODE = $Process.ExitCode\r\n            }\r\n\r\n            # Dispose of the process\r\n            if ($Process) {\r\n                $Process.Dispose()\r\n            }\r\n\r\n            # Log errors from the standard error stream\r\n            $Process.StdErr | Write-Error -Category \"FromStdErr\"\r\n        }\r\n\r\n        # Return the standard output if available\r\n        if ($Process.StdOut.Count -gt 0) {\r\n            $Process.StdOut\r\n        }\r\n\r\n        # Set the global exit code\r\n        if ($Process.ExitCode -or $Process.ExitCode -eq 0) {\r\n            $GLOBAL:LASTEXITCODE = $Process.ExitCode\r\n        }\r\n\r\n        # Dispose of the process\r\n        if ($Process) {\r\n            $Process.Dispose()\r\n        }\r\n    }\r\n\r\n    function Test-IsServer {\r\n        # Determine the method to retrieve the operating system information based on PowerShell version\r\n\r\n        try {\r\n            $OS = if ($PSVersionTable.PSVersion.Major -lt 3) {\r\n                Get-WmiObject -Class Win32_OperatingSystem -ErrorAction Stop\r\n            } else {\r\n                Get-CimInstance -ClassName Win32_OperatingSystem -ErrorAction Stop\r\n            }\r\n        } catch {\r\n            Write-Host -Object \"[Error] Failed to identity if this device is a workstation or server.\"\r\n            throw $_\r\n        }\r\n\r\n        # Check if the ProductType is \"3\" or \"2\", which indicates that the system is a server\r\n        if ($OS.ProductType -eq \"3\" -or $OS.ProductType -eq \"2\") {\r\n            return $true\r\n        }\r\n    }\r\n\r\n    # Check if the script is running on a server.\r\n    try {\r\n        $IsServer = Test-IsServer\r\n    } catch {\r\n        Write-Host -Object \"[Error] Unable to identify device type.\"\r\n        Write-Host -Object \"[Error] $($_.Exception.Message)`n\"\r\n        $ExitCode = 1\r\n    }\r\n\r\n    if ($IsServer -and $DisplayUserMessage) {\r\n        # Attempt to check if the RDS role is installed.\r\n        try {\r\n            # Retrieve the RDS role feature and check if it is installed.\r\n            $RDSRole = Get-WindowsFeature -Name RDS-RD-Server | Where-Object { $_.Installed }\r\n        } catch {\r\n            # If an error occurs during the check, output an error message and exit the script.\r\n            Write-Host -Object \"[Error] Unable to check if the RDS role is installed.\"\r\n            Write-Host -Object \"[Error] $($_.Exception.Message)\"\r\n            exit 1\r\n        }\r\n\r\n        # If the RDS role is installed, output an error message and exit the script.\r\n        if ($RDSRole) {\r\n            Write-Host -Object \"[Error] This script doesn't support sending a message on RDS servers because the message would show for all logged-in users, potentially creating a source of confusion.\"\r\n            exit 1\r\n        }\r\n    }\r\n\r\n    function Test-IsElevated {\r\n        [CmdletBinding()]\r\n        param ()\r\n\r\n        # Get the current Windows identity of the user running the script\r\n        $id = [System.Security.Principal.WindowsIdentity]::GetCurrent()\r\n\r\n        # Create a WindowsPrincipal object based on the current identity\r\n        $p = New-Object System.Security.Principal.WindowsPrincipal($id)\r\n\r\n        # Check if the current user is in the Administrator role\r\n        # The function returns $True if the user has administrative privileges, $False otherwise\r\n        # 544 is the value for the Built-In Administrators role\r\n        # Reference: https:\/\/learn.microsoft.com\/en-us\/dotnet\/api\/system.security.principal.windowsbuiltinrole\r\n        $p.IsInRole([System.Security.Principal.WindowsBuiltInRole]'544')\r\n    }\r\n\r\n    function Get-UserHive {\r\n        [CmdletBinding()]\r\n        param (\r\n            [Parameter()]\r\n            [ValidateSet('AzureAD', 'DomainAndLocal', 'All')]\r\n            [String]$Type = \"All\",\r\n            [Parameter()]\r\n            [String[]]$ExcludedUsers,\r\n            [Parameter()]\r\n            [switch]$IncludeDefault\r\n        )\r\n\r\n        # Define the SID patterns to match based on the selected user type\r\n        $Patterns = switch ($Type) {\r\n            \"AzureAD\" { \"S-1-12-1-(\\d+-?){4}$\" }\r\n            \"DomainAndLocal\" { \"S-1-5-21-(\\d+-?){4}$\" }\r\n            \"All\" { \"S-1-12-1-(\\d+-?){4}$\" ; \"S-1-5-21-(\\d+-?){4}$\" }\r\n        }\r\n\r\n        # Retrieve user profile information based on the defined patterns\r\n        $UserProfiles = Foreach ($Pattern in $Patterns) {\r\n            Get-ItemProperty \"Registry::HKEY_LOCAL_MACHINE\\SOFTWARE\\Microsoft\\Windows NT\\CurrentVersion\\ProfileList\\*\" |\r\n                Where-Object { $_.PSChildName -match $Pattern } |\r\n                Select-Object @{Name = \"SID\"; Expression = { $_.PSChildName } },\r\n                @{Name = \"Username\"; Expression = { \"$($_.ProfileImagePath | Split-Path -Leaf)\" } },\r\n                @{Name = \"Domain\"; Expression = { if ($_.PSChildName -match \"S-1-12-1-(\\d+-?){4}$\") { \"AzureAD\" }else { $Null } } },\r\n                @{Name = \"UserHive\"; Expression = { \"$($_.ProfileImagePath)\\NTuser.dat\" } },\r\n                @{Name = \"Path\"; Expression = { $_.ProfileImagePath } }\r\n        }\r\n\r\n        # If the IncludeDefault switch is set, add the Default profile to the results\r\n        switch ($IncludeDefault) {\r\n            $True {\r\n                $DefaultProfile = \"\" | Select-Object Username, SID, UserHive, Path\r\n                $DefaultProfile.Username = \"Default\"\r\n                $DefaultProfile.Domain = $env:COMPUTERNAME\r\n                $DefaultProfile.SID = \"DefaultProfile\"\r\n                $DefaultProfile.Userhive = \"$env:SystemDrive\\Users\\Default\\NTUSER.DAT\"\r\n                $DefaultProfile.Path = \"C:\\Users\\Default\"\r\n\r\n                # Exclude users specified in the ExcludedUsers list\r\n                $DefaultProfile | Where-Object { $ExcludedUsers -notcontains $_.Username }\r\n            }\r\n        }\r\n\r\n        if ($PSVersionTable.PSVersion.Major -lt 3) {\r\n            $AllAccounts = Get-WmiObject -Class \"win32_UserAccount\"\r\n        } else {\r\n            $AllAccounts = Get-CimInstance -ClassName \"win32_UserAccount\"\r\n        }\r\n\r\n        $CompleteUserProfiles = $UserProfiles | ForEach-Object {\r\n            $SID = $_.SID\r\n            $Win32Object = $AllAccounts | Where-Object { $_.SID -like $SID }\r\n\r\n            if ($Win32Object) {\r\n                $Win32Object | Add-Member -NotePropertyName UserHive -NotePropertyValue $_.UserHive\r\n                $Win32Object | Add-Member -NotePropertyName Path -NotePropertyValue $_.Path\r\n                $Win32Object\r\n            } else {\r\n                [PSCustomObject]@{\r\n                    Name     = $_.Username\r\n                    Domain   = $_.Domain\r\n                    SID      = $_.SID\r\n                    UserHive = $_.UserHive\r\n                    Path     = $_.Path\r\n                }\r\n            }\r\n        }\r\n\r\n        # Return the list of user profiles, excluding any specified in the ExcludedUsers list\r\n        $CompleteUserProfiles | Where-Object { $ExcludedUsers -notcontains $_.Name }\r\n    }\r\n\r\n    if (!$ExitCode) {\r\n        $ExitCode = 0\r\n    }\r\n\r\n    $StartedDateTime = Get-Date\r\n}\r\nprocess {\r\n    # Attempt to determine if the current session is running with Administrator privileges.\r\n    try {\r\n        $IsElevated = Test-IsElevated -ErrorAction Stop\r\n    } catch {\r\n        # Log an error if unable to determine admin privileges\r\n        Write-Host -Object \"[Error] $($_.Exception.Message)\"\r\n        Write-Host -Object \"[Error] Unable to determine if the account '$env:Username' is running with Administrator privileges.\"\r\n        exit 1\r\n    }\r\n\r\n    # Exit if the script is not running with Administrator privileges\r\n    if (!($IsElevated)) {\r\n        Write-Host -Object \"[Error] Access Denied: The user '$env:Username' does not have administrator privileges, or the script is not running with elevated permissions.\"\r\n        exit 1\r\n    }\r\n\r\n    # Check if the script is being run with elevated (Administrator) privileges.\r\n    # If not, display an error message and exit the script.\r\n    if (!(Test-IsElevated)) {\r\n        Write-Host -Object \"[Error] Access Denied. Please run with Administrator privileges.\"\r\n        exit 1\r\n    }\r\n\r\n    # Check if the lock file exists to prevent multiple instances of the script from running.\r\n    # If it exists, read the process ID from the lock file and check if the process is still running.\r\n    if (Test-Path -Path \"$env:ProgramData\\NinjaRMMAgent\\SystemPerformance.lock.txt\" -ErrorAction SilentlyContinue) {\r\n        try {\r\n            Write-Host -Object \"Process lock file found at '$env:ProgramData\\NinjaRMMAgent\\SystemPerformance.lock.txt'. Checking if the process is still running.\"\r\n\r\n            # Retrieve the process ID from the lock file.\r\n            $OtherScript = Get-Content -Path \"$env:ProgramData\\NinjaRMMAgent\\SystemPerformance.lock.txt\" -ErrorAction Stop\r\n\r\n            # Check if the process ID exists, indicating the script is already running.\r\n            if (Get-Process -Id $OtherScript -ErrorAction SilentlyContinue) {\r\n                Write-Host -Object \"[Error] This script is already running in another process with the process id (PID) '$OtherScript'.\"\r\n                exit 1\r\n            }\r\n        } catch {\r\n            # If there is an error accessing the lock file, display an error message and exit.\r\n            Write-Host -Object \"[Error] Unable to access the lock file at '$env:ProgramData\\NinjaRMMAgent\\SystemPerformance.lock.txt'.\"\r\n            Write-Host -Object \"[Error] $($_.Exception.Message)\"\r\n            exit 1\r\n        }\r\n    }\r\n\r\n    # Attempt to write the current process ID to the lock file, preventing multiple instances of the script from running.\r\n    try {\r\n        [System.Diagnostics.Process]::GetCurrentProcess().Id | Out-File -FilePath \"$env:ProgramData\\NinjaRMMAgent\\SystemPerformance.lock.txt\" -Force -ErrorAction Stop\r\n    } catch {\r\n        # If the lock file cannot be created, display an error message and exit.\r\n        Write-Host -Object \"[Error] Failed to create lock file at '$env:ProgramData\\NinjaRMMAgent\\SystemPerformance.lock.txt'.\"\r\n        Write-Host -Object \"[Error] $($_.Exception.Message)\"\r\n        exit 1\r\n    }\r\n\r\n    try {\r\n        # Retrieve all user profiles on the system\r\n        Write-Host -Object \"Gathering all user profiles.\"\r\n        $UserProfiles = Get-UserHive -Type \"All\" -ErrorAction Stop\r\n        $ProfileWasLoaded = New-Object System.Collections.Generic.List[object]\r\n    } catch {\r\n        # Log an error if unable to gather user profiles\r\n        Write-Host -Object \"[Error] $($_.Exception.Message)\"\r\n        Write-Host -Object \"[Error] Failed to gather all the user profiles.\"\r\n        exit 1\r\n    }\r\n\r\n    # Loop through each user profile to load their registry hive if not already loaded\r\n    ForEach ($UserProfile in $UserProfiles) {\r\n        If (!(Test-Path -Path Registry::HKEY_USERS\\$($UserProfile.SID) -ErrorAction SilentlyContinue)) {\r\n            Start-Process -FilePath \"cmd.exe\" -ArgumentList \"\/C reg.exe LOAD HKU\\$($UserProfile.SID) `\"$($UserProfile.UserHive)`\"\" -Wait -WindowStyle Hidden\r\n            $ProfileWasLoaded.Add($UserProfile)\r\n        }\r\n    }\r\n\r\n    # Locate feedback log files for each user profile\r\n    Write-Host -Object \"Gathering each user's feedback log location.\"\r\n    $FeedbackLogLocations = New-Object System.Collections.Generic.List[object]\r\n    $UserProfiles | ForEach-Object {\r\n        # Check for feedback log file in various locations\r\n        $AppDataLocation = Get-ItemProperty -Path \"Registry::HKEY_USERS\\$($_.SID)\\Software\\Microsoft\\Windows\\CurrentVersion\\Explorer\\Shell Folders\" -ErrorAction SilentlyContinue | Select-Object -ExpandProperty \"Local AppData\" -ErrorAction SilentlyContinue\r\n\r\n        if ($AppDataLocation -and (Test-Path -Path \"$AppDataLocation\\NinjaOne-DEX-Survey-Script\\UserDeviceFeedback.log\" -Type Leaf -ErrorAction SilentlyContinue)) {\r\n            $FeedbackLogLocations.Add(\r\n                [PSCustomObject]@{\r\n                    Name            = $_.Name\r\n                    Domain          = $_.Domain\r\n                    LogFileLocation = \"$AppDataLocation\\NinjaOne-DEX-Survey-Script\\UserDeviceFeedback.log\"\r\n                }\r\n            )\r\n            return\r\n        }\r\n\r\n        if (Test-Path -Path \"$($_.Path)\\AppData\\Local\\NinjaOne-DEX-Survey-Script\\UserDeviceFeedback.log\" -Type Leaf -ErrorAction SilentlyContinue) {\r\n            $FeedbackLogLocations.Add(\r\n                [PSCustomObject]@{\r\n                    Name            = $_.Name\r\n                    Domain          = $_.Domain\r\n                    LogFileLocation = \"$($_.Path)\\AppData\\Local\\NinjaOne-DEX-Survey-Script\\UserDeviceFeedback.log\"\r\n                }\r\n            )\r\n            return\r\n        }\r\n\r\n        if (Test-Path -Path \"C:\\Users\\$($_.Name)\\AppData\\Local\\NinjaOne-DEX-Survey-Script\\UserDeviceFeedback.log\" -Type Leaf -ErrorAction SilentlyContinue) {\r\n            $FeedbackLogLocations.Add(\r\n                [PSCustomObject]@{\r\n                    Name            = $_.Name\r\n                    Domain          = $_.Domain\r\n                    LogFileLocation = \"C:\\Users\\$($_.Name)\\AppData\\Local\\NinjaOne-DEX-Survey-Script\\UserDeviceFeedback.log\"\r\n                }\r\n            )\r\n            return\r\n        }\r\n\r\n        # Log a message if no feedback log file is found for the user\r\n        Write-Host -Object \"No feedback log file found for $($_.Name) in the domain $($_.Domain).\"\r\n    }\r\n\r\n    # Unload user registry hives if they were loaded during this script execution\r\n    if ($ProfileWasLoaded.Count -gt 0) {\r\n        ForEach ($UserProfile in $ProfileWasLoaded) {\r\n            [gc]::Collect()\r\n            Start-Sleep 1\r\n            Start-Process -FilePath \"cmd.exe\" -ArgumentList \"\/C reg.exe UNLOAD HKU\\$($UserProfile.SID)\" -Wait -WindowStyle Hidden | Out-Null\r\n        }\r\n    }\r\n\r\n    # Log a warning if no feedback log files were found\r\n    if ($FeedbackLogLocations.Count -lt 1) {\r\n        Write-Host -Object \"[Warning] No feedback was found.\"\r\n    }\r\n\r\n    Write-Host -Object \"\"\r\n\r\n    # Iterate through each feedback log file location\r\n    foreach ($LogFile in $FeedbackLogLocations) {\r\n        # Inform the user that the feedback log file is being checked\r\n        Write-Host -Object \"Checking '$($LogFile.LogFileLocation)' for user feedback.\"\r\n\r\n        try {\r\n            # Attempt to read the last 200,000 lines of the feedback log file\r\n            $LogContent = Get-Content -Path $LogFile.LogFileLocation -Tail 200000 -ErrorAction Stop\r\n        } catch {\r\n            # Log an error if the feedback log file cannot be read\r\n            Write-Host -Object \"[Error] $($_.Exception.Message)\"\r\n            Write-Host -Object \"[Error] Failed to retrieve the feedback log file contents for the user '$($LogFile.Name)'.\"\r\n            $ExitCode = 1\r\n            continue\r\n        }\r\n\r\n        $i = 0\r\n        # Iterate through each line in the feedback log content\r\n        foreach ($Line in $LogContent) {\r\n            $i++\r\n            # Split the line into data points using the '|' delimiter, expecting 6 parts\r\n            $DataPoints = $Line -split '\\|', 6\r\n\r\n            # Warn if the line has fewer than 6 data points\r\n            if ($DataPoints.Count -lt 6) {\r\n                Write-Host -Object \"[Warning] Only $($DataPoints.Count) data points have been found for line '$i'.\"\r\n                continue\r\n            }\r\n\r\n            # Skip lines where the fifth data point is not False\r\n            if ($DataPoints[4] -ne $False) {\r\n                continue\r\n            } else {\r\n                # If new feedback is found, set the flag and exit the loop\r\n                Write-Host -Object \"New feedback has been found.`n\"\r\n                $SystemPerformanceCheckNeeded = $True\r\n                break\r\n            }\r\n        }\r\n\r\n        # Exit the outer loop if a system performance check is needed\r\n        if ($SystemPerformanceCheckNeeded) {\r\n            break\r\n        }\r\n    }\r\n\r\n    # Check if there is no feedback collected\r\n    if (!$SystemPerformanceCheckNeeded) {\r\n        Write-Host -Object \"Based on the current feedback, a system performance check is not needed.\"\r\n\r\n        # Try to remove the lock file to ensure no other instance of the script is running.\r\n        try {\r\n            Remove-Item -Path \"$env:ProgramData\\NinjaRMMAgent\\SystemPerformance.lock.txt\" -Force -ErrorAction Stop\r\n        } catch {\r\n            # If the removal of the lock file fails, catch the exception and display error messages.\r\n            Write-Host -Object \"[Error] Failed to remove the lock file at '$env:ProgramData\\NinjaRMMAgent\\SystemPerformance.lock.txt'.\"\r\n            Write-Host -Object \"[Error] $($_.Exception.Message)\"\r\n            $ExitCode = 1\r\n        }\r\n        exit $ExitCode\r\n    } else {\r\n        Write-Host -Object \"A system performance check is needed.`n\"\r\n    }\r\n\r\n    $TotalMessageTime = $($DurationToPerformTests * 60 \/ 2)\r\n    $TotalCollectionTime = $DurationToPerformTests\r\n\r\n    if ($DisplayUserMessage) {\r\n        try {\r\n            Write-Host -Object \"Checking for currently logged-in users.\"\r\n            $QuserOutput = Invoke-LegacyConsoleTool -FilePath \"$env:WINDIR\\System32\\quser.exe\" -ErrorVariable \"QUserErrors\" -ErrorAction SilentlyContinue\r\n            if ($QUserErrors) {\r\n                $QUserErrors | ForEach-Object { Write-Host -Object \"[Warning] $($_.Exception.Message)\" }\r\n                $QUserErrors = $Null\r\n            }\r\n\r\n            $i = 0\r\n            $CurrentlyLoggedInUsers = $QuserOutput | Where-Object { $_.Trim() } | ForEach-Object {\r\n                # Skip the first line (header) and process only the data lines\r\n                if ($i -ne 0 -and $_.Length -ge 65) {\r\n                    # Extract the relevant columns using fixed-width positions\r\n                    [PSCustomObject]@{\r\n                        Username    = ($_.Substring(0, 21).Trim() -replace '^>')\r\n                        SessionName = $_.Substring(21, 21).Trim()\r\n                        ID          = $_.Substring(40, 5).Trim()\r\n                        State       = $_.Substring(45, 10).Trim()\r\n                        IdleTime    = $_.Substring(55, 10).Trim()\r\n                        LogonTime   = $_.Substring(65).Trim()\r\n                    }\r\n                }\r\n\r\n                $i++\r\n            }\r\n        } catch {\r\n            Write-Host -Object \"[Error] $($_.Exception.Message)\"\r\n            Write-Host -Object \"[Error] Unable to check for currently logged-in users.\"\r\n            exit 1\r\n        }\r\n    }\r\n\r\n    if ($DisplayUserMessage -and $CurrentlyLoggedInUsers) {\r\n        $CurrentlyLoggedInUsers = $Null\r\n\r\n        # Define arguments for the 'msg.exe' command to display a system message to the user.\r\n        $MSGArguments = @(\r\n            \"*\"\r\n            \"\/TIME:$TotalMessageTime\"\r\n            \"\/V\"\r\n            \"System performance metrics are currently being collected. Collection should complete in approximately $TotalCollectionTime minutes and the results will be sent to your IT Administrator. Please do not restart the computer until this collection has completed.\"\r\n        )\r\n\r\n        # Attempt to display the system message to all users.\r\n        try {\r\n            Write-Host -Object \"Sending message to all users.\"\r\n\r\n            # Start the 'msg.exe' process with the arguments defined above.\r\n            Invoke-LegacyConsoleTool -FilePath \"$env:WINDIR\\System32\\msg.exe\" -ArgumentList $MSGArguments -ErrorAction Stop\r\n        } catch {\r\n            # If the 'msg.exe' process fails to start, output an error message and exit with a failure code.\r\n            Write-Host -Object \"[Error] Failed to send message to all users.\"\r\n            Write-Host -Object \"[Error] $($_.Exception.Message)\"\r\n            exit 1\r\n        }\r\n\r\n        # Output the exit code of the 'msg.exe' process.\r\n        Write-Host -Object \"ExitCode: $LASTEXITCODE\"\r\n\r\n        # If the exit code is non-zero (indicating an error occurred), display an error message.\r\n        if ($LASTEXITCODE -ne 0) {\r\n            Write-Host -Object \"[Error] ExitCode does not indicate success.\"\r\n            exit 1\r\n        }\r\n    }\r\n\r\n    # Get the last reboot time of the system.\r\n    try {\r\n        $LastStartTime = Get-CimInstance -ClassName Win32_OperatingSystem -ErrorAction Stop | Select-Object -ExpandProperty LastBootUpTime\r\n    } catch {\r\n        Write-Host -Object \"[Error] Failed to get last start up time.\"\r\n        Write-Host -Object \"[Error] $($_.Exception.Message)\"\r\n        $ExitCode = 1\r\n    }\r\n\r\n    # If the 'DaysSinceLastReboot' parameter is set, calculate the time difference since the last reboot.\r\n    if ($DaysSinceLastReboot -ge 0) {\r\n        $TimeDifference = New-TimeSpan -Start $LastStartTime -End (Get-Date)\r\n\r\n        # If the time since the last reboot exceeds the limit, display an alert to the user.\r\n        if ($TimeDifference.TotalDays -gt $DaysSinceLastReboot) {\r\n            Write-Host -Object \"[Alert] This computer was last started on $($LastStartTime.ToShortDateString()) at $($LastStartTime.ToShortTimeString()) which was $([math]::Round($TimeDifference.TotalDays,2)) days ago.\"\r\n            $ExceededLastStartupLimit = $True\r\n        }\r\n    }\r\n\r\n    # Initialize an empty list to store event logs.\r\n    $EventLogs = New-Object System.Collections.Generic.List[object]\r\n\r\n    # Define XML queries for Application, Security, Setup, and System event logs that have error level events (Level=2).\r\n    [xml]$ApplicationXML = @\"\r\n<QueryList>\r\n  <Query Id=\"0\" Path=\"Application\">\r\n    <Select Path=\"Application\">*[System[(Level=2)]]<\/Select>\r\n  <\/Query>\r\n<\/QueryList>\r\n\"@\r\n\r\n    [xml]$SecurityLogs = @\"\r\n<QueryList>\r\n  <Query Id=\"0\" Path=\"Application\">\r\n    <Select Path=\"Security\">*[System[(Level=2)]]<\/Select>\r\n  <\/Query>\r\n<\/QueryList>\r\n\"@\r\n\r\n    [xml]$SetupLogs = @\"\r\n<QueryList>\r\n  <Query Id=\"0\" Path=\"Application\">\r\n    <Select Path=\"Setup\">*[System[(Level=2)]]<\/Select>\r\n  <\/Query>\r\n<\/QueryList>\r\n\"@\r\n\r\n    [xml]$SystemLogs = @\"\r\n<QueryList>\r\n  <Query Id=\"0\" Path=\"Application\">\r\n    <Select Path=\"System\">*[System[(Level=2)]]<\/Select>\r\n  <\/Query>\r\n<\/QueryList>\r\n\"@\r\n\r\n    # If the 'NumberOfEvents' parameter is set, collect the specified number of error logs from each log category.\r\n    if ($NumberOfEvents) {\r\n        Write-Host -Object \"`nCollecting event logs.\"\r\n\r\n        # Collect logs from each category and store them in the EventLogs list.\r\n        Get-WinEvent -MaxEvents $NumberOfEvents -FilterXml $ApplicationXML -ErrorAction SilentlyContinue -ErrorVariable EventLogErrors | ForEach-Object { $EventLogs.Add($_) }\r\n        Get-WinEvent -MaxEvents $NumberOfEvents -FilterXml $SecurityLogs -ErrorAction SilentlyContinue -ErrorVariable EventLogErrors | ForEach-Object { $EventLogs.Add($_) }\r\n        Get-WinEvent -MaxEvents $NumberOfEvents -FilterXml $SetupLogs -ErrorAction SilentlyContinue -ErrorVariable EventLogErrors | ForEach-Object { $EventLogs.Add($_) }\r\n        Get-WinEvent -MaxEvents $NumberOfEvents -FilterXml $SystemLogs -ErrorAction SilentlyContinue -ErrorVariable EventLogErrors | ForEach-Object { $EventLogs.Add($_) }\r\n\r\n        # If any errors occurred during log collection, display warnings with the error details.\r\n        if ($EventLogErrors) {\r\n            $EventLogErrors | ForEach-Object {\r\n                Write-Host -Object \"[Warning] $($_.Exception.Message)\"\r\n            }\r\n        }\r\n\r\n        # If no error logs were found, display a warning message.\r\n        if ($EventLogs.Count -eq 0) {\r\n            Write-Host -Object \"[Warning] No error events were found in the event log.\"\r\n        } else {\r\n            $EventLogs = $EventLogs | Select-Object LogName, ProviderName, Id, TimeCreated, Message | Sort-Object -Property TimeCreated -Descending\r\n        }\r\n    }\r\n\r\n    # Display a message to the user indicating the start of the search for performance counter localizations.\r\n    Write-Host -Object \"Searching for performance counter localizations.\"\r\n\r\n    # Attempt to retrieve the \"Counter\" property from the CurrentLanguage registry key, which contains the localized performance counter names.\r\n    # If the retrieval fails, catch the error, display an error message, and exit the script.\r\n    try {\r\n        $CurrentLanguageKey = Get-ItemProperty -Path \"Registry::HKEY_LOCAL_MACHINE\\SOFTWARE\\Microsoft\\Windows NT\\CurrentVersion\\Perflib\\CurrentLanguage\" -Name \"Counter\" -ErrorAction Stop | Select-Object -ExpandProperty Counter\r\n    } catch {\r\n        Write-Host -Object \"[Error] Failed to retrieve performance counter localizations.\"\r\n        Write-Host -Object \"[Error] $($_.Exception.Message)\"\r\n        exit 1\r\n    }\r\n\r\n    # Initialize an empty hash table to store the performance counter localizations.\r\n    $LocalizationCounterTable = @{}\r\n\r\n    # Loop through the array of performance counters in the registry.\r\n    # The counter array consists of alternating key-value pairs (even indexes are keys, odd indexes are values),\r\n    # so this loop increments by 2 to match each key with its corresponding value.\r\n    for ($i = 0; $i -lt $CurrentLanguageKey.Length; $i += 2) {\r\n        $LocalizationCounterTable[$CurrentLanguageKey[$i]] = $CurrentLanguageKey[$i + 1]\r\n    }\r\n\r\n    # Define the paths for various performance counters using the localized counter names from the hash table.\r\n    # These paths are dynamically created by retrieving the localized names for each counter ID.\r\n    $OverallProcessCounterPath = \"\\$($LocalizationCounterTable['238'])(*)\\$($LocalizationCounterTable['6'])\"\r\n    $OverallMemoryCounterPath = \"\\$($LocalizationCounterTable['4'])\\$($LocalizationCounterTable['1406'])\"\r\n    $ProcessorCounterPath = \"\\$($LocalizationCounterTable['230'])(*)\\$($LocalizationCounterTable['142'])\"\r\n    $MemoryCounterPath = \"\\$($LocalizationCounterTable['230'])(*)\\$($LocalizationCounterTable['1478'])\"\r\n    $IOUsageCounterPath = \"\\$($LocalizationCounterTable['230'])(*)\\$($LocalizationCounterTable['1424'])\"\r\n    $DiskUsageCounterPath = \"\\$($LocalizationCounterTable['234'])(*)\\$($LocalizationCounterTable['212'])\"\r\n    $NetworkUsageCounterPath = \"\\$($LocalizationCounterTable['510'])(*)\\$($LocalizationCounterTable['388'])\"\r\n\r\n    # Notify the user that performance metrics are being collected for the specified duration.\r\n    Write-Host -Object \"Collecting performance metrics for $DurationToPerformTests minutes.\"\r\n\r\n    # Collect performance metrics (CPU, memory, disk, and network usage) at a 60-second interval for the specified duration.\r\n    $PerformanceMetrics = Get-Counter -MaxSamples $DurationToPerformTests -SampleInterval 60 -Counter $OverallProcessCounterPath, $OverallMemoryCounterPath,\r\n    $ProcessorCounterPath, $MemoryCounterPath, $IOUsageCounterPath, $DiskUsageCounterPath, $NetworkUsageCounterPath -ErrorAction SilentlyContinue -ErrorVariable PerformanceMetricErrors\r\n\r\n    # Extract performance metrics for CPU, memory, I\/O, disk, and network usage from the collected data.\r\n    $OverallProcessorUsage = $PerformanceMetrics | Select-Object -ExpandProperty CounterSamples | Where-Object { $_.Path -match \"$([Regex]::Escape($($LocalizationCounterTable['6'])))$\" }\r\n    $OverallMemoryUsage = $PerformanceMetrics | Select-Object -ExpandProperty CounterSamples | Where-Object { $_.Path -match \"$([Regex]::Escape($($LocalizationCounterTable['1406'])))$\" }\r\n    $ProcessorUsage = $PerformanceMetrics | Select-Object -ExpandProperty CounterSamples | Where-Object { $_.Path -match \"$([Regex]::Escape($($LocalizationCounterTable['142'])))$\" }\r\n    $MemoryUsage = $PerformanceMetrics | Select-Object -ExpandProperty CounterSamples | Where-Object { $_.Path -match \"$([Regex]::Escape($($LocalizationCounterTable['1478'])))$\" }\r\n    $IOUsage = $PerformanceMetrics | Select-Object -ExpandProperty CounterSamples | Where-Object { $_.Path -match \"$([Regex]::Escape($($LocalizationCounterTable['1424'])))$\" }\r\n    $DiskUsage = $PerformanceMetrics | Select-Object -ExpandProperty CounterSamples | Where-Object { $_.Path -match \"$([Regex]::Escape($($LocalizationCounterTable['212'])))$\" }\r\n    $NetworkUsage = $PerformanceMetrics | Select-Object -ExpandProperty CounterSamples | Where-Object { $_.Path -match \"$([Regex]::Escape($($LocalizationCounterTable['388'])))$\" }\r\n\r\n    # If there were errors during the collection of performance metrics, display a warning message for each error.\r\n    if ($PerformanceMetricErrors) {\r\n        $PerformanceMetricErrors | ForEach-Object {\r\n            Write-Host -Object \"[Warning] $($_.Exception.Message)\"\r\n        }\r\n    }\r\n\r\n    # Ensure that performance metrics for CPU, memory, I\/O, disk, and network usage were successfully retrieved.\r\n    # If any of the metrics are missing, display an error message and exit the script.\r\n    if (!$OverallProcessorUsage -or !$OverallMemoryUsage -or !$ProcessorUsage -or !$MemoryUsage -or !$IOUsage -or !$DiskUsage -or !$NetworkUsage) {\r\n        Write-Host -Object \"[Error] Failed to retrieve performance metrics.\"\r\n        exit 1\r\n    }\r\n\r\n    # Retrieve CPU information such as name and clock speed (in GHz).\r\n    try {\r\n        $CPU = \"$(Get-CimInstance -ClassName Win32_Processor -ErrorAction Stop | Select-Object -ExpandProperty Name) $((Get-CimInstance -ClassName Win32_Processor -ErrorAction Stop | Select-Object -ExpandProperty MaxClockSpeed)\/1000) GHz\"\r\n\r\n        # Retrieve the total amount of installed physical memory (RAM) in bytes and convert it to GB.\r\n        $TotalMemoryBytes = Get-CimInstance -ClassName Win32_PhysicalMemory -ErrorAction Stop | Measure-Object -Property Capacity -Sum | Select-Object -ExpandProperty Sum\r\n        $TotalMemoryGB = \"$($TotalMemoryBytes\/1GB) GB\"\r\n    } catch {\r\n        Write-Host -Object \"[Error] Unable to get CPU or Memory details.\"\r\n        Write-Host -Object \"[Error] $($_.Exception.Message)\"\r\n        $ExitCode = 1\r\n    }\r\n\r\n    # Display the CPU information.\r\n    Write-Host -Object \"`n### $CPU ###\"\r\n\r\n    # Filter and sort the relevant CPU performance metrics for the \"_total\" instance (overall system usage).\r\n    $RelevantMetrics = $OverallProcessorUsage | Where-Object { $_.InstanceName -eq \"_total\" } | Sort-Object CookedValue\r\n\r\n    # Calculate average, minimum, and maximum CPU usage.\r\n    $CPUPerformance = [PSCustomObject]@{\r\n        Avg = [math]::Round((($RelevantMetrics | Measure-Object -Property CookedValue -Sum | Select-Object -ExpandProperty Sum) \/ $DurationToPerformTests), 2)\r\n        Min = [math]::Round(($RelevantMetrics | Select-Object -ExpandProperty CookedValue -First 1), 2)\r\n        Max = [math]::Round(($RelevantMetrics | Select-Object -ExpandProperty CookedValue -Last 1), 2)\r\n    }\r\n\r\n    # Format the CPU performance metrics for display.\r\n    $FormattedCPUPerformance = [PSCustomObject]@{\r\n        \"CPU Average %\" = \"$($CPUPerformance.Avg)%\"\r\n        \"CPU Minimum %\" = \"$($CPUPerformance.Min)%\"\r\n        \"CPU Maximum %\" = \"$($CPUPerformance.Max)%\"\r\n    }\r\n\r\n    # Display the formatted CPU performance metrics.\r\n    ($FormattedCPUPerformance | Format-Table -AutoSize | Out-String).Trim() | Write-Host\r\n\r\n    # Display memory usage header.\r\n    Write-Host -Object \"`n### Memory Usage ###\"\r\n    Write-Host -Object \"Total Memory Installed: $TotalMemoryGB\"\r\n\r\n    # Filter and sort the relevant memory usage metrics.\r\n    $RelevantMetrics = $OverallMemoryUsage | Sort-Object CookedValue\r\n\r\n    # Calculate average, minimum, and maximum memory usage.\r\n    $MemoryPerformance = [PSCustomObject]@{\r\n        Avg = [math]::Round((($RelevantMetrics | Measure-Object -Property CookedValue -Sum | Select-Object -ExpandProperty Sum) \/ $DurationToPerformTests), 2)\r\n        Min = [math]::Round(($RelevantMetrics | Select-Object -ExpandProperty CookedValue -First 1), 2)\r\n        Max = [math]::Round(($RelevantMetrics | Select-Object -ExpandProperty CookedValue -Last 1), 2)\r\n    }\r\n\r\n    # Format the memory performance metrics for display.\r\n    $OverallMemoryMetrics = [PSCustomObject]@{\r\n        \"RAM Average %\" = \"$($MemoryPerformance.Avg)%\"\r\n        \"RAM Minimum %\" = \"$($MemoryPerformance.Min)%\"\r\n        \"RAM Maximum %\" = \"$($MemoryPerformance.Max)%\"\r\n    }\r\n\r\n    # Display the formatted memory performance metrics.\r\n    ($OverallMemoryMetrics | Format-Table -AutoSize | Out-String).Trim() | Write-Host\r\n\r\n    # Display the header for the top 5 CPU processes.\r\n    Write-Host \"`n### Top 5 CPU Processes ###\"\r\n\r\n    # Get a unique list of all process names excluding the \"_total\" instance.\r\n    $AllProcessNames = $ProcessorUsage | Where-Object { $_.InstanceName -ne \"_total\" } | Sort-Object InstanceName -Unique | Select-Object -ExpandProperty InstanceName\r\n\r\n    # Initialize an empty list to store process metrics.\r\n    $Processes = New-Object -TypeName System.Collections.Generic.List[object]\r\n\r\n    # Loop through each process name to calculate the CPU usage (min, max, avg) for each process.\r\n    foreach ($ProcessName in $AllProcessNames) {\r\n        $RelevantMetrics = $ProcessorUsage | Where-Object { $_.InstanceName -eq $ProcessName }\r\n\r\n        # Group metrics by timestamp and calculate the total CPU usage for each timestamp.\r\n        $GroupedMetrics = $RelevantMetrics | Group-Object Timestamp | Select-Object @{Name = \"InstanceName\"; Expression = { $ProcessName } }, @{Name = \"CookedValue\"; Expression = { $_.Group | Measure-Object -Property CookedValue -Sum | Select-Object -ExpandProperty Sum } } | Sort-Object CookedValue\r\n\r\n        # Add the CPU usage metrics (min, max, avg) for each process to the list.\r\n        $Processes.Add(\r\n            [PSCustomObject]@{\r\n                \"InstanceName\" = $ProcessName\r\n                \"Min\"          = $GroupedMetrics | Select-Object -ExpandProperty CookedValue -First 1\r\n                \"Max\"          = $GroupedMetrics | Select-Object -ExpandProperty CookedValue -Last 1\r\n                \"Avg\"          = ($GroupedMetrics | Measure-Object -Property CookedValue -Sum | Select-Object -ExpandProperty Sum) \/ $DurationToPerformTests\r\n            }\r\n        )\r\n    }\r\n\r\n    # Sort the processes by average CPU usage in descending order and select the top 5.\r\n    $Top5CPUProcesses = $Processes | Sort-Object \"Avg\" -Descending | Select-Object -First 5\r\n\r\n    # Format the top 5 CPU processes for display.\r\n    $FormattedProcesses = $Top5CPUProcesses | ForEach-Object {\r\n        [PSCustomObject]@{\r\n            \"Process Name\"       = $_.InstanceName\r\n            \"Average CPU % Used\" = \"$([math]::Round($_.Avg, 2))%\"\r\n            \"Minimum CPU % Used\" = \"$([math]::Round($_.Min, 2))%\"\r\n            \"Maximum CPU % Used\" = \"$([math]::Round($_.Max, 2))%\"\r\n        }\r\n    }\r\n\r\n    # Display the formatted CPU process usage metrics.\r\n    ($FormattedProcesses | Format-Table -AutoSize | Out-String).Trim() | Write-Host\r\n\r\n    # Display the header for the top 5 RAM processes.\r\n    Write-Host -Object \"`n### Top 5 RAM Processes ###\"\r\n\r\n    # Get a unique list of process names that are not \"_total\" or \"memory compression\".\r\n    $AllMemoryProcessNames = $MemoryUsage | Where-Object { $_.InstanceName -ne \"_total\" -and $_.InstanceName -ne \"memory compression\" } | Sort-Object InstanceName -Unique | Select-Object -ExpandProperty InstanceName\r\n\r\n    # Initialize an empty list to store memory process metrics.\r\n    $MemoryProcesses = New-Object -TypeName System.Collections.Generic.List[object]\r\n\r\n    # Loop through each process to calculate the memory usage (min, max, avg) for each process.\r\n    foreach ($ProcessName in $AllMemoryProcessNames) {\r\n        $RelevantMetrics = $MemoryUsage | Where-Object { $_.InstanceName -eq $ProcessName }\r\n\r\n        # Group metrics by timestamp and calculate the total memory usage for each timestamp.\r\n        $GroupedMetrics = $RelevantMetrics | Group-Object Timestamp | Select-Object @{Name = \"InstanceName\"; Expression = { $ProcessName } }, @{Name = \"CookedValue\"; Expression = { $_.Group | Measure-Object -Property CookedValue -Sum | Select-Object -ExpandProperty Sum } } | Sort-Object CookedValue\r\n\r\n        # Add the memory usage metrics (min, max, avg) for each process to the list.\r\n        $MemoryProcesses.Add(\r\n            [PSCustomObject]@{\r\n                \"InstanceName\" = $ProcessName\r\n                \"Min\"          = $GroupedMetrics | Select-Object -ExpandProperty CookedValue -First 1\r\n                \"Max\"          = $GroupedMetrics | Select-Object -ExpandProperty CookedValue -Last 1\r\n                \"Avg\"          = ($GroupedMetrics | Measure-Object -Property CookedValue -Sum | Select-Object -ExpandProperty Sum) \/ $DurationToPerformTests\r\n            }\r\n        )\r\n    }\r\n\r\n    # Sort the processes by average memory usage in descending order and select the top 5.\r\n    $Top5RAMProcesses = $MemoryProcesses | Sort-Object \"Avg\" -Descending | Select-Object -First 5 | ForEach-Object {\r\n        if (!$TotalMemoryBytes) {\r\n            return\r\n        }\r\n\r\n        [PSCustomObject]@{\r\n            \"InstanceName\" = $_.InstanceName\r\n            \"Min\"          = $_.Min \/ $TotalMemoryBytes * 100\r\n            \"Max\"          = $_.Max \/ $TotalMemoryBytes * 100\r\n            \"Avg\"          = $_.Avg \/ $TotalMemoryBytes * 100\r\n        }\r\n    }\r\n\r\n    # Format the top 5 RAM processes for display.\r\n    $FormattedMemoryProcesses = $Top5RAMProcesses | ForEach-Object {\r\n        if (!$TotalMemoryBytes) {\r\n            return\r\n        }\r\n\r\n        [PSCustomObject]@{\r\n            \"Process Name\"       = $_.InstanceName\r\n            \"Average RAM % Used\" = \"$([math]::Round($_.Avg, 2))%\"\r\n            \"Minimum RAM % Used\" = \"$([math]::Round($_.Min, 2))%\"\r\n            \"Maximum RAM % Used\" = \"$([math]::Round($_.Max, 2))%\"\r\n        }\r\n    }\r\n\r\n    # Display the formatted memory process usage metrics.\r\n    ($FormattedMemoryProcesses | Format-Table -AutoSize | Out-String).Trim() | Write-Host\r\n\r\n    # Display the header for network usage.\r\n    Write-Host -Object \"`n### Network Usage ###\"\r\n\r\n    # Get a unique list of network interfaces and initialize an empty list for storing network metrics.\r\n    $NetworkInterfaces = $NetworkUsage | Sort-Object InstanceName -Unique | Select-Object -ExpandProperty InstanceName\r\n    $NetworkInterfaceUsage = New-Object -TypeName System.Collections.Generic.List[object]\r\n\r\n    # Loop through each network interface to calculate the network usage (min, max, avg) for each interface.\r\n    foreach ($NetworkInterface in $NetworkInterfaces) {\r\n        $RelevantMetrics = $NetworkUsage | Where-Object { $_.InstanceName -eq $NetworkInterface } | Sort-Object CookedValue\r\n\r\n        try {\r\n            # Correct the network interface name if necessary to match the system's adapter description.\r\n            if (!(Get-NetAdapter -ErrorAction Stop | Where-Object { $_.InterfaceDescription -eq $NetworkInterface })) {\r\n                $NetworkInterface = $NetworkInterface -replace '\\[', '(' -replace '\\]', ')'\r\n            }\r\n\r\n            # Retrieve the network adapter details and determine if it's wired, Wi-Fi, or another type.\r\n            $NetAdapter = Get-NetAdapter -ErrorAction Stop | Where-Object { $_.InterfaceDescription -eq $NetworkInterface } | Select-Object -First 1\r\n            if (!$NetAdapter.MacAddress) {\r\n                continue\r\n            }\r\n\r\n            switch -Wildcard ($NetAdapter.MediaType) {\r\n                \"802.3\" { $AdapterType = \"Wired\" }\r\n                \"*802.11\" { $AdapterType = \"Wi-Fi\" }\r\n                default { $AdapterType = \"Other\" }\r\n            }\r\n        } catch {\r\n            Write-Host -Object \"[Error] Failed to get details on the network interface '$NetworkInterface'.\"\r\n            Write-Host -Object \"[Error] $($_.Exception.Message)`n\"\r\n            $ExitCode = 1\r\n            continue\r\n        }\r\n\r\n        # Add the network adapter usage metrics to the list.\r\n        $NetworkInterfaceUsage.Add(\r\n            [PSCustomObject]@{\r\n                \"NetworkAdapter\" = $NetworkInterface\r\n                \"MacAddress\"     = $NetAdapter.MacAddress\r\n                \"Type\"           = $AdapterType\r\n                \"Min\"            = $RelevantMetrics | Select-Object -ExpandProperty CookedValue -First 1\r\n                \"Max\"            = $RelevantMetrics | Select-Object -ExpandProperty CookedValue -Last 1\r\n                \"Avg\"            = ($RelevantMetrics | Measure-Object -Property CookedValue -Sum | Select-Object -ExpandProperty Sum) \/ $DurationToPerformTests\r\n            }\r\n        )\r\n    }\r\n\r\n    # Format the network usage metrics for display.\r\n    $FormattedNetworkUsage = $NetworkInterfaceUsage | Sort-Object \"Avg\" -Descending | ForEach-Object {\r\n        [PSCustomObject]@{\r\n            \"NetworkAdapter\"          = $_.NetworkAdapter\r\n            \"MacAddress\"              = $_.MacAddress\r\n            \"Type\"                    = $_.Type\r\n            \"Average Sent & Received\" = \"$([math]::Round(($_.Avg \/ 1MB * 8), 2)) Mbps\"\r\n            \"Minimum Sent & Received\" = \"$([math]::Round(($_.Min \/ 1MB * 8), 2)) Mbps\"\r\n            \"Maximum Sent & Received\" = \"$([math]::Round(($_.Max \/ 1MB * 8), 2)) Mbps\"\r\n        }\r\n    }\r\n\r\n    # Display the formatted network usage metrics.\r\n    ($FormattedNetworkUsage | Format-List | Out-String).Trim() | Write-Host\r\n\r\n    # Display the header for disk usage.\r\n    Write-Host -Object \"`n### Disk Usage ###\"\r\n\r\n    # Get a unique list of relevant disks and initialize an empty list for storing disk metrics.\r\n    $RelevantDisks = $DiskUsage | Where-Object { $_.InstanceName -ne \"_total\" } | Sort-Object InstanceName -Unique | Select-Object -ExpandProperty InstanceName\r\n    $DiskMetrics = New-Object -TypeName System.Collections.Generic.List[object]\r\n\r\n    try {\r\n        $AllDiskNumbers = Get-Partition -ErrorAction Stop | Select-Object -ExpandProperty DiskNumber -Unique\r\n    } catch {\r\n        Write-Host -Object \"[Error] Unable to retrieve disk numbers.\"\r\n        Write-Host -Object \"[Error] $($_.Exception.Message)\"\r\n        $ExitCode = 1\r\n    }\r\n\r\n    # Loop through each disk to calculate the disk usage (min, max, avg) for each disk.\r\n    foreach ($RelevantDisk in $RelevantDisks) {\r\n        $RelevantMetrics = $DiskUsage | Where-Object { $_.InstanceName -eq $RelevantDisk } | Sort-Object CookedValue\r\n\r\n        # Parse the disk number and drive letter from the instance name.\r\n        $DiskNumber = $RelevantDisk -split '\\s' | Where-Object { $_ -match \"^[0-9]$\" }\r\n        $DriveLetters = ($RelevantDisk -split '\\s' | Where-Object { $_ -match \"^[A-z]:$\" }) -replace ':'\r\n\r\n        # Retrieve the physical disk based on the provided DiskNumber.\r\n        $PhysicalDisk = Get-PhysicalDisk -ErrorAction SilentlyContinue | Where-Object { $_.DeviceId -eq $DiskNumber }\r\n\r\n        # Check if the disk number is part of the list of all disk numbers.\r\n        if ($AllDiskNumbers -and $AllDiskNumbers -notcontains $DiskNumber) {\r\n\r\n            # If the physical disk has a FriendlyName (meaning it was found), warn that no partitions were found on this disk.\r\n            if ($PhysicalDisk.FriendlyName) {\r\n                Write-Host -Object \"[Warning] No partitions found on disk '$($PhysicalDisk.FriendlyName)'.\"\r\n            } else {\r\n                # If the physical disk has no FriendlyName, display a warning message using the DiskNumber.\r\n                Write-Host -Object \"[Warning] No partitions found on disk '$DiskNumber'.\"\r\n            }\r\n\r\n            Write-Host -Object \"\"\r\n\r\n            # Continue to the next iteration in the loop, skipping the remaining code for this disk number.\r\n            continue\r\n        }\r\n\r\n        # Attempt to retrieve the partitions for the specified disk number.\r\n        try {\r\n            $Partitions = Get-Partition -DiskNumber $DiskNumber -ErrorAction Stop\r\n        } catch {\r\n            # If an error occurs while getting the partitions, display an error message.\r\n            Write-Host -Object \"[Error] Accessing Partitions on disk '$DiskNumber'\"\r\n\r\n            # Display the exception message from the caught error.\r\n            Write-Host -Object \"[Error] $($_.Exception.Message)`n\"\r\n\r\n            # Set the exit code to indicate an error occurred.\r\n            $ExitCode = 1\r\n\r\n            # Continue to the next iteration in the loop, skipping further actions for this disk number.\r\n            continue\r\n        }\r\n\r\n        # Retrieve partition information and add the disk usage metrics to the list.\r\n        foreach ($DriveLetter in $DriveLetters) {\r\n            $Partitions | Where-Object { $_.DriveLetter -eq $DriveLetter } | ForEach-Object {\r\n                try {\r\n                    $FreeSpace = Get-Volume -ErrorAction Stop | Where-Object { $_.DriveLetter -eq $DriveLetter } | Select-Object -ExpandProperty SizeRemaining\r\n                    $TotalSize = Get-Volume -ErrorAction Stop | Where-Object { $_.DriveLetter -eq $DriveLetter } | Select-Object -ExpandProperty Size\r\n                } catch {\r\n                    Write-Host -Object \"[Error] Unable to determine the total size or free space of drive '$DriveLetter'.\"\r\n                    Write-Host -Object \"[Error] $($_.Exception.Message)`n\"\r\n                    $ExitCode = 1\r\n                    continue\r\n                }\r\n\r\n                $FreeSpaceGB = [math]::Round(($FreeSpace \/ 1GB), 2)\r\n                $FreeSpacePercent = [math]::Round(($FreeSpace \/ $TotalSize * 100), 2)\r\n                $TotalSpaceGB = [math]::Round(($TotalSize \/ 1GB), 2)\r\n\r\n                # Add the disk metrics to the list.\r\n                $DiskMetrics.Add(\r\n                    [PSCustomObject]@{\r\n                        \"DriveLetter\"      = $_.DriveLetter\r\n                        \"FreeSpaceGB\"      = $FreeSpaceGB\r\n                        \"FreeSpacePercent\" = $FreeSpacePercent\r\n                        \"TotalSpace\"       = \"$TotalSpaceGB GB\"\r\n                        \"PhysicalDisk\"     = $PhysicalDisk | Select-Object -ExpandProperty FriendlyName\r\n                        \"MediaType\"        = $PhysicalDisk | Select-Object -ExpandProperty MediaType\r\n                        \"Min\"              = $RelevantMetrics | Select-Object -ExpandProperty CookedValue -First 1\r\n                        \"Max\"              = $RelevantMetrics | Select-Object -ExpandProperty CookedValue -Last 1\r\n                        \"Avg\"              = ($RelevantMetrics | Measure-Object -Property CookedValue -Sum | Select-Object -ExpandProperty Sum) \/ $DurationToPerformTests\r\n                    }\r\n                )\r\n            }\r\n        }\r\n    }\r\n\r\n    # Add the disk metrics to the list.\r\n    $FormattedDiskMetrics = $DiskMetrics | Sort-Object \"Avg\" -Descending | ForEach-Object {\r\n        [PSCustomObject]@{\r\n            \"DriveLetter\"  = $_.DriveLetter\r\n            \"FreeSpace\"    = \"$($_.FreeSpaceGB) GB ($($_.FreeSpacePercent)%)\"\r\n            \"TotalSpace\"   = $_.TotalSpace\r\n            \"PhysicalDisk\" = $_.PhysicalDisk\r\n            \"MediaType\"    = $_.MediaType\r\n            \"Average IOPS\" = \"$([math]::Round(($_.Avg), 2)) IOPS\"\r\n            \"Minimum IOPS\" = \"$([math]::Round(($_.Min), 2)) IOPS\"\r\n            \"Maximum IOPS\" = \"$([math]::Round(($_.Max), 2)) IOPS\"\r\n        }\r\n    }\r\n\r\n    # Display the formatted disk usage metrics.\r\n    ($FormattedDiskMetrics | Format-List | Out-String).Trim() | Write-Host\r\n\r\n    # Display the header for top 5 I\/O processes (network and disk combined).\r\n    Write-Host -Object \"`n### Top 5 IO Processes (Network & Disk Combined) ###\"\r\n\r\n    # Get a unique list of I\/O process names excluding the \"_total\" instance.\r\n    $AllIOProcessNames = $IOUsage | Where-Object { $_.InstanceName -ne \"_total\" } | Sort-Object InstanceName -Unique | Select-Object -ExpandProperty InstanceName\r\n    $IOProcesses = New-Object -TypeName System.Collections.Generic.List[object]\r\n\r\n    # Loop through each process to calculate the I\/O usage (min, max, avg) for each process.\r\n    foreach ($ProcessName in $AllIOProcessNames) {\r\n        $RelevantMetrics = $IOUsage | Where-Object { $_.InstanceName -eq $ProcessName }\r\n\r\n        # Group metrics by timestamp and calculate the total I\/O usage for each timestamp.\r\n        $GroupedMetrics = $RelevantMetrics | Group-Object Timestamp | Select-Object @{Name = \"InstanceName\"; Expression = { $ProcessName } }, @{Name = \"CookedValue\"; Expression = { $_.Group | Measure-Object -Property CookedValue -Sum | Select-Object -ExpandProperty Sum } } | Sort-Object CookedValue\r\n\r\n        # Add the I\/O usage metrics to the list.\r\n        $IOProcesses.Add(\r\n            [PSCustomObject]@{\r\n                \"InstanceName\" = $ProcessName\r\n                \"Min\"          = $GroupedMetrics | Select-Object -ExpandProperty CookedValue -First 1\r\n                \"Max\"          = $GroupedMetrics | Select-Object -ExpandProperty CookedValue -Last 1\r\n                \"Avg\"          = ($GroupedMetrics | Measure-Object -Property CookedValue -Sum | Select-Object -ExpandProperty Sum) \/ $DurationToPerformTests\r\n            }\r\n        )\r\n    }\r\n\r\n    # Sort the I\/O processes by average I\/O usage and select the top 5.\r\n    $Top5IOProcesses = $IOProcesses | Sort-Object \"Avg\" -Descending | Select-Object -First 5\r\n\r\n    # Format the top 5 I\/O processes for display.\r\n    $FormattedIOProcesses = $Top5IOProcesses | ForEach-Object {\r\n        [PSCustomObject]@{\r\n            \"Process Name\"    = $_.InstanceName\r\n            \"Average IO Used\" = \"$([math]::Round(($_.Avg \/ 1MB * 8), 4)) Mbps\"\r\n            \"Minimum IO Used\" = \"$([math]::Round(($_.Min \/ 1MB * 8), 4)) Mbps\"\r\n            \"Maximum IO Used\" = \"$([math]::Round(($_.Max \/ 1MB * 8), 4)) Mbps\"\r\n        }\r\n    }\r\n\r\n    # Display the formatted I\/O process usage metrics.\r\n    ($FormattedIOProcesses | Format-Table -AutoSize | Out-String).Trim() | Write-Host\r\n\r\n    # Inform the user that WinSAT assessments are running.\r\n    Write-Host -Object \"`nRetrieving WinSAT assessment data.\"\r\n    Write-Host -Object \"More info: https:\/\/learn.microsoft.com\/en-us\/previous-versions\/windows\/it-pro\/windows-8.1-and-8\/hh825488(v=win.10)\"\r\n\r\n    # Retrieve the WinSAT assessment scores.\r\n    try {\r\n        $WinSatScores = Get-CimInstance -ClassName Win32_WinSAT -ErrorAction Stop\r\n    } catch {\r\n        Write-Host -Object \"[Error] Unable to retrieve WinSat assessment results.\"\r\n        Write-Host -Object \"[Error] $($_.Exception.Message)\"\r\n        $ExitCode = 1\r\n    }\r\n\r\n    # Handle the different possible states of the WinSAT assessment.\r\n    switch ($WinSatScores.WinSATAssessmentState) {\r\n        0 { Write-Host -Object \"[Error] WinSAT assessment data is not available on this computer. Is this computer a virtual machine?\" ; $ExitCode = 1 }\r\n        1 { Write-Host -Object \"Successfully retrieved assessment data.\" }\r\n        2 { Write-Host -Object \"[Warning] The WinSAT assessment data does not match the current computer configuration.\" }\r\n        3 { Write-Host -Object \"[Error] WinSAT assessment data is not available on this computer. Is this computer a virtual machine?\" ; $ExitCode = 1 }\r\n        4 { Write-Host -Object \"[Error] The WinSAT assessment data is not valid!\" ; $ExitCode = 1 }\r\n        default {\r\n            Write-Host -Object \"[Error] WinSAT assessment data is not available on this computer. Is this computer a virtual machine?\" ; $ExitCode = 1\r\n        }\r\n    }\r\n\r\n    # If the WinSAT assessment state is valid, display the assessment scores.\r\n    $ValidAssessmentStates = \"1\", \"2\"\r\n    if ($ValidAssessmentStates -contains $WinSatScores.WinSATAssessmentState) {\r\n        Write-Host -Object \"`n### WinSAT Scores ###\"\r\n        ($WinSatScores | Format-Table -Property CPUScore, D3DScore, DiskScore, GraphicsScore, MemoryScore | Out-String).Trim() | Write-Host\r\n    }\r\n\r\n    # If the WYSIWYG custom field is given, proceed to set and format the custom field.\r\n    if ($WysiwygCustomField) {\r\n        try {\r\n            # Inform the user that the custom field is being set.\r\n            Write-Host \"`nAttempting to set Custom Field '$WysiwygCustomField'.\"\r\n\r\n            $CompletedDateTime = Get-Date\r\n\r\n            # Initialize the custom field value as a list of strings.\r\n            $CustomFieldValue = New-Object System.Collections.Generic.List[String]\r\n            $CustomFieldValue.Add(\"<div>\")\r\n\r\n            # Convert the formatted CPU processes table to HTML and add custom formatting.\r\n            $CPUProcessMetricTable = $FormattedProcesses | ConvertTo-Html -Fragment\r\n            $CPUProcessMetricTable = $CPUProcessMetricTable -replace \"<th>\", \"<th><b>\" -replace \"<\/th>\", \"<\/b><\/th>\"\r\n            $CPUProcessMetricTable = $CPUProcessMetricTable -replace \"<table>\", \"<table><caption style='border-top: 1px; border-left: 1px; border-right: 1px; border-style: solid; border-color: #CAD0D6'><b>Top 5 CPU Processes<\/b><\/caption>\"\r\n            $CPUProcessMetricTable = $CPUProcessMetricTable -replace \"Average CPU % Used\", \"<i class='fa-solid fa-arrow-down-up-across-line'><\/i>&nbsp;&nbsp;Average CPU % Used\"\r\n            $CPUProcessMetricTable = $CPUProcessMetricTable -replace \"Minimum CPU % Used\", \"<i class='fa-solid fa-arrows-down-to-line'><\/i>&nbsp;&nbsp;Minimum CPU % Used\"\r\n            $CPUProcessMetricTable = $CPUProcessMetricTable -replace \"Maximum CPU % Used\", \"<i class='fa-solid fa-arrows-up-to-line'><\/i>&nbsp;&nbsp;Maximum CPU % Used\"\r\n\r\n            # Highlight rows in the CPU table based on CPU usage thresholds (warnings and danger levels).\r\n            $Top5CPUProcesses | ForEach-Object {\r\n                if ($_.Avg -ge 20 -and $_.Avg -lt 50) { $CPUProcessMetricTable = $CPUProcessMetricTable -replace \"<tr><td>$($_.InstanceName)\", \"<tr class='warning'><td>$($_.InstanceName)\" }\r\n                if ($_.Min -ge 20 -and $_.Min -lt 50) { $CPUProcessMetricTable = $CPUProcessMetricTable -replace \"<tr><td>$($_.InstanceName)\", \"<tr class='warning'><td>$($_.InstanceName)\" }\r\n                if ($_.Max -ge 20 -and $_.Max -lt 50) { $CPUProcessMetricTable = $CPUProcessMetricTable -replace \"<tr><td>$($_.InstanceName)\", \"<tr class='warning'><td>$($_.InstanceName)\" }\r\n\r\n                if ($_.Avg -ge 50) { $CPUProcessMetricTable = $CPUProcessMetricTable -replace \"<tr><td>$($_.InstanceName)\", \"<tr class='danger'><td>$($_.InstanceName)\" }\r\n                if ($_.Min -ge 50) { $CPUProcessMetricTable = $CPUProcessMetricTable -replace \"<tr><td>$($_.InstanceName)\", \"<tr class='danger'><td>$($_.InstanceName)\" }\r\n                if ($_.Max -ge 50) { $CPUProcessMetricTable = $CPUProcessMetricTable -replace \"<tr><td>$($_.InstanceName)\", \"<tr class='danger'><td>$($_.InstanceName)\" }\r\n            }\r\n\r\n            # Convert the formatted RAM processes table to HTML and add custom formatting.\r\n            $RAMProcessMetricTable = $FormattedMemoryProcesses | ConvertTo-Html -Fragment\r\n            $RAMProcessMetricTable = $RAMProcessMetricTable -replace \"<th>\", \"<th><b>\" -replace \"<\/th>\", \"<\/b><\/th>\"\r\n            $RAMProcessMetricTable = $RAMProcessMetricTable -replace \"<table>\", \"<table><caption style='border-top: 1px; border-left: 1px; border-right: 1px; border-style: solid; border-color: #CAD0D6'><b>Top 5 RAM Processes<\/b><\/caption>\"\r\n            $RAMProcessMetricTable = $RAMProcessMetricTable -replace \"Average RAM % Used\", \"<i class='fa-solid fa-arrow-down-up-across-line'><\/i>&nbsp;&nbsp;Average RAM % Used\"\r\n            $RAMProcessMetricTable = $RAMProcessMetricTable -replace \"Minimum RAM % Used\", \"<i class='fa-solid fa-arrows-down-to-line'><\/i>&nbsp;&nbsp;Minimum RAM % Used\"\r\n            $RAMProcessMetricTable = $RAMProcessMetricTable -replace \"Maximum RAM % Used\", \"<i class='fa-solid fa-arrows-up-to-line'><\/i>&nbsp;&nbsp;Maximum RAM % Used\"\r\n\r\n            # Highlight rows in the RAM table based on RAM usage thresholds (warnings and danger levels).\r\n            $Top5RAMProcesses | ForEach-Object {\r\n                if ($_.Avg -ge 10 -and $_.Avg -lt 30) { $RAMProcessMetricTable = $RAMProcessMetricTable -replace \"<tr><td>$($_.InstanceName)\", \"<tr class='warning'><td>$($_.InstanceName)\" }\r\n                if ($_.Min -ge 10 -and $_.Min -lt 30) { $RAMProcessMetricTable = $RAMProcessMetricTable -replace \"<tr><td>$($_.InstanceName)\", \"<tr class='warning'><td>$($_.InstanceName)\" }\r\n                if ($_.Max -ge 10 -and $_.Max -lt 30) { $RAMProcessMetricTable = $RAMProcessMetricTable -replace \"<tr><td>$($_.InstanceName)\", \"<tr class='warning'><td>$($_.InstanceName)\" }\r\n\r\n                if ($_.Avg -ge 30) { $RAMProcessMetricTable = $RAMProcessMetricTable -replace \"<tr><td>$($_.InstanceName)\", \"<tr class='danger'><td>$($_.InstanceName)\" }\r\n                if ($_.Min -ge 30) { $RAMProcessMetricTable = $RAMProcessMetricTable -replace \"<tr><td>$($_.InstanceName)\", \"<tr class='danger'><td>$($_.InstanceName)\" }\r\n                if ($_.Max -ge 30) { $RAMProcessMetricTable = $RAMProcessMetricTable -replace \"<tr><td>$($_.InstanceName)\", \"<tr class='danger'><td>$($_.InstanceName)\" }\r\n            }\r\n\r\n            # Convert the formatted I\/O processes table to HTML and add custom formatting.\r\n            $IOProcessesMetricTable = $FormattedIOProcesses | ConvertTo-Html -Fragment\r\n            $IOProcessesMetricTable = $IOProcessesMetricTable -replace \"<th>\", \"<th><b>\" -replace \"<\/th>\", \"<\/b><\/th>\"\r\n            $IOProcessesMetricTable = $IOProcessesMetricTable -replace \"<table>\", \"<table><caption style='border-top: 1px; border-left: 1px; border-right: 1px; border-style: solid; border-color: #CAD0D6'><b>Top 5 IO Processes (Network & Disk Combined)<\/b><\/caption>\"\r\n            $IOProcessesMetricTable = $IOProcessesMetricTable -replace \"Average IO Used\", \"<i class='fa-solid fa-arrow-down-up-across-line'><\/i>&nbsp;&nbsp;Average IO Used\"\r\n            $IOProcessesMetricTable = $IOProcessesMetricTable -replace \"Minimum IO Used\", \"<i class='fa-solid fa-arrows-down-to-line'><\/i>&nbsp;&nbsp;Minimum IO Used\"\r\n            $IOProcessesMetricTable = $IOProcessesMetricTable -replace \"Maximum IO Used\", \"<i class='fa-solid fa-arrows-up-to-line'><\/i>&nbsp;&nbsp;Maximum IO Used\"\r\n\r\n            # Highlight rows in the I\/O table based on I\/O usage thresholds (warnings and danger levels).\r\n            $Top5IOProcesses | ForEach-Object {\r\n                if ($_.Avg -ge 1250000 -and $_.Avg -lt 12500000) { $IOProcessesMetricTable = $IOProcessesMetricTable -replace \"<tr><td>$($_.InstanceName)\", \"<tr class='warning'><td>$($_.InstanceName)\" }\r\n                if ($_.Min -ge 1250000 -and $_.Min -lt 12500000) { $IOProcessesMetricTable = $IOProcessesMetricTable -replace \"<tr><td>$($_.InstanceName)\", \"<tr class='warning'><td>$($_.InstanceName)\" }\r\n                if ($_.Max -ge 1250000 -and $_.Max -lt 12500000) { $IOProcessesMetricTable = $IOProcessesMetricTable -replace \"<tr><td>$($_.InstanceName)\", \"<tr class='warning'><td>$($_.InstanceName)\" }\r\n\r\n                if ($_.Avg -ge 12500000) { $IOProcessesMetricTable = $IOProcessesMetricTable -replace \"<tr><td>$($_.InstanceName)\", \"<tr class='danger'><td>$($_.InstanceName)\" }\r\n                if ($_.Min -ge 12500000) { $IOProcessesMetricTable = $IOProcessesMetricTable -replace \"<tr><td>$($_.InstanceName)\", \"<tr class='danger'><td>$($_.InstanceName)\" }\r\n                if ($_.Max -ge 12500000) { $IOProcessesMetricTable = $IOProcessesMetricTable -replace \"<tr><td>$($_.InstanceName)\", \"<tr class='danger'><td>$($_.InstanceName)\" }\r\n            }\r\n\r\n            # Convert the formatted network usage table to HTML and add custom formatting.\r\n            $NetworkUsageMetricTable = $FormattedNetworkUsage | ConvertTo-Html -Fragment\r\n            $NetworkUsageMetricTable = $NetworkUsageMetricTable -replace \"<th>\", \"<th><b>\" -replace \"<\/th>\", \"<\/b><\/th>\"\r\n            $NetworkUsageMetricTable = $NetworkUsageMetricTable -replace \"<table>\", \"<table><caption style='border-top: 1px; border-left: 1px; border-right: 1px; border-style: solid; border-color: #CAD0D6'><b>Network Usage<\/b><\/caption>\"\r\n            $NetworkUsageMetricTable = $NetworkUsageMetricTable -replace \"Average Sent & Received\", \"<i class='fa-solid fa-arrow-down-up-across-line'><\/i>&nbsp;&nbsp;Average Sent & Received\"\r\n            $NetworkUsageMetricTable = $NetworkUsageMetricTable -replace \"Minimum Sent & Received\", \"<i class='fa-solid fa-arrows-down-to-line'><\/i>&nbsp;&nbsp;Minimum Sent & Received\"\r\n            $NetworkUsageMetricTable = $NetworkUsageMetricTable -replace \"Maximum Sent & Received\", \"<i class='fa-solid fa-arrows-up-to-line'><\/i>&nbsp;&nbsp;Maximum Sent & Received\"\r\n\r\n            # Add network type icons for wired, Wi-Fi, and other network interfaces.\r\n            $NetworkUsageMetricTable = $NetworkUsageMetricTable -replace \"<th><b>Type<\/b><\/th>\", \"<th><b><i class='fa-solid fa-network-wired'><\/i>&nbsp;&nbsp;Type<\/b><\/th>\"\r\n            $NetworkUsageMetricTable = $NetworkUsageMetricTable -replace \"<td>Wired<\/td>\", \"<td><i class='fa-solid fa-ethernet'><\/i>&nbsp;&nbsp;Wired<\/td>\"\r\n            $NetworkUsageMetricTable = $NetworkUsageMetricTable -replace \"<td>Wi-Fi<\/td>\", \"<td><i class='fa-solid fa-wifi'><\/i>&nbsp;&nbsp;Wi-Fi<\/td>\"\r\n            $NetworkUsageMetricTable = $NetworkUsageMetricTable -replace \"<td>Other<\/td>\", \"<td><i class='fa-solid fa-circle-question'><\/i>&nbsp;&nbsp;Other<\/td>\"\r\n\r\n            # Highlight network interfaces based on network usage thresholds and interface types.\r\n            $NetworkInterfaceUsage | ForEach-Object {\r\n                if ($_.Avg -ge 1250000 -and $_.Avg -lt 12500000) { $NetworkUsageMetricTable = $NetworkUsageMetricTable -replace \"<tr><td>$($_.NetworkAdapter)\", \"<tr class='warning'><td>$($_.NetworkAdapter)\" }\r\n                if ($_.Min -ge 1250000 -and $_.Min -lt 12500000) { $NetworkUsageMetricTable = $NetworkUsageMetricTable -replace \"<tr><td>$($_.NetworkAdapter)\", \"<tr class='warning'><td>$($_.NetworkAdapter)\" }\r\n                if ($_.Max -ge 1250000 -and $_.Max -lt 12500000) { $NetworkUsageMetricTable = $NetworkUsageMetricTable -replace \"<tr><td>$($_.NetworkAdapter)\", \"<tr class='warning'><td>$($_.NetworkAdapter)\" }\r\n\r\n                if ($_.Avg -ge 12500000) { $NetworkUsageMetricTable = $NetworkUsageMetricTable -replace \"<tr><td>$($_.NetworkAdapter)\", \"<tr class='danger'><td>$($_.NetworkAdapter)\" }\r\n                if ($_.Min -ge 12500000) { $NetworkUsageMetricTable = $NetworkUsageMetricTable -replace \"<tr><td>$($_.NetworkAdapter)\", \"<tr class='danger'><td>$($_.NetworkAdapter)\" }\r\n                if ($_.Max -ge 12500000) { $NetworkUsageMetricTable = $NetworkUsageMetricTable -replace \"<tr><td>$($_.NetworkAdapter)\", \"<tr class='danger'><td>$($_.NetworkAdapter)\" }\r\n\r\n                # Highlight Wi-Fi or \"Other\" types as warnings.\r\n                if ($_.Type -eq \"Wi-Fi\" -or $_.Type -eq \"Other\") {\r\n                    $NetworkUsageMetricTable = $NetworkUsageMetricTable -replace \"<tr><td>$($_.NetworkAdapter)\", \"<tr class='warning'><td>$($_.NetworkAdapter)\"\r\n                }\r\n            }\r\n\r\n            # Convert the formatted disk usage table to HTML and add custom formatting.\r\n            $DiskMetricTable = $FormattedDiskMetrics | ConvertTo-Html -Fragment\r\n            $DiskMetricTable = $DiskMetricTable -replace \"<th>\", \"<th><b>\" -replace \"<\/th>\", \"<\/b><\/th>\"\r\n            $DiskMetricTable = $DiskMetricTable -replace \"<table>\", \"<table><caption style='border-top: 1px; border-left: 1px; border-right: 1px; border-style: solid; border-color: #CAD0D6'><b>Disk Usage<\/b><\/caption>\"\r\n            $DiskMetricTable = $DiskMetricTable -replace \"Average IOPS\", \"<i class='fa-solid fa-arrow-down-up-across-line'><\/i>&nbsp;&nbsp;Average IOPS\"\r\n            $DiskMetricTable = $DiskMetricTable -replace \"Minimum IOPS\", \"<i class='fa-solid fa-arrows-down-to-line'><\/i>&nbsp;&nbsp;Minimum IOPS\"\r\n            $DiskMetricTable = $DiskMetricTable -replace \"Maximum IOPS\", \"<i class='fa-solid fa-arrows-up-to-line'><\/i>&nbsp;&nbsp;Maximum IOPS\"\r\n\r\n            # Highlight rows in the disk usage table based on drive type and available space thresholds.\r\n            $DiskMetrics | ForEach-Object {\r\n                if ($_.MediaType -ne \"SSD\" -and $_.MediaType -ne \"Unspecified\") {\r\n                    $DiskMetricTable = $DiskMetricTable -replace \"<tr><td>$($_.DriveLetter)\", \"<tr class='danger'><td>$($_.DriveLetter)\"\r\n                }\r\n\r\n                if ($_.FreeSpaceGB -lt 100) {\r\n                    $DiskMetricTable = $DiskMetricTable -replace \"<tr><td>$($_.DriveLetter)\", \"<tr class='warning'><td>$($_.DriveLetter)\"\r\n                }\r\n\r\n                if ($_.FreeSpaceGB -lt 10) {\r\n                    $DiskMetricTable = $DiskMetricTable -replace \"<tr class='warning'><td>$($_.DriveLetter)\", \"<tr class='danger'><td>$($_.DriveLetter)\"\r\n                }\r\n            }\r\n\r\n            # Handle WinSAT assessment data if it's valid and add the WinSAT scores to the table.\r\n            $ValidAssessmentStates = \"1\", \"2\"\r\n            if ($ValidAssessmentStates -contains $WinSatScores.WinSATAssessmentState) {\r\n                $WinSATMetricTable = $WinSatScores | Select-Object -Property CPUScore, D3DScore, DiskScore, GraphicsScore, MemoryScore | ConvertTo-Html -Fragment\r\n                $WinSATMetricTable = $WinSATMetricTable -replace \"<th>\", \"<th><b>\" -replace \"<\/th>\", \"<\/b><\/th>\"\r\n                $WinSATMetricTable = $WinSATMetricTable -replace \"<table>\", \"<br><table><caption style='border-top: 1px; border-left: 1px; border-right: 1px; border-style: solid; border-color: #CAD0D6'><b>WinSAT Scores<\/b><\/caption>\"\r\n\r\n                # Highlight rows in the WinSAT table based on score thresholds.\r\n                if ($WinSatScores.CPUScore -lt 7 -or $WinSatScores.D3DScore -lt 7 -or $WinSatScores.DiskScore -lt 7 -or $WinSatScores.GraphicsScore -lt 7 -or $WinSatScores.MemoryScore -lt 7) {\r\n                    $WinSATMetricTable = $WinSATMetricTable -replace \"<tr><td>\", \"<tr class='warning'><td>\"\r\n                }\r\n\r\n                if ($WinSatScores.CPUScore -lt 4 -or $WinSatScores.D3DScore -lt 4 -or $WinSatScores.DiskScore -lt 4 -or $WinSatScores.GraphicsScore -lt 4 -or $WinSatScores.MemoryScore -lt 4) {\r\n                    $WinSATMetricTable = $WinSATMetricTable -replace \"<tr class='warning'><td>\", \"<tr class='danger'><td>\"\r\n                }\r\n            } else {\r\n                # If WinSAT data is not available, display a message.\r\n                $WinSATMetricTable = \"<p style='margin-top: 0px'>The WinSAT assessment data is either invalid or not available for this computer.<\/p>\"\r\n            }\r\n\r\n            # Create the HTML content for the performance metrics section.\r\n            $HTMLCard = \"<div class='card flex-grow-1'>\r\n    <div class='card-title-box'>\r\n        <div class='card-title'><i class='fa-solid fa-gauge-high'><\/i>&nbsp;&nbsp;System Performance Metrics<\/div>\r\n    <\/div>\r\n    <div class='card-body' style='white-space: nowrap'>\r\n        <div class='container' style='padding-left: 0px'>\r\n            <div class='row'>\r\n                <div class='col-sm'>\r\n                    <p class='card-text'><b>Start Date and Time<\/b><br>$($StartedDateTime.ToShortDateString()) $($StartedDateTime.ToShortTimeString())<\/p>\r\n                <\/div>\r\n                <div class='col-sm'>\r\n                    <p class='card-text'><b>Completed Date and Time<\/b><br>$($CompletedDateTime.ToShortDateString()) $($CompletedDateTime.ToShortTimeString())<\/p>\r\n                <\/div>\r\n            <\/div>\r\n        <\/div>\r\n        <p id='lastStartup' class='card-text'><b>Last Startup Time<\/b><br>$($LastStartTime.ToShortDateString()) $($LastStartTime.ToShortTimeString())<\/p>\r\n        <div class='container my-4' style='padding-left: 0px; margin-left: 0px; padding-right: 0px; margin-right: 0px;'>\r\n            <div class='row' style='padding-left: 0px'>\r\n                <p><b>$CPU<\/b><\/p>\r\n            <\/div>\r\n            <div class='row' style='padding-left: 0px'>\r\n                <div class='col-sm-4'>\r\n                    <div class='stat-card' style='display: flex;'>\r\n                        <div class='stat-value' id='cpuOverallAvg' style='color: #008001;'>$($FormattedCPUPerformance.\"CPU Average %\")<\/div>\r\n                        <div class='stat-desc'><i class='fa-solid fa-arrow-down-up-across-line'><\/i>&nbsp;&nbsp;Average CPU % Used<\/div>\r\n                    <\/div>\r\n                <\/div>\r\n                <div class='col-sm-4'>\r\n                    <div class='stat-card' style='display: flex;'>\r\n                        <div class='stat-value' id='cpuOverallMin' style='color: #008001;'>$($FormattedCPUPerformance.\"CPU Minimum %\")<\/div>\r\n                        <div class='stat-desc'><i class='fa-solid fa-arrows-down-to-line'><\/i>&nbsp;&nbsp;Minimum CPU % Used<\/div>\r\n                    <\/div>\r\n                <\/div>\r\n                <div class='col-sm-4'>\r\n                    <div class='stat-card' style='display: flex;'>\r\n                        <div class='stat-value' id='cpuOverallMax' style='color: #008001;'>$($FormattedCPUPerformance.\"CPU Maximum %\")<\/div>\r\n                        <div class='stat-desc'><i class='fa-solid fa-arrows-up-to-line'><\/i>&nbsp;&nbsp;Maximum CPU % Used<\/div>\r\n                    <\/div>\r\n                <\/div>\r\n            <\/div>\r\n            <div class='row' style='padding-left: 0px'>\r\n                <p><b>Total Memory: $TotalMemoryGB<\/b><\/p>\r\n            <\/div>\r\n            <div class='row' style='padding-left: 0px'>\r\n                <div class='col-sm-4'>\r\n                    <div class='stat-card' style='display: flex;'>\r\n                        <div class='stat-value' id='ramOverallAvg' style='color: #008001;'>$($OverallMemoryMetrics.\"RAM Average %\")<\/div>\r\n                        <div class='stat-desc'><i class='fa-solid fa-arrow-down-up-across-line'><\/i>&nbsp;&nbsp;Average RAM % Used<\/div>\r\n                    <\/div>\r\n                <\/div>\r\n                <div class='col-sm-4'>\r\n                    <div class='stat-card' style='display: flex;'>\r\n                        <div class='stat-value' id='ramOverallMin' style='color: #008001;'>$($OverallMemoryMetrics.\"RAM Minimum %\")<\/div>\r\n                        <div class='stat-desc'><i class='fa-solid fa-arrows-down-to-line'><\/i>&nbsp;&nbsp;Minimum RAM % Used<\/div>\r\n                    <\/div>\r\n                <\/div>\r\n                <div class='col-sm-4'>\r\n                    <div class='stat-card' style='display: flex;'>\r\n                        <div class='stat-value' id='ramOverallMax' style='color: #008001;'>$($OverallMemoryMetrics.\"RAM Maximum %\")<\/div>\r\n                        <div class='stat-desc'><i class='fa-solid fa-arrows-up-to-line'><\/i>&nbsp;&nbsp;Maximum RAM % Used<\/div>\r\n                    <\/div>\r\n                <\/div>\r\n            <\/div>\r\n        <\/div>\r\n        $CPUProcessMetricTable\r\n        <br>\r\n        $RAMProcessMetricTable\r\n        <br>\r\n        $NetworkUsageMetricTable\r\n        <br>\r\n        $DiskMetricTable\r\n        <br>\r\n        $IOProcessesMetricTable\r\n        $(if($ValidAssessmentStates -notcontains $WinSatScores.WinSATAssessmentState) {\"<p style='margin-bottom: 0px'><b>WinSAT Scores<\/b><\/p>\"})\r\n        $WinSATMetricTable\r\n    <\/div>\r\n<\/div>\"\r\n            # Modify the last startup time section based on whether the startup limit was exceeded or not.\r\n            if ($ExceededLastStartupLimit) {\r\n                $HTMLCard = $HTMLCard -replace \"id='lastStartup' class='card-text'><b>Last Startup Time<\/b><br>$($LastStartTime.ToShortDateString()) $($LastStartTime.ToShortTimeString())\", \"id='lastStartup' class='card-text'><b>Last Startup Time<\/b><br>$($LastStartTime.ToShortDateString()) $($LastStartTime.ToShortTimeString())&nbsp;&nbsp;<i class='fa-solid fa-circle-exclamation' style='color: #D53948;'><\/i>\"\r\n            } elseif ($DaysSinceLastReboot -ge 0) {\r\n                $HTMLCard = $HTMLCard -replace \"id='lastStartup' class='card-text'><b>Last Startup Time<\/b><br>$($LastStartTime.ToShortDateString()) $($LastStartTime.ToShortTimeString())\", \"id='lastStartup' class='card-text'><b>Last Startup Time<\/b><br>$($LastStartTime.ToShortDateString()) $($LastStartTime.ToShortTimeString())&nbsp;&nbsp;<i class='fa-solid fa-circle-check' style='color: #008001;'><\/i>\"\r\n            }\r\n\r\n            # Highlight CPU performance metrics based on threshold values (color coding).\r\n            if ($CPUPerformance.Avg -ge 60 -and $CPUPerformance.Avg -lt 90) { $HTMLCard = $HTMLCard -replace \"id='cpuOverallAvg' style='color: #008001;'\", \"id='cpuOverallAvg' style='color: #FAC905;'\" }\r\n            if ($CPUPerformance.Min -ge 60 -and $CPUPerformance.Min -lt 90) { $HTMLCard = $HTMLCard -replace \"id='cpuOverallMin' style='color: #008001;'\", \"id='cpuOverallMin' style='color: #FAC905;'\" }\r\n            if ($CPUPerformance.Max -ge 60 -and $CPUPerformance.Max -lt 90) { $HTMLCard = $HTMLCard -replace \"id='cpuOverallMax' style='color: #008001;'\", \"id='cpuOverallMax' style='color: #FAC905;'\" }\r\n\r\n            if ($CPUPerformance.Avg -ge 90) { $HTMLCard = $HTMLCard -replace \"id='cpuOverallAvg' style='color: #008001;'\", \"id='cpuOverallAvg' style='color: #D53948;'\" }\r\n            if ($CPUPerformance.Min -ge 90) { $HTMLCard = $HTMLCard -replace \"id='cpuOverallMin' style='color: #008001;'\", \"id='cpuOverallMin' style='color: #D53948;'\" }\r\n            if ($CPUPerformance.Max -ge 90) { $HTMLCard = $HTMLCard -replace \"id='cpuOverallMax' style='color: #008001;'\", \"id='cpuOverallMax' style='color: #D53948;'\" }\r\n\r\n            # Highlight RAM performance metrics based on threshold values (color coding).\r\n            if ($MemoryPerformance.Avg -ge 60 -and $MemoryPerformance.Avg -lt 90) { $HTMLCard = $HTMLCard -replace \"id='ramOverallAvg' style='color: #008001;'\", \"id='ramOverallAvg' style='color: #FAC905;'\" }\r\n            if ($MemoryPerformance.Min -ge 60 -and $MemoryPerformance.Min -lt 90) { $HTMLCard = $HTMLCard -replace \"id='ramOverallMin' style='color: #008001;'\", \"id='ramOverallMin' style='color: #FAC905;'\" }\r\n            if ($MemoryPerformance.Max -ge 60 -and $MemoryPerformance.Max -lt 90) { $HTMLCard = $HTMLCard -replace \"id='ramOverallMax' style='color: #008001;'\", \"id='ramOverallMax' style='color: #FAC905;'\" }\r\n\r\n            if ($MemoryPerformance.Avg -ge 90) { $HTMLCard = $HTMLCard -replace \"id='ramOverallAvg' style='color: #008001;'\", \"id='ramOverallAvg' style='color: #D53948;'\" }\r\n            if ($MemoryPerformance.Min -ge 90) { $HTMLCard = $HTMLCard -replace \"id='ramOverallMin' style='color: #008001;'\", \"id='ramOverallMin' style='color: #D53948;'\" }\r\n            if ($MemoryPerformance.Max -ge 90) { $HTMLCard = $HTMLCard -replace \"id='ramOverallMax' style='color: #008001;'\", \"id='ramOverallMax' style='color: #D53948;'\" }\r\n\r\n            # Add the created HTML card to the custom field.\r\n            $CustomFieldValue.Add($HTMLCard)\r\n\r\n            # Check if there are any event logs to display.\r\n            if ($NumberOfEvents -gt 0 -and $EventLogs.Count -gt 0) {\r\n                # Convert the event logs into an HTML fragment for displaying in the output.\r\n                $EventLogTableMetrics = $EventLogs | ConvertTo-Html -Fragment\r\n\r\n                # Apply custom styles to the HTML table headers.\r\n                $EventLogTableMetrics = $EventLogTableMetrics -replace \"<th>\", \"<th><b>\" -replace \"<\/th>\", \"<\/b><\/th>\"\r\n\r\n                # Set specific column widths for better presentation.\r\n                $EventLogTableMetrics = $EventLogTableMetrics -replace \"<th><b>LogName\", \"<th style='width: 100px'><b>Log Name\"\r\n                $EventLogTableMetrics = $EventLogTableMetrics -replace \"<th><b>ProviderName\", \"<th style='width: 250px'><b>Provider Name\"\r\n                $EventLogTableMetrics = $EventLogTableMetrics -replace \"<th><b>Id\", \"<th style='width: 75px'><b>Id\"\r\n                $EventLogTableMetrics = $EventLogTableMetrics -replace \"<th><b>TimeCreated\", \"<th style='width: 175px'><b>Time Created\"\r\n            } elseif ($NumberOfEvents -gt 0) {\r\n                # If no events were found, display a message instead of the table.\r\n                $EventLogTableMetrics = \"<p style='margin-top: 0px'>No error events were found in the event log.<\/p>\"\r\n            }\r\n\r\n            # If event logs exist, create a card to display them.\r\n            if ($NumberOfEvents -gt 0) {\r\n                # Create the HTML structure for the event log card.\r\n                $EventLogCard = \"<div class='card flex-grow-1'>\r\n    <div class='card-title-box'>\r\n        <div class='card-title'><i class='fa-solid fa-book'><\/i>&nbsp;&nbsp;Recent Error Events<\/div>\r\n    <\/div>\r\n    <div class='card-body' style='white-space: nowrap'>\r\n        $EventLogTableMetrics\r\n    <\/div>\r\n<\/div>\"\r\n                # Add the event log card to the custom field value.\r\n                $CustomFieldValue.Add($EventLogCard)\r\n            }\r\n\r\n            # Check if the HTML content exceeds the character limit (45,000 characters).\r\n            $HTMLCharacters = ($CustomFieldValue | Out-String).Length\r\n            if ($HTMLCharacters -ge 190000) {\r\n                Write-Host -Object \"The current character count is '$HTMLCharacters'.\"\r\n                Write-Host -Object \"[Warning] The character limit of 200,000 has been reached! Trimming the output until the character limit is satisfied.\"\r\n\r\n                # Truncate the output if it exceeds the limit.\r\n                $i = 0\r\n                [array]$NewEventLogTable = $EventLogTableMetrics\r\n                $TrimStart = Get-Date\r\n                do {\r\n                    # Recreate the custom field output\r\n                    $CustomFieldValue = New-Object System.Collections.Generic.List[string]\r\n                    $CustomFieldValue.Add(\"<div>\")\r\n\r\n                    if (!$NumberOfEvents -or !$NumberOfEvents -gt 0 -or !$EventLogs.Count -gt 0) {\r\n                        Write-Host -Object \"[Error] No events to trim.\"\r\n                        exit 1\r\n                    }\r\n\r\n                    # Add the main performance metrics card to the custom field.\r\n                    $CustomFieldValue.Add($HTMLCard)\r\n\r\n                    # Calculate the batch size for trimming\r\n                    $ExceededAmount = $HTMLCharacters - 190000\r\n                    if ($ExceededAmount -le 0) {\r\n                        $BatchSize = 1\r\n                    } else {\r\n                        $BatchSize = [math]::Ceiling($ExceededAmount \/ 500)\r\n                    }\r\n\r\n                    # Reverse the event log array so that the last entry is at the top.\r\n                    [array]::Reverse($NewEventLogTable)\r\n\r\n                    # Remove excess event log entries\r\n                    for ($BatchNumber = 0 ; $BatchNumber -lt $BatchSize ; $BatchNumber++) {\r\n                        # Delete rows until the character count is reduced.\r\n                        if ($NewEventLogTable[$i] -match '<tr><td>' -or $NewEventLogTable[$i] -match '<tr class=') {\r\n                            $NewEventLogTable[$i] = $null\r\n                        }\r\n                        $i++\r\n                    }\r\n\r\n                    # Reverse the array back to its original order.\r\n                    [array]::Reverse($NewEventLogTable)\r\n\r\n                    # Rebuild the event log card with the truncated log.\r\n                    $EventLogCard = \"<div class='card flex-grow-1'>\r\n    <div class='card-title-box'>\r\n        <div class='card-title'><i class='fa-solid fa-book'><\/i>&nbsp;&nbsp;Recent Error Events<\/div>\r\n    <\/div>\r\n    <div class='card-body' style='white-space: nowrap'>\r\n        $NewEventLogTable\r\n    <\/div>\r\n<\/div>\"\r\n\r\n                    # Add a truncation notice and the truncated event log card.\r\n                    $CustomFieldValue.Add(\"<h1>This information has been truncated to fit within the character limit of 200,000.<\/h1>\")\r\n                    $CustomFieldValue.Add($EventLogCard)\r\n\r\n                    # Check the character count again; repeat if still too long.\r\n                    $HTMLCharacters = ($CustomFieldValue | Out-String).Length\r\n                    $ElapsedTime = (Get-Date) - $TrimStart\r\n                    if ($ElapsedTime.TotalMinutes -ge 5) {\r\n                        Write-Host -Object \"The current character count is '$HTMLCharacters'.\"\r\n                        throw \"5 minute timeout reached. Unable to trim the output to comply with the character limit.\"\r\n                    }\r\n                }while ($HTMLCharacters -ge 190000)\r\n            }\r\n\r\n            $CustomFieldValue.Add(\"<\/div>\")\r\n\r\n            # Set the custom field with the finalized HTML content.\r\n            Set-NinjaProperty -Name $WysiwygCustomField -Value $CustomFieldValue -Type \"WYSIWYG\" -ErrorAction Stop\r\n            Write-Host \"Successfully set Custom Field '$WysiwygCustomField'!\"\r\n        } catch {\r\n            Write-Host \"[Error] $($_.Exception.Message)\"\r\n            $ExitCode = 1\r\n        }\r\n    }\r\n\r\n    # Try to remove the lock file to ensure no other instance of the script is running.\r\n    try {\r\n        Remove-Item -Path \"$env:ProgramData\\NinjaRMMAgent\\SystemPerformance.lock.txt\" -Force -ErrorAction Stop\r\n    } catch {\r\n        # If the removal of the lock file fails, catch the exception and display error messages.\r\n        Write-Host -Object \"[Error] Failed to remove lock file at '$env:ProgramData\\NinjaRMMAgent\\SystemPerformance.lock.txt'.\"\r\n        Write-Host -Object \"[Error] $($_.Exception.Message)\"\r\n        $ExitCode = 1\r\n    }\r\n\r\n    if ($DisplayUserMessage) {\r\n        try {\r\n            Write-Host -Object \"`nChecking for currently logged-in users.\"\r\n            $QuserOutput = Invoke-LegacyConsoleTool -FilePath \"$env:WINDIR\\System32\\quser.exe\" -ErrorVariable \"QUserErrors\" -ErrorAction SilentlyContinue\r\n            if ($QUserErrors) {\r\n                $QUserErrors | ForEach-Object { Write-Host -Object \"[Warning] $($_.Exception.Message)\" }\r\n                $QUserErrors = $Null\r\n            }\r\n\r\n            $i = 0\r\n            $CurrentlyLoggedInUsers = $QuserOutput | Where-Object { $_.Trim() } | ForEach-Object {\r\n                # Skip the first line (header) and process only the data lines\r\n                if ($i -ne 0 -and $_.Length -ge 65) {\r\n                    # Extract the relevant columns using fixed-width positions\r\n                    [PSCustomObject]@{\r\n                        Username    = ($_.Substring(0, 21).Trim() -replace '^>')\r\n                        SessionName = $_.Substring(21, 21).Trim()\r\n                        ID          = $_.Substring(40, 5).Trim()\r\n                        State       = $_.Substring(45, 10).Trim()\r\n                        IdleTime    = $_.Substring(55, 10).Trim()\r\n                        LogonTime   = $_.Substring(65).Trim()\r\n                    }\r\n                }\r\n\r\n                $i++\r\n            }\r\n        } catch {\r\n            Write-Host -Object \"[Error] $($_.Exception.Message)\"\r\n            Write-Host -Object \"[Error] Unable to check for currently logged-in users.\"\r\n            $ExitCode = 1\r\n        }\r\n    }\r\n\r\n    if ($DisplayUserMessage -and $CurrentlyLoggedInUsers) {\r\n        $CurrentlyLoggedInUsers = $null\r\n\r\n        # Arguments for sending a message to notify the user that performance metrics have been recorded.\r\n        $MSGArguments = @(\r\n            \"*\"\r\n            \"\/TIME:3600\"\r\n            \"\/V\"\r\n            \"Performance metrics have been recorded and forwarded to your IT Administrator.\"\r\n        )\r\n\r\n        # Display an empty line for better readability in the output.\r\n        Write-Host -Object \"\"\r\n\r\n        # Start the process of sending a message to the users using msg.exe.\r\n        try {\r\n            Write-Host -Object \"Sending message to all users.\"\r\n\r\n            # Start the 'msg.exe' process with the provided arguments and capture stdout and stderr into log files.\r\n            Invoke-LegacyConsoleTool -FilePath \"$env:WINDIR\\System32\\msg.exe\" -ArgumentList $MSGArguments -ErrorAction Stop\r\n        } catch {\r\n            # If the process fails to start, output an error message and exit the script with an error code.\r\n            Write-Host -Object \"[Error] Failed to send message to all users.\"\r\n            Write-Host -Object \"[Error] $($_.Exception.Message)\"\r\n            $ExitCode = 1\r\n        }\r\n\r\n        # Output the exit code of the msg.exe process.\r\n        Write-Host -Object \"ExitCode: $LASTEXITCODE\"\r\n\r\n        # If the exit code is non-zero (indicating an error), display an error message.\r\n        if ($LASTEXITCODE -ne 0) {\r\n            Write-Host -Object \"[Error] ExitCode does not indicate success.\"\r\n            $ExitCode = 1\r\n        }\r\n    }\r\n\r\n    Write-Host -Object \"\"\r\n\r\n    # Iterate through each feedback log file location\r\n    foreach ($LogFile in $FeedbackLogLocations) {\r\n        Write-Host -Object \"Updating the feedback log at '$($LogFile.LogFileLocation)'.\"\r\n\r\n        try {\r\n            # Attempt to read the first line of the log file to ensure it exists\r\n            Get-Content -Path $LogFile.LogFileLocation -TotalCount 1 -ErrorAction Stop | Out-Null\r\n        } catch {\r\n            # Log an error if unable to read the log file\r\n            Write-Host -Object \"[Error] $($_.Exception.Message)\"\r\n            Write-Host -Object \"[Error] Failed to retrieve the feedback log file contents for the user '$($LogFile.Name)'.\"\r\n            $ExitCode = 1\r\n            continue\r\n        }\r\n\r\n        # Initialize variables for parsing and updating the log file\r\n        $i = 0\r\n        $UpdateLogFile = $False\r\n\r\n        # Read and process the log file content line by line\r\n        $LogContent = Get-Content -Path $($LogFile.LogFileLocation) | ForEach-Object {\r\n            $i++\r\n            # Split each line into data points using the '|' delimiter\r\n            $DataPoints = $_ -split '\\|', 6\r\n\r\n            # Warn if a line has fewer than 6 data points\r\n            if ($DataPoints.Count -lt 6) {\r\n                Write-Host -Object \"[Warning] Only $($DataPoints.Count) data points were found for line '$i'.\"\r\n                $_\r\n                return\r\n            }\r\n\r\n            # If the fifth data point is already True, skip updating this line\r\n            if ($DataPoints[4] -eq $True) {\r\n                $_\r\n                return\r\n            }\r\n\r\n            # Replace the fifth data point with True and mark the file for update\r\n            $_ -replace [regex]::Escape(\"$($DataPoints[4])|$($DataPoints[5])\"), \"$True|$($DataPoints[5])\"\r\n            $UpdateLogFile = $True\r\n        }\r\n\r\n        # If no updates are needed, skip to the next log file\r\n        if (!$UpdateLogFile) {\r\n            Write-Host -Object \"'$($LogFile.LogFileLocation)' is already up-to-date.\"\r\n            continue\r\n        }\r\n\r\n        try {\r\n            # Write the updated content back to the log file\r\n            Set-Content -Path $LogFile.LogFileLocation -Value $LogContent -ErrorAction Stop\r\n            Write-Host -Object \"Updated the log file at '$($LogFile.LogFileLocation)'.\"\r\n        } catch {\r\n            # Log an error if unable to update the log file\r\n            Write-Host -Object \"[Error] $($_.Exception.Message)\"\r\n            Write-Host -Object \"[Error] Failed to update the log file at '$($LogFile.LogFileLocation)'.\"\r\n            $ExitCode = 1\r\n        }\r\n    }\r\n\r\n    # If the $NumberOfEvents variable has a value, proceed to display the event logs.\r\n    if ($NumberOfEvents) {\r\n        # Display a message indicating the number of errors retrieved from the event logs.\r\n        Write-Host -Object \"`n### Last $NumberOfEvents errors in Application, Security, Setup and System Log. ###\"\r\n\r\n        # Format and display the collected event logs in a list format.\r\n        ($EventLogs | Format-List | Out-String).Trim() | Write-Host\r\n    }\r\n\r\n    exit $ExitCode\r\n}\r\nend {\r\n    \r\n    \r\n    \r\n}<\/pre>\n
 <\/p>\n\n
Description d\u00e9taill\u00e9e<\/h2>\n
Le script effectue les op\u00e9rations suivantes :<\/p>\n
    \n
  1. Validation de l’environnement et des donn\u00e9es<\/strong>
    \n<\/strong>Il valide les param\u00e8tres d’entr\u00e9e tels que<\/p>\n