Agent

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.

Installation

Supported Operating Systems

  • Windows 10
  • Windows Server 2016
  • Windows Server 2019

Prerequisites

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 '2.8.5.201' 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 2.8.5.201
-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

Overview

The Dashboard gives you a rough overview of the current status the node is in.

Overview

System Information

The System Information area provides you with the following information about the local system:

  • Host Info
  • Operating System
  • Hardware / BIOS
  • PowerShell
  • PowerShell Excecution Policy

System Information

Software

The Software area lists the installed Windows applications and AppX packages.

Software Information

Configuration Status

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
  • Errors

Furthermore a detailed DSC Configuration status und information about the meta configuration are displayed.

System Information

Resources

The Resources area displays all resources that are being configured.

Resources

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

Details

Errors

The Error area shows detailed information about the errors a DSC Configuration has run into.

Errors

Use the Details button to get more information about it.

Error Details

Run

The Run area provides some basic PowerShell commands for DSC related actions.

Run