Skip to content

HOWTO IGEL Management Interface (IMI)

IGEL Management Interface (IMI) enables you to connect UMS to systems management tools. It is a programming interface that can create and delete thin clients, move them between directories, reboot them and much more. Its implementation as a REST API makes IMI agnostic of hardware platforms, operating systems and programming languages, thus ensuring maximum interoperability.


IMI Documentation


Powershell IGEL API

PSIGEL is a powershell module that makes use of the REST API provided by the IGEL Management Interface (IMI).



Sample Scripts

Script using the curl command

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
#!/bin/bash
set -x
trap read debug

#
# Sample IGEL IMI Commands
#

#
# Variables -- Edit for your UMS configuration
#

IGEL_Account="account:password"
IGEL_URL="https://igel-server-name:8443"

#
# Get IGEL Cookie header
#

COOKIEHDR=`curl --insecure --request POST --user "$IGEL_Account" $IGEL_URL/umsapi/v3/login | cut -c 13-99 | sed s/\"}$//`


# Get Asset Information

curl --insecure --request GET --header "Cookie: $COOKIEHDR" $IGEL_URL/umsapi/v3/assetinfo

# Get Asset Information for device id 64721 (replace with a valid ID)

#curl --insecure --request GET --header "Cookie: $COOKIEHDR" $IGEL_URL/umsapi/v3/thinclients/64721
#curl --insecure --request GET --header "Cookie: $COOKIEHDR" $IGEL_URL/umsapi/v3/thinclients/64721?facets=details

# Get Profile

curl --insecure --request GET --header "Cookie: $COOKIEHDR" $IGEL_URL/umsapi/v2/profiles

# Get Master Profile

curl --insecure --request GET --header "Cookie: $COOKIEHDR" $IGEL_URL/umsapi/v3/masterprofiles

# Get Thin Client Directory

curl --insecure --request GET --header "Cookie: $COOKIEHDR" $IGEL_URL/umsapi/v3/directories/tcdirectories

# Get Profile Directory

curl --insecure --request GET --header "Cookie: $COOKIEHDR" $IGEL_URL/umsapi/v3/directories/profiledirectories

# Get Firmware

curl --insecure --request GET --header "Cookie: $COOKIEHDR" $IGEL_URL/umsapi/v3/firmwares

# Get Server Status

curl --insecure --request GET --header "Cookie: COOKIEHDR" $IGEL_URL/umsapi/v3/serverstatus

# Logout

curl --insecure --request POST --header "Cookie: $COOKIEHDR" $IGEL_URL/umsapi/v3/logout