agent.XO is a client component that can be run on servers and workstations with the purpose to help in troubleshooting DSC and PSADT related issues.
The first thing you need to do is to download the agent to your workstation or server you want to analyze.
Supported Operating Systems
- Windows 10
- Windows Server 2016
- Windows Server 2019
- Windows PowerShell v5.1 or greater or PowerShell v7.0 or greater
- .NET Framework v4.7.2 (only for Windows PowerShell)
Extract the .zip file to a place of your choice.
Depending on your security settings there might be the need to unblock the .zip file before extracting the files.
Start the agent.
The agent comes with two different options to start, with a PowerShell script or simply by double-clicking the EXE file. Both files are placed in the root directory of your extracted agent folder. There is no difference in running it via exe or ps1.
Double-click the agentXO.exe or launch the agentXO.ps1 file.
PS C:\Users\Administrator\Desktop\agentXOv1.0.3> .\Launch.ps1 Universal Dashboard module not found, installing NuGet provider is required to continue PowerShellGet requires NuGet provider version '220.127.116.11' or newer to interact with NuGet-based repositories. The NuGet provider must be available in 'C:\Program Files\PackageManagement\ProviderAssemblies' or 'C:\Users\Administrator\AppData\Local\PackageManagement\ProviderAssemblies'. You can also install the NuGet provider by running 'Install-PackageProvider -Name NuGet -MinimumVersion 18.104.22.168 -Force'. Do you want PowerShellGet to install and import the NuGet provider now? [Y] Yes [N] No [S] Suspend [?] Help (default is "Y"): Y
Your default browser will be started with a webpage at address: http://localhost:10023/agentXO
The Dashboard gives you a rough overview of the current status the node is in.
The System Information area provides you with the following information about the local system:
- Host Info
- Operating System
- Hardware / BIOS
- PowerShell Excecution Policy
The Software area lists the installed Windows applications and AppX packages.
The Configuration Status page shows details about the assigned and applied PowerShell DSC configuration.
Main Widgets are:
- DSC Status
- Number of Resources
- Resources in state
- Resources not in state
- Changed Resources
Furthermore a detailed DSC Configuration status und information about the meta configuration are displayed.
The Resources area displays all resources that are being configured.
You can click on the details link to get more insights about the resource and it´s current state.
The Details pane shows you information about:
- The date the resource was changed
- The time it took to change the resource
- The state of the resource
- If the resoure requested a reboot
The Error area shows detailed information about the errors a DSC Configuration has run into.
Use the Details button to get more information about it.
The Run area provides some basic PowerShell commands for DSC related actions.