# Microsoft SCOM Integration

By connecting [Microsoft System Center Operations Manager](https://learn.microsoft.com/en-us/system-center/scom/welcome?view=sc-om-2025) (SCOM) to ilert, you centralize alert ingestion from Windows servers and applications. These technical alerts are routed to on-call teams for structured escalation, helping reduce response time and ensure system reliability.

## In ilert: Create an Microsoft SCOM alert source

1. Go to **Alert sources** --> **Alert sources** and click on **Create new alert source**

   <figure><img src="https://3394882078-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-M76ygPnS4HUcFSX8ulm%2Fuploads%2FjX0cS4q7woTXKajZmc1W%2FScreenshot%202023-08-28%20at%2010.21.10.png?alt=media&#x26;token=8ef3666b-84eb-4b51-abee-f07303313941" alt=""><figcaption></figcaption></figure>
2. Search for **Microsoft SCOM** in the search field, click on the Microsoft SCOM tile and click on **Next**.

   <figure><img src="https://3394882078-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-M76ygPnS4HUcFSX8ulm%2Fuploads%2FlXzQlJpaTFSR49AZk0xA%2FScreenshot%202023-08-28%20at%2010.24.23.png?alt=media&#x26;token=cffeacb4-57b9-47d4-827d-b0f6b1afd914" alt=""><figcaption></figcaption></figure>
3. Give your alert source a name, optionally assign teams and click **Next**.
4. Select an **escalation policy** by creating a new one or assigning an existing one.

   <figure><img src="https://3394882078-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-M76ygPnS4HUcFSX8ulm%2Fuploads%2FNnuZqONaIhbOf6fn4OkZ%2FScreenshot%202023-08-28%20at%2011.37.47.png?alt=media&#x26;token=8a74f7b5-5bd2-4eea-97fa-1c1dbb041333" alt=""><figcaption></figcaption></figure>
5. Select you [Alert grouping](https://docs.ilert.com/alerting/configure-alerting/alert-sources#alert-grouping) preference and click **Continue setup**. You may click **Do not group alerts** for now and change it later.

   <figure><img src="https://3394882078-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-M76ygPnS4HUcFSX8ulm%2Fuploads%2FueugN4JgHn1c90ggFA6u%2FScreenshot%202023-08-28%20at%2011.38.24.png?alt=media&#x26;token=b8009daf-3ca8-4264-a6fa-e42ef7333205" alt=""><figcaption></figcaption></figure>
6. The next page show additional settings such as customer alert templates or notification prioritiy. Click on **Finish setup** for now.
7. On the final page, an API key and / or webhook URL will be generated that you will need later in this guide.

   <figure><img src="https://3394882078-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-M76ygPnS4HUcFSX8ulm%2Fuploads%2FJ1QwcjLiVLOyieOrgmpC%2FScreenshot%202023-08-28%20at%2011.47.34.png?alt=media&#x26;token=72dc29a2-ded0-44cd-89bc-229bb0569626" alt=""><figcaption></figcaption></figure>

## In Microsoft SCOM: Add ilert Webhook as Channel

1. Download our script ilert.ps1.\
   Download links:\
   [ilert Microsoft SCOM](https://github.com/iLert/ilert-ms-scom)
2. Save this script into the following path:

   ```
   C:\scripts\ilert
   ```
3. In Microsoft SCOM Operations Console open the **Administration** view.

<figure><img src="https://3394882078-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-M76ygPnS4HUcFSX8ulm%2Fuploads%2FoNsd1VOb6gXqB5XplcpM%2Fms-scom-1.png?alt=media&#x26;token=18c0ab74-5f31-469f-890e-7a5b18588da3" alt=""><figcaption></figcaption></figure>

4. Navigate to **Notification**.

<figure><img src="https://3394882078-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-M76ygPnS4HUcFSX8ulm%2Fuploads%2F5ZjrZMaUJIFoiLurAW29%2Fms-scom-2.png?alt=media&#x26;token=e5a9c068-0a0e-4c52-886d-532b5e219b7d" alt=""><figcaption></figcaption></figure>

5. Create a new **Command** channel by right clicking on **Channels -> New channel -> Command...**

<figure><img src="https://3394882078-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-M76ygPnS4HUcFSX8ulm%2Fuploads%2FfJJV4W1sfMjJ2MUCzgAn%2Fms-scom-3.png?alt=media&#x26;token=94034245-896a-4da5-9415-a60b7bb6d1bd" alt=""><figcaption></figcaption></figure>

6. Enter a channel name and click on **Next**

<figure><img src="https://3394882078-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-M76ygPnS4HUcFSX8ulm%2Fuploads%2FfZXv3l0aW6eqh1c8dpdL%2Fms-scom-4.png?alt=media&#x26;token=f96146dd-848a-4248-86de-7c61535152c1" alt=""><figcaption></figcaption></figure>

7. Enter following into the input fields:\\
8. Enter following into the input fields and click on **Finish**:\\

   Full path of the command file:

   ```
   C:\windows\system32\windowspowershell\v1.0\powershell.exe
   ```

   \
   Command line parameters:\
   \&#xNAN;*Replace the parameter string "Enter API Key" with your ilert API Key created in* [*this step*](#in-ilert-create-microsoft-scom-alert-source)\_\_

   ```powershell
   -F "C:\scripts\ilert\ilert.ps1" -AlertID "$Data[Default='NotPresent']/Context/DataItem/AlertId$" -AlertSourceKey "Enter API Key"
   ```

   \
   Startup folder for the command line:

   ```
   C:\windows\system32\windowspowershell\v1.0\
   ```

<figure><img src="https://3394882078-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-M76ygPnS4HUcFSX8ulm%2Fuploads%2FHPKuivVEU1QvfdvFgoGk%2Fms-scom-5.png?alt=media&#x26;token=15f6d7c3-866e-4ab8-8c29-c52ae8e1234a" alt=""><figcaption></figcaption></figure>

9. Create a new Subscriber by right clicking on **Subscriber -> New subscriber...**![](https://3394882078-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-M76ygPnS4HUcFSX8ulm%2Fuploads%2FIL7j8rlTGye7EwtY9z1T%2Fimage.png?alt=media\&token=a51cb7e4-0a87-4540-b8a5-d1bf000e0536)
10. Select a user as subscriber and click on **Next**

<figure><img src="https://3394882078-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-M76ygPnS4HUcFSX8ulm%2Fuploads%2FUqDWjLb9wuTjg6SyI4fT%2Fms-scom-8.png?alt=media&#x26;token=07ea7eb3-1c7c-4cae-8584-2ad60822bb33" alt=""><figcaption></figcaption></figure>

12. Leave the schedule settings on default.

<figure><img src="https://3394882078-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-M76ygPnS4HUcFSX8ulm%2Fuploads%2F6fhlUedNorv9DcipkEcR%2Fms-scom-9.png?alt=media&#x26;token=e74f9679-8ad7-486b-94e3-83cd9a6832b6" alt=""><figcaption></figcaption></figure>

13. On the next view click on **Add...** to add a new subscriber address

<figure><img src="https://3394882078-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-M76ygPnS4HUcFSX8ulm%2Fuploads%2FtvfA3IYOEhROGxvsjSz3%2Fms-scom-10.png?alt=media&#x26;token=5c809c83-7386-4d24-ac75-fe8420180f87" alt=""><figcaption></figcaption></figure>

14. Enter an address name and click on **Next**

<figure><img src="https://3394882078-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-M76ygPnS4HUcFSX8ulm%2Fuploads%2Fyc2rXyKc0A5aeGlgRrzc%2Fms-scom-11.png?alt=media&#x26;token=6159a343-7755-4b7c-a442-3f3dbe78c8fd" alt=""><figcaption></figcaption></figure>

15. Select **Command** as **Channel Type** and **ilert Webhook** as **Command Channel**

<figure><img src="https://3394882078-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-M76ygPnS4HUcFSX8ulm%2Fuploads%2FceM704PLsMmxuW8viDPF%2Fms-scom-12.png?alt=media&#x26;token=d4e312cb-1730-4b4a-a1f5-13ef4ff32614" alt=""><figcaption></figcaption></figure>

16. Leave the schedule notification settings on **Always send notifications** and click on **Finish**
17. Create a new Subscription by right clicking on **Subscription -> New subscription...**![](https://3394882078-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-M76ygPnS4HUcFSX8ulm%2Fuploads%2FTfmwpS5TEOnMRkNoRNkh%2Fimage.png?alt=media\&token=51363dee-2a09-4b50-a5ac-6dd1e193f4ad)
18. Set a name and proceed to the next step

<figure><img src="https://3394882078-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-M76ygPnS4HUcFSX8ulm%2Fuploads%2FCSPKIiogLhVmh4XLX6HM%2Fms-scom-17.png?alt=media&#x26;token=b3394bee-6a02-49fa-b7b0-c198b7ab7fc4" alt=""><figcaption></figcaption></figure>

19. Specify a criteria for your subscription(Note: If selecting a condition, please remove the "Notify on all alerts" to prevent multiple identical alert submission). Leave this as "Notify on all alerts" to receive a notification on all alerts.

<figure><img src="https://3394882078-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-M76ygPnS4HUcFSX8ulm%2Fuploads%2FMYwfz4hTznIoAtuqKYKI%2Fms-scom-18.png?alt=media&#x26;token=2f4c8579-e87d-4248-b6a4-b3d357c3b21c" alt=""><figcaption></figcaption></figure>

20. Add the previously made **Subscriber** to the **Subscription**

<figure><img src="https://3394882078-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-M76ygPnS4HUcFSX8ulm%2Fuploads%2FqDW65AH5hSNExB9mHw7t%2Fms-scom-21.png?alt=media&#x26;token=43e0aff9-1164-4478-afd4-15caf4adeafe" alt=""><figcaption></figcaption></figure>

21. Add the previously made **Channel** to the **Subscription**

<figure><img src="https://3394882078-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-M76ygPnS4HUcFSX8ulm%2Fuploads%2FI9S7w7jNyNI5XmMrCAuq%2Fms-scom-23.png?alt=media&#x26;token=ff0d5d48-2c5b-48dc-bb1e-ad57d8ecb306" alt=""><figcaption></figcaption></figure>

22. Finish the setup

<figure><img src="https://3394882078-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-M76ygPnS4HUcFSX8ulm%2Fuploads%2Fw5oR1aDLTj2YwR5zr3fF%2Fms-scom-24.png?alt=media&#x26;token=a0b1934f-3ff7-48a7-8b1c-6d35c2d3f158" alt=""><figcaption></figcaption></figure>

## FAQ

**Will alerts in ilert be resolved automatically?**

Yes, as soon as an alert is being **closed** or marked as **resolved**, the alert in ilert will be resolved automatically.

**Will alerts in ilert be accepted automatically?**

Yes, as soon as an alert is being marked as **acknowledged**, the alert in ilert will be accepted automatically.
