Skip to content

HEAT

Description

PowerShell module for managing and automating tasks in Ivanti HEAT.

GitLab Repository

Features

  • Manage HEAT incidents, service requests, and tasks.
  • Automate the creation and updating of HEAT objects.
  • Retrieve and manipulate HEAT configuration items (CIs) and employee records.
  • Integrate HEAT with external systems like Intune and Active Directory.
  • Generate reports and logs for HEAT operations.

Functions

Connection

  • Connect-HEAT: Establishes a connection to the HEAT instance.
  • Disconnect-HEAT: Disconnects from the HEAT instance.
  • Assert-HEATConnection: Ensures a valid connection to the HEAT instance.

Incident and Task Management

  • New-HeatIncident: Creates a new incident in HEAT.
  • Invoke-HEATTask: Processes a single HEAT task.
  • Invoke-HEATTasks: Processes multiple HEAT tasks.
  • Close-HeatTask: Closes a HEAT task with optional automation messages.
  • Add-HEATTaskLog: Adds a log entry to a HEAT task.

Object Management

  • New-HeatObject: Creates a new object in HEAT.
  • Edit-HeatObject: Updates an existing object in HEAT.
  • Assert-HeatObject: Ensures the existence of an object in HEAT, creating or updating it as needed.
  • Remove-HeatObject: Deletes an object from HEAT.

Data Retrieval

  • Get-HeatObject: Retrieves objects from HEAT based on specified criteria.
  • Get-HEATTask: Retrieves details of a HEAT task.
  • Get-HEATEmployee: Retrieves employee records from HEAT.
  • Get-HEATRequestParameterList: Retrieves parameters for a HEAT service request template.

Utilities

  • Invoke-HeatSQL: Executes SQL queries against the HEAT database.
  • Start-HEATLogging: Starts logging for HEAT operations.
  • Stop-HEATLogging: Stops logging and optionally sends logs via email.
  • Write-HEATLog: Writes custom log entries for HEAT operations.

Dependencies

  • .NET Framework 4.8 or higher: Required for HEAT integration.
  • PasswordStateHelper: For securely managing HEAT credentials.

Roadmap

  • Add support for advanced HEAT configurations.
  • Enhance integration with external systems like Intune and SentinelOne.
  • Improve reporting capabilities for HEAT incidents and tasks.

Changelog

  • 01/01/2018: Initial release of the module.
  • 01/04/2025: Updated functions and documentation.