Skip to content

IvantiITSM

Description

PowerShell module for Ivanti ITSM RestAPI

Features

  • Connect to Ivanti ITSM using API keys, credentials, or session IDs.
  • Create, retrieve, update, and delete various business objects such as incidents, tasks, service requests, and more.
  • Manage configuration items (CIs) and link them to incidents, service requests, and changes.
  • Retrieve and manage notes, organizational units, and employees.
  • Invoke methods to interact with the Ivanti Service Manager (ISM) API.

Functions

Connection

  • Connect-IvantiInstance: Make API connection with Ivanti Instance.

Business Objects

  • New-BusinessObject: Creates a new business object in Ivanti ITSM.
  • Get-BusinessObject: Retrieves business objects from Ivanti ITSM.
  • Update-BusinessObject: Updates a business object in Ivanti ITSM.
  • Remove-BusinessObject: Removes a business object in Ivanti ITSM.
  • Assert-BusinessObject: Asserts the existence of a business object in Ivanti ITSM.

Incidents

  • New-Incident: Creates a new incident in Ivanti ITSM.
  • Get-Incident: Retrieves incidents from Ivanti ITSM.
  • Close-Incident: Closes an incident in Ivanti ITSM.

Tasks

  • New-Task: Creates a new task in Ivanti ITSM.
  • Get-Task: Retrieves tasks from Ivanti ITSM.
  • Close-Task: Closes a task in Ivanti ITSM.

Service Requests

  • New-ServiceRequest: Creates a new service request in Ivanti ITSM.
  • Get-ServiceRequest: Retrieves service requests from Ivanti ITSM.
  • Get-ServiceRequestParams: Retrieves service request parameters from Ivanti ITSM.
  • Get-ServiceRequestTemplate: Retrieves service request templates from Ivanti ITSM.
  • Get-ServiceRequestTemplateParams: Retrieves service request template parameters from Ivanti ITSM.
  • Get-ServiceRequestSubscription: Retrieves service request subscriptions from Ivanti ITSM.

Configuration Items (CIs)

  • New-CI: Creates a new configuration item in Ivanti ITSM.
  • Get-CI: Retrieves configuration items from Ivanti ITSM.
  • Update-CI: Updates a configuration item in Ivanti ITSM.
  • Add-LinkedCI: Links a configuration item to an incident, service request, or change in Ivanti ITSM.

Employees

  • New-Employee: Creates a new employee in Ivanti ITSM.
  • Get-Employee: Retrieves employees from Ivanti ITSM.

Notes

  • Get-Note: Retrieves notes from Ivanti ITSM.

Organizational Units

  • Get-OrganizationUnit: Retrieves organizational units from Ivanti ITSM.

Changes

  • Get-Change: Retrieves change records from Ivanti ITSM.

Announcements

  • Get-Announcement: Retrieves announcement records from Ivanti ITSM.

Private Functions

  • Invoke-Method: Calls the Ivanti Service Manager (ISM) endpoint. This is used by other functions and is not meant to be called directly.

Roadmap

  • More functions for problems.
  • More functions for Announcements
  • Incorporate linked CIs to problems and employees.

Changelog

  • 1/02/2025 - 14/03/2025: Implementation of Ivanti RestAPI in PSModule. Added Documentation.
  • 27/03/2025: Added Get-Announcement and Get-BusinessObjectURL functions.