This module provides an abstraction layer for the SolarWinds Service Desk (SwSD) REST API, focused mainly on incidents (tickets). This module was built for my own needs, but further development will be based upon that and general public interest (volume of downloads) or feedback (see below).
Please submit feature enhancements or bug fixes by creating an Issue.
- PowerShell version: 5.1 or newer (Tested mostly on 7.5.1)
- Host platform: Windows, Linux, MacOS
- Other: An active Service Desk subscription and API token
Connect-SwSd -ApiToken "<YOUR TOKEN>"Connect-SwSdReturn a list of incidents by status and name.
$incidents = Get-SwSdIncident -Status "Pending Assignment" -Name "Request for New User Account"Return information for a single incident.
$incident = Get-SwSdIncident -Number 12345Update an incident to assign to a user.
Update-SwSdIncident -Number 12345 -Status "Assigned" -Assignee "jsmith@contoso.com"Update an incident to set the status to Closed.
Update-SwSdIncident -Number 12345 -Status "Closed"Get Tasks related to an incident.
Get-SwSdTask -IncidentNumber 12345Add a new Task to an incident.
New-SwSdTask -IncidentNumber 12345 -Name "Assign Laptop" -Assignee "bjones@contoso.com" -DueDateOffsetDays 7Update a Task on an incident to set status to Completed.
$task = Get-SwSdTask -IncidentNumber 12345 | Where-Object name -eq 'Assign Laptop'
Update-SwSdTask -TaskURL $task.href -Assignee "ctaylor@contoso.com" -CompletedHead over to the Issues page to send feedback. Thank you!
1.0.3 - 6/22/2025
| Action | Function | Description |
|---|---|---|
| Updated | (all functions) | Added outputtype() and aliases |
| Updated | Get-SwSdIncident | Added input parameter validation refinements |
1.0.2 - 5/2/2025
| Action | Function | Description |
|---|---|---|
| Added | Get-SwSdAuditLog | Returns audits (audit log) records |
| Added | Get-SwSdDepartment | Returns department records |
| Added | Get-SwSdMobileDevice | Returns mobile device records |
| Added | Get-SwSdOtherAsset | Returns Other Assets records |
| Added | Get-SwSdPrinter | Returns printers inventory |
| Added | Get-SwSdProblems | Returns problems records |
| Added | Get-SwSdPurchaseOrder | Returns purchase order records |
| Added | Get-SwSdSite | Returns sites or specified site information |
| Added | Get-SwSdVendor | Returns vendor records |
| Updated | New-SwSDTask | Revised DueDateOffsetDays to DueDate and made the default null |
| Updated | Update-SwSDTask | Updated help documentation |
1.0.1 - 4/16/2025
| Action | Function | Description |
|---|---|---|
| Fixed | Get-SwSdTask | Fixed bug in parameter reference and corrected the response JSON data |
| Updated | New-SwSdTask | Changed DueDateOffsetDays default from 14 to 7 days |
| Updated | Update-SwSdTask | Added support for DueDate property |
| Note | Tasks API | Still wondering why the Reminder property isn't exposed through the REST API |
1.0.0 - 4/12/2025
| Action | Description |
|---|---|
| Created | It was born. Cigars were smoked. Insurance was billed. |