Administration Guide
How to create custom software recognition
This guide shows you how to add a custom software recognition rule so audited devices can contribute software entries that standard discovery does not capture.
Prerequisites
- You are signed in as a Site Administrator.
- You know which application you want AlloyScan to recognize.
- You have a PowerShell script that identifies the target software and returns the expected software fields.
- You have a test device in the Site so you can verify the rule after the next audit.
Steps
- Navigate to Admin Center > Site Settings > Customization > Software recognition.
- Click the + button to create a new recognition rule.
- Fill in the rule details:
- Label - a descriptive name for the rule. AlloyScan fills in Name from this field automatically.
- Enabled - keep the rule turned on so AlloyScan can use it during audits.
- Script - the PowerShell script that finds the software and returns its details. You can type the script directly in the editor or load it from a file.
- Description - a short explanation of what the rule detects.
- Save the rule.
Verify
- Run or wait for the next audit on a test device.
- Open Software after audit processing completes.
- Confirm that the newly recognized application appears in the catalog alongside other detected software.
NOTE: Software inventory updates after audit processing. If the catalog does not reflect the new rule immediately, wait for the next refresh cycle.