PowerShell/docs/query-smart-data.md
2024-03-27 17:36:59 +01:00

110 lines
2.7 KiB
Markdown

Script: *query-smart-data.ps1*
========================
Queries the S.M.A.R.T. data of your HDD/SSD's and saves it to the current/given directory.
(use smart-data2csv.ps1 to generate a CSV table for analysis).
Requires smartctl (smartmontools) and admin rights. For automation copy this script to /etc/cron.daily
Parameters
----------
```powershell
PS> ./query-smart-data.ps1 [[-Directory] <String>] [<CommonParameters>]
-Directory <String>
Specifies the path to the target directory
Required? false
Position? 1
Default value
Accept pipeline input? false
Accept wildcard characters? false
[<CommonParameters>]
This script supports the common parameters: Verbose, Debug, ErrorAction, ErrorVariable, WarningAction,
WarningVariable, OutBuffer, PipelineVariable, and OutVariable.
```
Example
-------
```powershell
PS> ./query-smart-data
```
Notes
-----
Author: Markus Fleschutz | License: CC0
Related Links
-------------
https://github.com/fleschutz/PowerShell
Script Content
--------------
```powershell
<#
.SYNOPSIS
Queries and saves the S.M.A.R.T. data of your HDD's/SSD's
.DESCRIPTION
Queries the S.M.A.R.T. data of your HDD/SSD's and saves it to the current/given directory.
(use smart-data2csv.ps1 to generate a CSV table for analysis).
Requires smartctl (smartmontools) and admin rights. For automation copy this script to /etc/cron.daily
.PARAMETER Directory
Specifies the path to the target directory
.EXAMPLE
PS> ./query-smart-data
.LINK
https://github.com/fleschutz/PowerShell
.NOTES
Author: Markus Fleschutz | License: CC0
#>
#Requires -RunAsAdministrator
param([string]$Directory = "")
function CheckIfInstalled {
try {
$null = $(smartctl --version)
} catch {
write-error "smartctl is not installed - make sure smartmontools are installed"
exit 1
}
}
try {
if ($Directory -eq "") {
$Directory = "$PWD"
}
write-output "(1) Checking for 'smartctl'..."
CheckIfInstalled
write-output "(2) Scanning for S.M.A.R.T. devices..."
$Devices = $(smartctl --scan-open)
[int]$DevNo = 1
foreach($Device in $Devices) {
write-output "(3) Querying data from S.M.A.R.T. device $Device..."
$Time = (Get-Date)
$Filename = "$Directory/SMART-dev$($DevNo)-$($Time.Year)-$($Time.Month)-$($Time.Day).json"
write-output "(4) Saving data to $Filename..."
$Cmd = "smartctl --all --json " + $Device
Invoke-Expression $Cmd > $Filename
$DevNo++
}
"✔️ Done."
exit 0 # success
} catch {
"⚠️ Error in line $($_.InvocationInfo.ScriptLineNumber): $($Error[0])"
exit 1
}
```
*(generated by convert-ps2md.ps1 using the comment-based help of query-smart-data.ps1 as of 03/27/2024 17:36:31)*