devynspencer/powershell-sdp-cloud

Interact with the ManageEngine ServiceDeskPlus OnDemand (cloud) API using PowerShell.

Oh, Hello 👋

• 🔭 I’m currently working on building APIs to help me keep track of everything.
• 🌱 I’m currently learning Flask.
• 👯 I’m looking to collaborate on anything!
• 💬 Ask me about PowerShell - I've written tools for everything under then sun.
• ⚡ Fun fact: Wish I had a fun fact.

powershell-sdp-cloud's Issues

Add function: Send-ServiceDeskMessage

There doesn't appear to be a built-in way to send messages via the API. That said, an email with the correct subject could be generated, and the ticket email determined and included as well.

Get-ServiceDeskRequest -Id 12345 | Send-ServiceDeskMessage -Text "Here is an email update to a specific user. It will be added to the ticket conversation." -To [e-mail] -Cc [e-mail]

Add function: Measure-ServiceDeskRequest

Provide metrics on one or more requests. Include individual parameters to customize the output.

Add pass-through switch to all functions

Add function: Resolve-ServiceDeskRequest

Update resolution and mark as resolved/closed in one action.

Add function: *-ServiceDeskCategory

Perform basic category operations

Verify tickets have a category that makes sense based on subject?

Add function: *-ServiceDeskWorklog

Add function: *-ServiceDeskChange

Pass boilerplate API parameters via the pipeline

Get-ServiceDeskRequest -AccessToken $AccessToken -Portal "helpdesk" -Id 12345 | Suspend-ServiceDeskRequest -Until "12/11/2020"

Get-ServiceDeskRequest -AccessToken $AccessToken -Portal "helpdesk" -Id 12345
    | Set-ServiceDeskRequest -Subject "New subject" | Resolve-ServiceDeskRequest

Add function: Copy-ServiceDeskRequest

Duplicate an existing request, while allowing for customizations:

Copy-ServiceDeskRequest -Id 12345 -Subject "Slightly different subject"

Add function: *-ServiceDeskAsset

Document function parameters

Add function: Merge-ServiceDeskRequest

Add function: *-ServiceDeskProblem

New-ServiceDeskProblem
Remove-ServiceDeskProblem

# Unsure of correct verb to attach request(s) to a problem
Add-ServiceDeskRequest
Add-ServiceDeskProblem
Connect-ServiceDeskProblem
Join-ServiceDeskProblem
Push-ServiceDeskRequest

API requests should only be made with valid inputs

No objects should be returned if no API call is made

Add function: *-ServiceDeskProject

Standardize output for requests that don't return a resource

Remove-ServiceDeskRequest
Resolve-ServiceDeskRequest
Approve-ServiceDeskRequest

Add function: *-ServiceDeskTask

Add-ServiceDeskTask -Request 12345 -Title "Perform action xyz" -Priority High
Update-ServiceDeskTask -Request 12345 -Title "Perform action abc" -Priority Low
Remove-ServiceDeskTask -Request 12345 -Id 1
Resolve-ServiceDeskTask -Request 12345 -Id 1

Support complex searches

Support searches using multiple categories, technicians etc.

Add function: Suspend-ServiceDeskRequest

Add function: *-ServiceDeskAttachment

Add-ServiceDeskAttachment -Request 12345 -Path C:\temp\abc.txt
Remove-ServiceDeskAttachment -Request 12345 -Id 1

Add function: Rename-ServiceDeskRequest

Not a direct consumer of an API resource - more of a convenience function.

# Rename a ticket
Get-ServiceDeskRequest -Id 12345 | Rename-ServiceDeskRequest -Subject "New subject here"

# Add a prefix to an existing ticket
Get-ServiceDeskRequest -Id 12345 | Rename-ServiceDeskRequest -Prefix "FIX: "

# Add a suffix to an existing ticket
Get-ServiceDeskRequest -Id 12345 | Rename-ServiceDeskRequest -Suffix "- DUPLICATE"