For the complete documentation index, see llms.txt. This page is also available as Markdown.

Mobilgeräte auflisten

Verwaltete Mobilgeräte mit Inventar- und Netzwerkdetails auflisten

Beschreibung

Listet alle von Intune verwalteten Android-, iOS- und iPadOS-Geräte mit ihrem Inventar auf: IMEI, Seriennummer, Telefonnummer, Netzbetreiber, Besitzart, Compliance und Registrierung. Optional werden die zuletzt gemeldete IP-Adresse und das Subnetz, ICCID, eSIM-Identifier, Mobilfunktechnologie, UDID, Akkuzustand und der Shared-iPad-Status hinzugefügt. Das zeigt, in welchen Netzwerken die Geräte zuletzt aktiv waren. Die Liste kann nach Plattform, einer Gerätegruppe oder einer Gruppe der primären Benutzer eingeschränkt werden. Der Bericht kann per E-Mail gesendet oder als Downloadlink bereitgestellt werden.

Häufige Anwendungsfälle

  • Inventar aller mobilen Geräte einschließlich IMEI, Seriennummer, Telefonnummer und Netzbetreiber

  • Ermitteln, in welchen (Wi-Fi-)Netzwerken mobile Geräte zuletzt aktiv waren, beispielsweise Handscanner an Lagerstandorten

  • Überprüfen des Compliance-, Überwachungs- und Verschlüsselungsstatus der mobilen Flotte

  • SIM/eSIM-Inventar über ICCID und eSIM-Identifier

  • Übergabe des vollständigen mobilen Inventars an das Asset-Management als Excel-Arbeitsmappe oder CSV-Datei

Ausgabespalten

Jeder Lauf schreibt eine Zusammenfassung Tabelle (Gerätezahlen pro Plattform, nicht konforme und persönlich genutzte Geräte und – mit aktivierten Netzwerkdetails – die Anzahl der Geräte ohne gemeldete IP-Adresse) sowie bis zu drei Gerätetabellen in die Registerkarte Output Data des RealmJoin-Portals. Die Konsolenausgabe zeigt dieselben Zählwerte plus die Aufschlüsselung nach Compliance-Status und Besitzart sowie die angewendeten Filter. Dieselben Daten können auch als Berichtsdateien per E-Mail und/oder als Downloadlink bereitgestellt werden; siehe den Abschnitt zur Berichtsbereitstellung unten.

Inventar (immer angezeigt)

Spalte
Quelle und Bedeutung

DeviceName

Gerätename wie von Intune gemeldet

PrimaryUser

UPN des primären Benutzers

OperatingSystem / OSVersion

Betriebssystem (Android, iOS, iPadOS) und Version

Manufacturer / Model

Hardwarehersteller und Modell

Seriennummer

Hardware-Seriennummer

IMEI

International Mobile Equipment Identity des Geräts

PhoneNumber

Telefonnummer der SIM – nur vorhanden, wenn IncludePhoneNumber aktiviert ist, andernfalls wird die Spalte vollständig weggelassen

Carrier

Netzbetreiber der SIM

Besitzart

Unternehmen oder privat

Compliance

Intune-Compliance-Status

LastSync

Zeitstempel des letzten erfolgreichen Intune-Check-ins

Sicherheit und Registrierung (immer angezeigt)

Spalte
Quelle und Bedeutung

Beaufsichtigt

iOS/iPadOS-beaufsichtigter Modus

Verschlüsselt

Verschlüsselungsstatus des Geräts

Jailbroken

Ob das Gerät jailbroken oder gerootet ist

ThreatState

Vom Mobile Threat Defense-Partner gemeldeter Bedrohungsstatus (nur sinnvoll, wenn ein MTD-Partner verbunden ist)

PatchLevel

Android-Sicherheitspatchstand (leer unter iOS/iPadOS)

EnrollmentType / EnrollmentProfile

Wie das Gerät registriert wurde und das verwendete Registrierungsprofil

Kategorie

Intune-Gerätekategorie

FreeGB / TotalGB

Freier und gesamter Speicherplatz (leer, wenn das Gerät keinen nutzbaren Speicherbestand meldet, was bei Android Enterprise-Arbeitsprofilen üblich ist)

Registriert

Registrierungsdatum

Netzwerk und SIM (nur mit IncludeNetworkDetails aktiviert – standardmäßig deaktiviert)

Spalte
Quelle und Bedeutung

IPv4 / Subnetz

Zuletzt vom Gerät gemeldete IP-Adresse und Subnetz – der beste Hinweis auf das (Wi-Fi-)Netzwerk, in dem das Gerät zuletzt aktiv war

WiFiMAC

Wi-Fi-MAC-Adresse des Geräts

ICCID

Eindeutige Identifikationsnummer der SIM-Karte

ESIM

eSIM-Identifier, wenn eine eSIM bereitgestellt ist

Cellular

Mobilfunktechnologie des Geräts

UDID

Eindeutiger Gerätebezeichner (iOS/iPadOS)

BatteryHealth

Prozentualer Akkuzustand, sofern gemeldet

Geteilt

Ob es sich beim Gerät um ein Shared iPad handelt

LastSync

Zeitstempel des letzten erfolgreichen Intune-Check-ins – gibt an, wie alt die IP-Informationen sind

Diese Tabelle ist nach Subnetz sortiert, sodass die Geräte visuell nach dem Netzwerk gruppiert werden, in dem sie zuletzt gesehen wurden.

Aktualität der Daten und Einschränkungen

Alle Werte beschreiben den Zustand des letzten erfolgreichen Intune-Geräte-Check-ins, nicht unbedingt den aktuellen Zustand – interpretieren Sie sie immer zusammen mit der LastSync-Spalte. Intune meldet die Wi-Fi-SSID eines Geräts nicht; die letzte IP-Adresse und das Subnetz sind der beste Netzwerkindikator. Beachten Sie, dass die gemeldete IP-Adresse auch von einer Mobilfunkverbindung stammen kann, wenn das Gerät zuletzt über mobile Daten eingecheckt hat. Intune maskiert einen Teil der Telefonnummer persönlich genutzter Geräte unabhängig von der IncludePhoneNumber Einstellung

Leistungsaspekte

Die Netzwerk-/SIM-Details sind standardmäßig deaktiviert und sollten in großen Tenants oder bei vielen mobilen Geräten mit Vorsicht aktiviert werden: Microsoft Graph gibt diese Werte nur bei einer Einzelgeräteanforderung zurück, nicht in der Antwort der Geräteliste. Das Runbook sendet diese Anforderungen immer über den Graph-Batch-Endpunkt in Blöcken von bis zu 20, aber die Laufzeit wächst dennoch linear mit der Anzahl der Geräte – Tausende mobile Geräte bedeuten entsprechend lange Laufzeiten und ein erhöhtes Risiko für Graph-Drosselung (gedrosselte Anforderungen werden mit der von Graph gemeldeten Wartezeit automatisch erneut versucht). In großen Umgebungen kombinieren IncludeNetworkDetails mit den Gruppenbereichsfiltern.

Bereichsfilterung

Der Geltungsbereich kann auf die Mitglieder einer Entra-Gerätegruppe (IncludeDeviceGroup)IncludeUserGroup). Wenn beide Filter gesetzt sind, muss ein Gerät beide erfüllen. Transitive Mitgliedschaften werden aufgelöst, daher sind Mitglieder verschachtelter Gruppen eingeschlossen.

Berichtszustellung

Berichtsdateien werden nur erzeugt, wenn die Berichtszustellung Option eine E-Mail oder einen Downloadlink enthält. Mit Nur Ausgabedaten ausgewählter Option werden die Ergebnisse direkt in der Registerkarte Output Data des RealmJoin-Portals gelesen, wo jede Tabelle auch nach Excel exportiert werden kann. E-Mail-Zustellung und Downloadlink-Erstellung sind unabhängig und können kombiniert werden; die Berichtsdateiformat standardmäßig nur die Excel-Arbeitsmappe.

  • E-Mail: sendet eine Zusammenfassungs-E-Mail mit dem vollständigen Inventar als CSV und/oder Excel-Arbeitsmappe im Anhang. Wenn der CSV-Anhang das Größenlimit für E-Mails überschreitet und CSV & XLSX ausgewählt ist, weicht die E-Mail auf die Excel-Arbeitsmappe allein aus. Wenn kein mobiles Gerät übereinstimmt, teilt die E-Mail mit, dass kein Gerät gefunden wurde, und enthält keinen Anhang.

  • Downloadlink: lädt die Berichtsdatei(en) in den Azure Storage Account hoch, der in den RJReport.StorageAccount.* Tenant-Einstellungen (Container list-mobile-devices standardmäßig) konfiguriert ist, und gibt zeitlich begrenzte SAS-Downloadlinks in der Jobausgabe aus. Geeignet, wenn das Inventar zu groß für einen E-Mail-Anhang ist oder direkt an das Asset-Management übergeben werden soll. Der Upload in den Azure Storage Account authentifiziert sich mit der verwalteten Identität des Automation-Kontos; diese Identität benötigt die Storage Account Contributor RBAC-Rolle auf dem Ziel-Storage Account (dies ist eine Azure-RBAC-Zuweisung, keine Graph-Anwendungsberechtigung).

Die Berichtsdateien enthalten alle Spalten der obigen Tabellen, einschließlich der DeviceId. Die PhoneNumber und die Netzwerk-/SIM-Spalten sind nur Teil der Dateien, wenn die entsprechenden Optionen aktiviert sind. Nicht konforme Geräte werden in der Excel-Arbeitsmappe hervorgehoben. Es werden keine Dateien erstellt, wenn kein mobiles Gerät den ausgewählten Plattformen und Filtern entspricht.

Zeitpläne, die vor der Berichtszustellung diese Option existierte, senden weiterhin ihre E-Mail: Ein gespeicherter Empfänger allein aktiviert die E-Mail für sie weiterhin. Wenn ein solcher Zeitplan zum Bearbeiten geöffnet wird, zeigt die Option Nur Ausgabedaten; wählen Sie die Zustellung vor dem Speichern erneut aus, andernfalls sendet der Zeitplan den Bericht nicht mehr.

Einrichtung für den E-Mail-Versand

Das Senden eines E-Mail-Berichts ist optional und erfolgt nur, wenn die Berichtszustellung Option eine E-Mail enthält; dann ist ein Empfänger erforderlich. Die Absenderadresse wird aus der RJReport.EmailSender Mandanten-Einstellung übernommen.

Dieses Runbook sendet E-Mails über die Microsoft Graph API. Um E-Mails über die Graph API zu senden, müssen Sie in der Runbook-Anpassung eine vorhandene E-Mail-Adresse konfigurieren.

Siehe die RealmJoin Report Settings Dokumentation für Details zu allen verfügbaren Einstellungen.

E-Mail-Branding

Die Berichts-E-Mail berücksichtigt die optionalen RJReport.Branding.* Mandanten-Einstellungen:

  • Header- und Footer-Bild - öffentliche HTTPS-URLs, PNG/JPEG/GIF, max. 200 KB jeweils

  • Footer-Link - Ziel des Fußzeilenbildes

  • Akzent- und Textfarbe - 6-stellige Hex-Werte, z. B. #0052cc

Wenn diese Einstellungen nicht konfiguriert sind, werden die Standardgrafiken und -farben von RealmJoin verwendet. Ein Bild, das nicht heruntergeladen oder validiert werden kann, oder ein ungültiger Farbwert verhindert niemals die E-Mail des Berichts – stattdessen wird der entsprechende Standard verwendet.

Einrichtungsanweisungen und Bildanforderungen: E-Mail-Branding.

Ort

Organisation → Geräte → Mobile Geräte auflisten

Vollständiger Runbook-Name

rjgit-org_devices_list-mobile-devices

Details

Eigenschaft
Wert

Version

1.1.0

Erforderliche Module

RealmJoin.RunbookHelper (>= 0.8.9) Microsoft.Graph.Authentication (>= 2.39.0) Az.Accounts (>= 5.5.2)

Planbar

nein

Berechtigungen

Anwendungsberechtigungen

  • Typ: Microsoft Graph

    • DeviceManagementManagedDevices.Read.All

      • Listet von Intune verwaltete mobile Geräte einschließlich Hardware-, SIM- und Netzwerkdetails auf

    • Directory.Read.All (optional — Funktion: Gruppenbereichsfilterung)

      • Liest Gruppenmitglieder, um die optionalen Bereichsfilter für Geräte-/Benutzergruppen aufzulösen

    • Mail.Send (optional — Funktion: E-Mail-Bericht)

      • Sendet die Berichts-E-Mail über Send-RjRbReportEmail, wenn die E-Mail-Zustellung ausgewählt ist

    • Organization.Read.All (optional — Funktion: E-Mail-Bericht)

      • Liest /organization für den Tenant-Namen, der in den Berichtsdateinamen, im E-Mail-Betreff und in der E-Mail-Fußzeile verwendet wird; ohne ihn fällt das Runbook auf 'Unknown Tenant' zurück

Hinweise zu Berechtigungen

Azure Storage Account: Rolle „Storage Account Contributor“ für die verwaltete Identität des Automation-Kontos auf dem Ziel-Storage Account – der Upload ruft die Kontoschlüssel über listKeys ab (nur für die Download-Link-Optionen erforderlich)

Parameter

Android

Schließt Android-Geräte ein.

Eigenschaft
Wert

Erforderlich

nein

Standardwert

Wahr

Typ

Boolesch

Anzeigename im Portal

Android-Geräte einschließen?

iOS

Schließt iOS- und iPadOS-Geräte ein.

Eigenschaft
Wert

Erforderlich

nein

Standardwert

Wahr

Typ

Boolesch

Anzeigename im Portal

iOS-/iPadOS-Geräte einschließen?

IncludeNetworkDetails

Fügt IP-Adresse, Subnetz, ICCID, eSIM-Identifier, Mobilfunktechnologie, UDID, Akkuzustand und Shared-iPad-Status hinzu. Benötigt eine zusätzliche Anforderung pro Gerät, daher dauern große Tenants länger.

Eigenschaft
Wert

Erforderlich

nein

Standardwert

Falsch

Typ

Boolesch

Anzeigename im Portal

Netzwerk- und SIM-Details einbeziehen?

IncludePhoneNumber

Zeigt die Spalte mit der Telefonnummer. Intune maskiert ohnehin einen Teil der Nummer auf persönlich genutzten Geräten.

Eigenschaft
Wert

Erforderlich

nein

Standardwert

Wahr

Typ

Boolesch

Anzeigename im Portal

Telefonnummern einbeziehen?

IncludeDeviceGroup

Nur Geräte in dieser Entra ID-Gruppe, verschachtelte Gruppen eingeschlossen. Leer lassen für alle mobilen Geräte.

Eigenschaft
Wert

Erforderlich

nein

Standardwert

Typ

Zeichenfolge

Anzeigename im Portal

Auf Geräte in Gruppe beschränken

IncludeUserGroup

Nur Geräte, deren primärer Benutzer in dieser Gruppe ist, verschachtelte Gruppen eingeschlossen. Leer lassen für alle.

Eigenschaft
Wert

Erforderlich

nein

Standardwert

Typ

Zeichenfolge

Anzeigename im Portal

Auf primäre Benutzer in der Gruppe beschränken

EmailFrom

Absenderadresse der Berichts-E-Mail. Wird aus der Mandanten-Einstellung RJReport.EmailSender übernommen.

Eigenschaft
Wert

Erforderlich

nein

Standardwert

Typ

Zeichenfolge

Im Portal ausgeblendet

ja (vorkonfiguriert über Runbook-Anpassung)

BrandingHeaderImageUrl

Headerbild der Berichts-E-Mail (HTTPS-URL, PNG/JPEG/GIF, max. 200 KB). Wird aus der Mandanten-Einstellung RJReport.Branding.HeaderImageUrl übernommen; bei leerem Wert wird der standardmäßige RealmJoin-Header verwendet.

Eigenschaft
Wert

Erforderlich

nein

Standardwert

Typ

Zeichenfolge

Im Portal ausgeblendet

ja (vorkonfiguriert über Runbook-Anpassung)

BrandingFooterImageUrl

Footerbild der Berichts-E-Mail (HTTPS-URL, PNG/JPEG/GIF, max. 200 KB). Wird aus der Mandanten-Einstellung RJReport.Branding.FooterImageUrl übernommen; bei leerem Wert wird der standardmäßige RealmJoin-Footer verwendet.

Eigenschaft
Wert

Erforderlich

nein

Standardwert

Typ

Zeichenfolge

Im Portal ausgeblendet

ja (vorkonfiguriert über Runbook-Anpassung)

Link hinter dem Footerbild der Berichts-E-Mail. Wird aus der Mandanten-Einstellung RJReport.Branding.FooterLink übernommen; bei leerem Wert wird realmjoin.com verwendet.

Eigenschaft
Wert

Erforderlich

nein

Standardwert

Typ

Zeichenfolge

Im Portal ausgeblendet

ja (vorkonfiguriert über Runbook-Anpassung)

BrandingAccentColor

Akzentfarbe der Berichts-E-Mail als 6-stelliger Hexwert. Wird aus der Mandanten-Einstellung RJReport.Branding.AccentColor übernommen; bei leerem oder ungültigem Wert wird der Standard von RealmJoin verwendet.

Eigenschaft
Wert

Erforderlich

nein

Standardwert

Typ

Zeichenfolge

Im Portal ausgeblendet

ja (vorkonfiguriert über Runbook-Anpassung)

BrandingTextColor

Textfarbe der Berichts-E-Mail als 6-stelliger Hexwert. Wird aus der Mandanten-Einstellung RJReport.Branding.TextColor übernommen; bei leerem oder ungültigem Wert wird der Standard von RealmJoin verwendet.

Eigenschaft
Wert

Erforderlich

nein

Standardwert

Typ

Zeichenfolge

Im Portal ausgeblendet

ja (vorkonfiguriert über Runbook-Anpassung)

ReportFileFormat

Stellen Sie den Bericht als CSV, als Excel-Arbeitsmappe oder beides bereit.

Eigenschaft
Wert

Erforderlich

nein

Standardwert

Nur XLSX

Typ

Zeichenfolge

Anzeigename im Portal

Berichtsdateiformat

Im Portal ausgeblendet

ja (vorkonfiguriert über Runbook-Anpassung)

Portaloptionen

Portaloption
Wert

CSV & XLSX

CSV & XLSX

Nur CSV

Nur CSV

Nur XLSX

Nur XLSX

Laden Sie den Bericht außerdem hoch und geben Sie einen Downloadlink zurück, der nach einigen Tagen abläuft.

Eigenschaft
Wert

Erforderlich

nein

Standardwert

Falsch

Typ

Boolesch

Im Portal ausgeblendet

ja (vorkonfiguriert über Runbook-Anpassung)

ContainerName

Speichercontainer, in den die Berichtsdateien hochgeladen werden. Pro Runbook festlegen.

Eigenschaft
Wert

Erforderlich

nein

Standardwert

list-mobile-devices

Typ

Zeichenfolge

Im Portal ausgeblendet

ja (vorkonfiguriert über Runbook-Anpassung)

ResourceGroupName

Ressourcengruppe des Storage Account für Berichtshochladungen. Aus der Tenant-Einstellung RJReport.StorageAccount.ResourceGroup übernommen.

Eigenschaft
Wert

Erforderlich

nein

Standardwert

Typ

Zeichenfolge

Im Portal ausgeblendet

ja (vorkonfiguriert über Runbook-Anpassung)

StorageAccountName

Storage Account für Berichtshochladungen. Aus der Tenant-Einstellung RJReport.StorageAccount.StorageAccountName übernommen.

Eigenschaft
Wert

Erforderlich

nein

Standardwert

Typ

Zeichenfolge

Im Portal ausgeblendet

ja (vorkonfiguriert über Runbook-Anpassung)

LinkExpiryDays

Anzahl der Tage, die ein Downloadlink gültig bleibt. Aus der Tenant-Einstellung RJReport.StorageAccount.LinkExpiryDays übernommen.

Eigenschaft
Wert

Erforderlich

nein

Standardwert

6

Typ

Int32

Im Portal ausgeblendet

ja (vorkonfiguriert über Runbook-Anpassung)

SendEmailReport

Sendet den Bericht an die E-Mail-Adresse des Empfängers.

Eigenschaft
Wert

Erforderlich

nein

Standardwert

Falsch

Typ

Boolesch

Im Portal ausgeblendet

ja (vorkonfiguriert über Runbook-Anpassung)

EmailTo

Senden Sie den Bericht an diese Adressen. Trennen Sie mehrere mit Kommas; jeder Empfänger erhält eine separate E-Mail.

Eigenschaft
Wert

Erforderlich

nein

Standardwert

Typ

Zeichenfolge

Anzeigename im Portal

E-Mail-Adresse(n) des Empfängers

Im Portal ausgeblendet

ja (vorkonfiguriert über Runbook-Anpassung)

Zuletzt aktualisiert

War das hilfreich?