Nodes

Quick Guide #

Nodes are devices that are registered in your XOAP workspace when a configuration is assigned to them. Once registered, they are visible in XOAP and can be managed and monitored through Desired State Configuration configurations.

Add a Node #

1. To add (register) a node to your workspace, use the Configuration Group registration command/script.
2. Go to Configuration Management → Configuration Groups.
3. Select a configuration group (for example, XOAP Unassigned) and open the Action menu (⋮).
4. Select Copy registration command to copy the command to your clipboard.
5. On the target device, open PowerShell as Administrator and paste the command.
6. Run the command to register the device. The node will be added to your XOAP workspace in the corresponding group.

Update a Node #

1. Click the Action menu (⋮) next to the node.
2. Select Details to view the full system inventory.
3. On the Details page, you can update Tags and review Hardware, Software, and Compliance information.

Delete a Node #

1. Click the Action menu (⋮) and select Delete.
2. Confirm the deletion by clicking Delete.

Additional useful information #

Windows and Linux devices #

Nodes can be Windows devices. Linux devices are managed via the XOAP Connector and are listed under the Inventory module. Windows devices can also have the XOAP Connector installed and appear under the Inventory module, while still being managed through Configuration Management in parallel.

Configuration Group #

Nodes can be assigned to only one Configuration group, and change can be done under Configuration Group area

PowerShell support #

Node registration and management is currently limited to PowerShell 5.1 only. PowerShell Core is not supported.

Technical documentation #

Nodes are devices that are registered in your XOAP workspace when a configuration is applied to them. Once registered, they are visible in XOAP and can be centrally managed and monitored through their assigned configurations, including inventory and compliance status, configuration run results, and operational health. This enables consistent enforcement of configuration standards across the environment and provides clear visibility into each device’s current state and configuration drift.

Node status in XOAP indicates the current configuration state of a device based on the latest configuration evaluation and execution results. The following statuses are used:

• Compliant: The node matches the assigned configuration. All required settings are applied and the last evaluation completed successfully with no deviations detected.
• Non-compliant: The node does not match the assigned configuration. One or more required settings are missing, incorrect, or failed to apply during the last run.
• Running: A configuration run is currently in progress on the node. XOAP is actively applying or evaluating the configuration and the final compliance result is not yet available.

You can check compliance history in two ways:

• Click the Compliance status icon.
• Open the Action menu (⋮) and select Compliance History.

Both methods open the same slide-out view showing compliance information for the last 14 days. By clicking the status entry again, you can view details for a specific configuration application run. Detailed logs are available for resources that are not in the desired state.

To view full node details, click the Node name or open the Action menu (⋮) and select Details.

The Details view provides a deep dive into the node’s current state across several categories:

• Hardware: BIOS, Processors, Devices, and Volumes.
• Networking: Full interface details and network configurations.
• Operating System: Real-time lists of Services, Scheduled Tasks, and Local Users.
• Maintenance & Policy: Installed Updates and DSC (Desired State Configuration) status.