Configure BgInfo

Purpose

The BGInfo Configuration solution is designed to automate the deployment and configuration of Microsoft Sysinternals BGInfo on supported Windows endpoints through ninja. It transfers the required BGInfo configuration file, downloads and configures BGInfo, and creates a scheduled task that automatically runs BGInfo when any user logs on to the endpoint.

The solution uses centralized configuration through the Ninja cPVAL Configure BGInfo custom field to control which Windows operating systems should receive the BGInfo configuration.

Key Capabilities

1. Automated BGInfo Deployment

   Transfers the required .BGI or .ZIP configuration file to the endpoint and uses the BGInfo configuration automation to complete the deployment.

2. Centralized BGInfo Configuration

   Uses the cPVAL Configure BGInfo custom field to control which Windows operating systems should receive the BGInfo configuration.

3. BGI and ZIP File Support

   Supports both .BGI configuration files and .ZIP packages containing the required BGInfo configuration.

4. Automated BGInfo Configuration

   Downloads and configures Microsoft Sysinternals BGInfo and applies the specified .BGI configuration file to the endpoint.

5. Automatic User Logon Execution

   Creates a scheduled task configured with a logon trigger for any user so that BGInfo runs automatically when a user logs on.

6. Scheduled Task Verification

   Verifies that the BGInfo scheduled task exists and is configured with the required logon trigger before considering the deployment complete.

7. Conditional Workstation and Server Deployment

   Uses separate compound conditions to target Windows workstations and Windows servers based on the configured cPVAL Configure BGInfo custom field.

8. Windows Platform Support

   Supports BGInfo deployment on Windows workstations and servers targeted through the solution's associated conditions.

Associated Content

Content	Type	Function
cPVAL Configure BGInfo	Custom Field	Custom Field to select the operating system(s) on which BGInfo should be configured.
BGI File	File Transfer	The purpose of this file transfer is to place the BGI file or BGI ZIP file at C:\ProgramData\_automation\app\BGInfo, so it can be used by Automation - Configure BGInfo. Both .zip and .bgi files are supported by the automation.
Configure BGInfo	Automation	Downloads and configures Microsoft Sysinternals BGInfo, applies the specified .BGI configuration file, and creates a scheduled task to run BGInfo automatically at user logon.
BGInfo - Verify Scheduled Task	Automation	Checks whether the Scheduled task - BGInfo exists and is configured with a At log on for any user trigger.
Configure BgInfo - Workstations	Compound Condition	Triggers the File Transfer - BGI File and Automation - Configure BGInfo on Windows workstations where BGInfo deployment is enabled through the Custom Field - cPVAL Configure BGInfo.The condition also verifies that the "BGInfo scheduled task" has not already been created. This is validated using Automation - BGInfo - Verify Scheduled Task
Configure BgInfo - Servers	Compound Condition	Triggers the File Transfer - BGI File and Automation - Configure BGInfo on Windows Servers where BGInfo deployment is enabled through the Custom Field - cPVAL Configure BGInfo. The condition also verifies that the "BGInfo scheduled task" has not already been created. This is validated using Automation - BGInfo - Verify Scheduled Task

Implementation

Step 1: Create the Custom Field

Create the following custom field in ninja. This field is required to control which operating systems should receive the BGInfo configuration.

• Custom Field - cPVAL Configure BGInfo

Configure the custom field with the appropriate operating system selection for the client, location or endpoint.

Step 2: Upload the BGI File

Configure the File Transfer - BGI File component with the required BGInfo .BGI or .ZIP file.

The file is transferred to:

C:\ProgramData\_automation\app\BGInfo

The Configure BGInfo automation uses the transferred file during deployment.

Step 3: Configure the BGInfo Automation

Create Configure BGInfo automation to download and configure Microsoft Sysinternals BGInfo.

The automation applies the specified .BGI configuration and creates the BGInfo scheduled task with a logon trigger for any user.

Step 4: Create the Scheduled Task Verification

Create BGInfo - Verify Scheduled Task automation to verify that the BGInfo scheduled task has been successfully created.

The verification checks that the scheduled task exists and has the required logon trigger for any user.

Step 5: Create the Workstation Compound Condition

Create and configure the following compound condition:

• Compound Condition - Configure BgInfo - Workstations

The condition targets eligible Windows workstations where BGInfo deployment is enabled through the cPVAL Configure BGInfo custom field.

It also verifies that the BGInfo scheduled task has not already been created before triggering the BGInfo deployment components.

Step 6: Create the Server Compound Condition

Create and configure the following compound condition:

• Compound Condition - Configure BgInfo - Servers

The condition targets eligible Windows servers where BGInfo deployment is enabled through the cPVAL Configure BGInfo custom field.

It also verifies that the BGInfo scheduled task has not already been created before triggering the BGInfo deployment components.

FAQ

Q: How does the BGInfo Configuration solution work?

The solution evaluates the cPVAL Configure BGInfo custom field to determine whether BGInfo should be deployed to the endpoint. When the endpoint meets the applicable workstation or server criteria, the BGI file is transferred and the Automation - Configure BGInfo automation configures BGInfo and creates the required scheduled task.

Q: Which operating systems are supported?

The solution supports Windows workstations and Windows servers that meet the criteria configured in the associated compound conditions and are selected through the cPVAL Configure BGInfo custom field.

Q: What file formats are supported?

The solution supports both .BGI files and .ZIP files containing the required BGInfo configuration.

Q: Where is the BGI file stored on the endpoint?

The BGI or BGI ZIP file is transferred to C:\ProgramData\_automation\app\BGInfo.

Q: How does BGInfo run automatically?

The Automation - Configure BGInfo automation creates a scheduled task configured with a logon trigger for any user. BGInfo runs automatically when a user logs on to the endpoint.

Q: How is the BGInfo scheduled task verified?

The Automation - BGInfo - Verify Scheduled Task automation checks whether the BGInfo scheduled task exists and confirms that it has a logon trigger configured for any user.

Q: Will the solution create the scheduled task multiple times?

No. The workstation and server compound conditions verify whether the BGInfo scheduled task already exists before triggering the deployment automation.

Q: What happens if BGInfo is already configured?

If the BGInfo scheduled task already exists and meets the required configuration, the verification prevents the deployment components from being triggered unnecessarily.

Q: How can I control which operating systems receive BGInfo?

Use the cPVAL Configure BGInfo custom field to select the operating system(s) on which BGInfo should be configured.

Q: What happens if the BGI file is missing?

The BGInfo configuration automation requires the BGI or BGI ZIP file to be available through the associated file transfer. If the required configuration file is unavailable, the BGInfo configuration may not complete successfully.

Q: What happens if the scheduled task does not have a logon trigger?

The Automation - BGInfo - Verify Scheduled Task component identifies whether the required logon trigger is present. The scheduled task must have a logon trigger configured for any user for the BGInfo deployment to be considered correctly configured.

Changelog

2026-09-28

• Initial version of the document