Skip to main content

Crystal Disk Info Report

Summary

The script runs the Crystal Disk Info tool on physical machines, stores the basic disk information returned by the tool in a custom table, and creates a ticket if the Health Status returned by the tool does not contain Good. Additionally, it attempts to attach the DiskInfo.txt report generated by the tool to the ticket.

It is an Automate implementation of the agnostic script Agnostic - Get-CrystalDiskInfo.

Note: The script will not work for virtual machines as the tool only supports physical hard disks.

Tool Acquisition

The script requires the CrystalDiskInfo Standard Edition ZIP to run. You have three options for providing this file to your agents, listed in order of recommendation:

For the fastest and most reliable deployment, host the ZIP file on your Automate server (WebDAV for hosted partners). This ensures agents download the tool locally without hitting external firewalls.

  1. Download the latest stable Standard Edition ZIP from the CrystalDiskInfo Official Download page.
  2. Unblock the file
  3. Place the file in your LTShare (or WebDAV for hosted partners) at LTShare/Transfer/Tools and name it crystaldiskinfo.zip.
  4. If the Tools directory does not exist, create it.

Image Placeholder: LTShare directory structure

The script automatically constructs the download URL using your environment's redirection hostname (e.g., https://%redirhostname%/labtech/transfer/tools/crystaldiskinfo.zip).

Option 2: Use a Custom Source

If you prefer to host the file on your own internal web server, cloud storage, or a network UNC share, you can pass that location using the Source User Parameter when executing the script.

  • Examples: https://internal.company.com/tools/crystaldiskinfo.zip or \\fileserver\share\crystaldiskinfo.zip.
  • The script will test and use this location, bypassing the LTShare and default internet checks.

Option 3: Automatic Internet Fallback

If you do not host the file on your LTShare and do not provide a Source parameter, the script will automatically resolve and download the latest available version from the internet (via SourceForge).

  • Note: The default download host is located in India, and some regional firewalls or geo-blocking rules may prevent agents from reaching it. If the download fails, the script will exit with an error. We highly recommend Option 1 or 2 for production environments.

Image Placeholder: CrystalDiskInfo download page

Sample Run

Sample Run

The primary usage of the script is to be executed by the Internal Monitor - Execute Script - Crystal Disk Info Report monitor set.

Dependencies

Global Parameters

NameDefaultRequiredDescription
ServerTicketCreationCategory0FalseSetting a predefined ticket creation category will set a specified ticket creation category for server-type devices. Setting the ticket category in the script will override the ticket category set either at group or computer levels. The ticket category settings are defined properly in the monitor set's document. 0 in the value represents that this global property is not in use.
WorkstationTicketCreationCategory0FalseSetting a predefined ticket creation category will set a specified ticket creation category for workstation-type devices. Setting the ticket category in the script will override the ticket category set either at group or computer levels. The ticket category settings are defined properly in the monitor set's document. 0 in the value represents that this global property is not in use.
ReallocatedSector50TrueSet the threshold for the number of reallocated sectors to mark an HDD as caution (not applicable to SSDs).

User Parameters

NameExampleRequiredDescription
Source\\fileserver\share\CrystalDiskInfo.zipFalseOptional custom location of the CrystalDiskInfo ZIP file. Accepts a local path, a UNC path, or a custom URL. If provided and valid, this overrides the default LTShare download URL. Falls back to LTShare or default internet source if omitted or failed.

Extra Data Fields

NameLevelTypeExampleDescription
Disks to Exclude From Disk Health AlertingComputerText50026B73801F2CBB,50026B73801F2CBCComma-separated list of the Serial Numbers of the Disk(s) to exclude from alerting.
Crystal Disk - Reallocated SectorsComputerText70Threshold for the number of reallocated sectors to mark an HDD as caution (not applicable to SSDs). This EDF can be used to overwrite the value stored in the Global Variable ReallocatedSector. The default threshold is 50.

Extra Data Fields

System Properties

NameDefaultRequiredDescription
Crystal_Disk_Info_Disable_Tickets0False0 or 1 to toggle the ticket creation function of the script.
Crystal_Disk_Info_Disable_Caution_Tickets0False0 or 1 to toggle ticket creation for disks with the Caution Health Status.

Running the script against any online physical Windows computer will create the system properties.

Output

  • Script Log
  • Data view
  • Ticket

Ticketing

Subject: Predictive Hard Disk Failure Detected on \\<ClientName>/\\<ComputerName>

Ticket Body:

Crystal Disk Info solution detected <Number of Unhealthy Disks> unhealthy disk(s) on <ComputerName>. Please investigate the disk health for further analysis. The Crystal Disk Info solution has detected that the disk's health status is not in a good or healthy state. This indicates potential issues with the disk's performance or reliability.
It is recommended to perform a thorough examination of the disk to identify any underlying problems and take appropriate actions. This may involve running diagnostic tests, checking for disk errors, or considering backup and replacement options if necessary.
Please prioritize this ticket and provide the necessary support to address the disk health concerns.
Disk(s) information returned by the tool are outlined below (Please refer to the ticket's internal notes for further details):
Model: <Disk 1 Model>
Serial Number: <Disk 1 Serial Number>
Disk Size: <Disk 1 Size>
Health Status: <Disk 1 Health Status>
Drive Letter: <Disk 1 Drive Letter(s)>

Model: <Disk 2 Model>
Serial Number: <Disk 2 Serial Number>
Disk Size: <Disk 2 Size>
Health Status: <Disk 2 Health Status>
Drive Letter: <Disk 2 Drive Letter(s)>

Model: <Disk n Model>
Serial Number: <Disk n Serial Number>
Disk Size: <Disk 3 Size>
Health Status: <Disk n Health Status>
Drive Letter: <Disk n Drive Letter(s)>

<File Upload Comment>

The computer information is outlined below:

Name: <Computer Name>
Last Login: <Logged In User>
Model: <Computer Model>
OS: <Operating System>
Serial Number: <Serial Number>

Refer to the troubleshooting guide at Crystal Disk Info - Ticket Troubleshooting Guide.
If you're logged into an ITGlue portal, open the URL in a Private Window.

<File Upload Comment> can vary depending on the existence of the disk health report DiskInfo.txt

If the script fails to find the file:

PowerShell Script failed to generate the Crystal Disk Info report.
The result returned by the script can be checked from the internal notes in the ticket.

Comment to add to the internal notes if the script fails to find the file:

PowerShell Script failed to generate the Crystal Disk Info report.
The result returned by the script is:
<PsOut>

If the script finds and uploads the file:

Crystal Disk Info tool generated a brief disk health report which is attached to the ticket.
(Note: if there is no attachment, it is possible that the attachment did not sync over to your PSA. In this case, please navigate to the UPLOADS folder within the LTShare to access the logs.)

The following information for each drive not showing Good status will be added to the ticket's internal note/comment:

ID: <DiskID>
Model: <Disk Model>
Firmware: <Disk Firmware>
Serial Number: <Disk Serial Number>
Disk Size: <Disk Size>
Buffer Size: <Buffer Size>
Queue Depth: <Queue Depth>
# of Sectors: <Number of Sectors>
Rotation Rate: <Rotation Rate>
Interface: <Interface>
Major Version: <Major version>
Minor Version: <Minor Version>
Transfer Mode: <Transfer Mode>
Power On Hours: <Power On Hours>
Power On Count: <Power On Count>
Host Reads: <Host Reads>
Host Writes: <Host Writes>
Wear Level Count: <Wear Level Count>
Temperature: <Disk Temperature>
Health Status: <Health Status>
Features: <Disk Features>
APM Level: <Disk APM Level>
AAM Level: <Disk AAM Level>
Drive Letter: <Drive Letter(s)>

Additional internal notes:

To exclude this disk from disk health alerting: Open the computer in Automate, navigate to Extra Data Fields, and under the "Exclusions" tab, find the "Disks to Exclude From Disk Health Alerting" field. Add the serial number for this disk to this field: \{Drive Serial Number}. Click Save. You can add additional disk serial numbers separated by comma for a single computer to exclude multiple drives from disk health alerting.

Sample Ticket:

Ticket Summary and Subject:
Sample Ticket Summary

Internal Notes/Comment:
Sample Internal Notes

Attached DiskInfo.txt File:
Attached DiskInfo.txt

Excluding Disk(s) from Alerting

  • Gather the serial number(s) of the disk(s) to exclude from the generated ticket.
  • Add the serial number to the computer-level EDF Disks to Exclude From Disk Health Alerting. Multiple serial numbers can be separated by a comma. Do not add a space after the comma.

e.g.,
Example Exclusion

Changelog

2026-08-05

  • Added: Support for hosting the CrystalDiskInfo ZIP on the Automate LTShare/WebDAV Transfer directory for faster, firewall-friendly deployments.
  • Added: Deep S.M.A.R.T. attribute parsing for both SATA and NVMe drives in the underlying agnostic script.
  • Added: Problematic boolean flag to instantly identify physical drive degradation, bypassing misleading vendor health scores.
  • Moved: Source parameter from Global Parameters to User Parameters for easier per-execution overrides.
  • Updated: Tool acquisition logic. The script now gracefully falls back to downloading the latest version from the internet if the file is not hosted on LTShare and no custom Source is provided.

2026-07-29

  • Added: -Source parameter to allow specifying a custom URL, local file path, or UNC share for the CrystalDiskInfo ZIP file.

2026-05-27

  • Signed the Powershell script

2025-04-10

  • Initial version of the document