See https://www.cyberdrain.com/automating-with-powershell-automating-warranty-information-reporting/ for more information.
This is a PowerShell module that helps you get warranty information for items in your CMDB, PSA, or RMM. This module was made due to some shady businesses going on in the world of Warranty reporting and lookups, and to democtratize the warranty lookups. :)
This module has NOT been published to the PowerShell Gallery. Please download all files and run it locally until it get's published to PowerShell Gallery
The following platforms are supported. You can also use a CSV file as a source to generate reports. This won't sync back to the source though. Some APIs don't allow write-back, so those are only available to create reports.
An unchecked box means development for this is underway
- Autotask
- Connectwise Manage
- IT-Glue
- Hudu
- Solarwinds N-Able (Reporting only)
- Solarwinds RMM
- NinjaRMM (Reporting only)
- SyncroRMM
- DattoRMM
- Connectwise Automate
- BluetraitIO
- Dell (Requires API key)
- Microsoft (currently is broken and working on fix)
- HP (Spotty API. New one coming soon.)
- Lenovo
- Apple (Estimated dates)
Due to a change in how Apple generates serial numbers it is no longer possible to accurately determine the warranty expiry for newer devices. As such any new Apple devices could return a completely inaccurate expiry date. To account for this you can add the -ExcludeApple switch to the the Update-Warrantyinfo.ps1 script to skip updating any apple devices and ensure you do not update with inaccurate data.
To execute an update of all devices in Autotask use:
$Creds = get-credential
update-warrantyinfo -Autotask -AutotaskCredentials $creds -AutotaskAPIKey 'APIINTEGRATIONKEY' -SyncWithSource -OverwriteWarranty
This script will then update all devices in Autotask with the date found in the APIs. If they date returned is invalid it will not update. If the date is already filled in, it will overwrite this.
To only generate HTML reports use
$Creds = get-credential
update-warrantyinfo -Autotask -AutotaskCredentials $creds -AutotaskAPIKey 'APIINTEGRATIONKEY' -GenerateReports
This will generate the reports in C:\Temp. To set the path yourself use
update-warrantyinfo -Autotask -AutotaskCredentials $creds -AutotaskAPIKey 'APIINTEGRATIONKEY' -GenerateReports -ReportsLocation "C:\OtherFolder"
To update Hudu, first edit the asset layout of the devices you wish to update to add a new field. If you wish to use expirations and not have apple devices, choose a date field and enable add to expirations. If you wish to have apple devices you will need to make this a string field and not use expirations. Make a note of the name of the field and the name of the asset layout then call the script:
update-warrantyinfo -Hudu -HuduAPIKey "YourAPIKey" -HuduBaseURL "YourHuduDomain" -HuduDeviceAssetLayout "Desktops / Laptops" -HuduWarrantyField "Warranty Expiry" -SyncWithSource -OverwriteWarranty -ExcludeApple
To execute an update of all devices in BluetraitIO use:
update-warrantyinfo -BluetraitIO -BTAPIKEY "your_api_key" -BTAPIURL "https://example.bluetrait.io/api/" -SyncWithSource -OverwriteWarranty
To execute an update of all devices in SyncroMSP use (setup 2 custom asset fields in Syncro and provide their names):
update-warrantyinfo -Syncro -SyncroSubdomain $SyncroSubDomain -SyncroAPIKey $SyncroAPIKey -SyncroStartDateField "Purchase Date" -SyncroEndDateField "Warranty Expiration" -MissingOnly
Feel free to send pull requests or fill out issues when you encounter them. I'm also completely open to adding direct maintainers/contributors and working together! :) I'd love if we could make this into a huge help for our entire community.
Version 0.8 includes all things I required for myself, if you need a feature, shoot me a feature request :)