> For the complete documentation index, see [llms.txt](https://hub.equipme.io/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://hub.equipme.io/pro/dokumentation/automation/connectors/microsoft-intune.md).

# Microsoft Intune

Microsoft Intune Connector für Provider: verwaltete Geräte in Kunden-Tenants abrufen und den Gerätebesitzer setzen – kombiniert mit Fulfillment in Equipme Pro.

**Pfad:** „Automation“ → „Workflows“ → Flow-Designer → Modul **„Microsoft Intune“**

Mit dem **Microsoft Intune Connector** greifst du als Provider auf die verwalteten Geräte in den Intune-Umgebungen deiner Kunden zu. Er liest Geräte und setzt den Gerätebesitzer. Kombiniert mit dem Modul [„Equipme Pro“](https://hub.equipme.io/pro/dokumentation/automation/connectors/equipme-pro.md) verbindest du so Auslieferung, Serviceinstanzen und Geräteverwaltung: Was du an einen Kundenmitarbeiter auslieferst, ist auch in dessen Intune richtig zugeordnet.

## Wofür?

* **Auslieferung abschließen:** Fulfillment-Position wird zugestellt → Gerät im Intune des Kunden dem Kundenmitarbeiter zuordnen.
* **Serviceinstanzen anreichern:** Betriebssystem, Version und letzten Kontakt aus Intune als Metadaten an der Serviceinstanz in Pro speichern.
* **Bestandsabgleich je Kunde:** Intune-Geräte des Kunden mit seinen Serviceinstanzen in Pro vergleichen und Abweichungen melden – z. B. als Grundlage für die Abrechnung.
* **Austausch und Rückgabe:** Vor einem Tausch prüfen, welche Geräte in Intune noch dem Mitarbeiter zugeordnet sind.

## Voraussetzungen

* Das freigeschaltete [Automation-Modul](https://hub.equipme.io/pro/dokumentation/automation.md)
* Je Kunde ein Microsoft-Konto **im Tenant des Kunden** mit der Rolle „Intune-Administrator“ (oder einer Rolle mit Lese- und Schreibrechten auf verwaltete Geräte)
* Eine **Microsoft Intune**-Lizenz im Kunden-Tenant
* Die Zustimmung zur Berechtigung für verwaltete Geräte im Kunden-Tenant (in der Regel eine **Administratorzustimmung** durch den Kunden)
* Für Beispiele mit Kundendaten eine Verbindung des [equipme Connectors](https://hub.equipme.io/pro/dokumentation/automation/connectors/equipme-pro.md) mit dem Modul „Equipme Pro“

## Verbindung einrichten

1. Im Flow-Designer eine Komponente des Moduls „Microsoft Intune“ auf die Arbeitsfläche ziehen (z. B. *ListDevices*).
2. **Connect account** klicken.
3. Im Anmeldefenster von Microsoft mit dem Konto **im Tenant des Kunden** anmelden und die angeforderten Berechtigungen bestätigen.
4. Die Verbindung erscheint unter **„Accounts“**. Gib ihr einen eindeutigen Namen mit dem Kundennamen und lege für jeden weiteren Kunden eine eigene Verbindung an.

{% hint style="info" %}
Eine Verbindung gilt für genau einen Tenant. „Microsoft Intune“, [„Microsoft Entra ID“](https://hub.equipme.io/pro/dokumentation/automation/connectors/microsoft-entra-id.md) und [„Microsoft Dynamics 365 Business Central“](https://hub.equipme.io/pro/dokumentation/automation/connectors/microsoft-business-central.md) nutzen dieselbe Microsoft-Anmeldung. Alle Aktionen laufen mit den Rechten des angemeldeten Kontos.
{% endhint %}

## Trigger

Der Connector bringt **keine eigenen Trigger** mit. Flows starten über andere Trigger – z. B. einen Trigger des Moduls [„Equipme Pro“](https://hub.equipme.io/pro/dokumentation/automation/connectors/equipme-pro.md) (*New Fulfillment Order*, *New Fulfillment Parcel*), einen Zeitplan (Scheduler) oder einen Webhook.

## Aktionen

| Komponente     | Zweck                                                                                                        | Wichtige Optionen                                                                  |
| -------------- | ------------------------------------------------------------------------------------------------------------ | ---------------------------------------------------------------------------------- |
| ListDevices    | Alle verwalteten Geräte lesen – mit Gerätename, Betriebssystem, Seriennummer, Benutzer und Compliance-Status | keine; liefert die Geräte als eine Liste                                           |
| GetDevice      | Ein verwaltetes Gerät lesen                                                                                  | Device ID (Intune-Geräte-ID)                                                       |
| SetDeviceOwner | Gerätebesitzer eines verwalteten Geräts setzen                                                               | Device ID, User principal name (UPN des Mitarbeiters, z. B. `max.muster@firma.de`) |

{% hint style="info" %}
*ListDevices* hat keine Einstellung „Output Type“. Um die Geräte einzeln weiterzuverarbeiten, schalte eine Komponente zum Aufteilen von Listen (z. B. aus den Utilities) dahinter.
{% endhint %}

## Beispiele

### Gerät nach Zustellung dem Kundenmitarbeiter zuordnen

1. **Scheduler** – stündlich (je Kunde ein Flow mit der Verbindung zu dessen Tenant).
2. **Equipme Pro › List Fulfillment Orders** – Positionen des Kunden mit zugestellter Lieferung.
3. **Equipme Pro › Get Service Instance** – Seriennummer und Kundenmitarbeiter der zugehörigen Serviceinstanz.
4. **Microsoft Intune › ListDevices** – Geräte des Kunden lesen und per **Filter** das Gerät mit derselben Seriennummer auswählen.
5. **Microsoft Intune › SetDeviceOwner** – Device ID aus Schritt 4, UPN des Kundenmitarbeiters.
6. **Equipme Pro › Set Service Instance Metadata Entry** – Intune-Geräte-ID an der Serviceinstanz speichern.

### Monatlicher Bestandsabgleich je Kunde

1. **Scheduler** – monatlich.
2. **Microsoft Intune › ListDevices** – alle verwalteten Geräte des Kunden.
3. **Equipme Pro › List Service Instances** – aktive Serviceinstanzen des Kunden (Filter „Customers“).
4. Beide Listen über die Seriennummer vergleichen; Abweichungen per **Email › Send Email** an den Account Manager melden oder als Ticket im eigenen PSA anlegen.

## Hinweise und Grenzen

* Der Connector arbeitet mit den **in Intune verwalteten** Geräten. Geräte, die nur in Entra ID registriert sind, liest du mit dem [Entra-ID-Connector](https://hub.equipme.io/pro/dokumentation/automation/connectors/microsoft-entra-id.md) (*ListDevices*, *ListUserDevices*).
* Die Device ID in Intune ist nicht dieselbe wie die Geräte-ID in Entra ID. Verwende für Intune-Aktionen immer die ID aus *ListDevices* bzw. *GetDevice* dieses Moduls.
* Speichere die Intune-Geräte-ID nach dem ersten Abgleich als Metadatum an der Serviceinstanz in Pro. Spätere Flows können dann direkt *GetDevice* verwenden.

## Fehlersuche

| Problem                                                                | Ursache / Lösung                                                                                                                              |
| ---------------------------------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------- |
| Anmeldung bei „Connect account“ verlangt eine Administratorgenehmigung | Ein globaler Administrator muss der Berechtigung für verwaltete Geräte im Tenant zustimmen.                                                   |
| Fehler „Forbidden“                                                     | Dem angemeldeten Konto fehlt eine Intune-Rolle, oder der Tenant hat keine Intune-Lizenz.                                                      |
| *GetDevice* findet das Gerät nicht                                     | Es wurde die Entra-ID-Geräte-ID statt der Intune-Geräte-ID übergeben.                                                                         |
| *SetDeviceOwner* schlägt fehl                                          | UPN prüfen (Tippfehler, Konto gesperrt oder gelöscht).                                                                                        |
| *ListDevices* liefert eine leere Liste                                 | Im Tenant sind keine Geräte in Intune registriert, oder das Konto sieht wegen eingeschränkter Bereichsmarkierungen nur einen Teil der Geräte. |

Protokolle jeder Ausführung findest du unter **„Insights“**. Für Unterstützung wende dich an den [Support](https://hub.equipme.io/pro/dokumentation/help/support.md).

## Häufige Fragen

**Kann ein Flow die Geräte mehrerer Kunden lesen?**

Nein, jede Komponente nutzt eine fest gewählte Verbindung und damit genau einen Kunden-Tenant. Lege je Kunde einen Flow an; mit „Clone“ kopierst du eine Vorlage schnell.

**Kann der Connector Geräte zurücksetzen oder sperren?**

Nein. Er liest Geräte und setzt den Gerätebesitzer. Remote-Aktionen wie Sperren oder Zurücksetzen führst du in Intune direkt aus.

**Welche Kennung verbindet ein Intune-Gerät mit einer Serviceinstanz?**

Am zuverlässigsten die Seriennummer. Nach dem ersten Abgleich speicherst du die Intune-Geräte-ID als Metadatum an der Serviceinstanz.


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://hub.equipme.io/pro/dokumentation/automation/connectors/microsoft-intune.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
