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

Geplante Meldung veralteter Geräte

Geplanter Bericht über veraltete Geräte basierend auf dem Datum der letzten Aktivität und der Plattform.

Dies ist ein geplantes Runbook. Es ist dafür ausgelegt, nach einem wiederkehrenden Zeitplan ausgeführt zu werden, statt für ein einzelnes Objekt ausgelöst zu werden. Siehe Zeitplanung für Details zur Konfiguration von Runbook-Zeitplänen.

Beschreibung

Identifiziert und listet Geräte auf, die seit einer angegebenen Anzahl von Tagen nicht aktiv waren. Sendet automatisch einen Bericht per E-Mail mit CSV- und/oder Excel-(xlsx)-Anlagen. Die Berichtsdateien können auch in ein Azure Storage Account hochgeladen werden, wobei zeitlich begrenzte Download-Links zurückgegeben werden. Der Parameter ReportFileFormat steuert, welche Dateiformate generiert und bereitgestellt werden (nur CSV, CSV & XLSX oder nur XLSX). Wenn der CSV-Anhang das Größenlimit der E-Mail überschreitet und "CSV & XLSX" ausgewählt ist, weicht die E-Mail auf die Excel-Arbeitsmappe allein aus.

Einrichtung des E-Mail-Versands

Das Senden eines E-Mail-Berichts ist optional und erfolgt nur, wenn ein Empfänger (EmailTo) angegeben ist. Die Absenderadresse wird aus der RJReport.EmailSender Mandanteneinstellung bezogen.

Dieses Runbook versendet E-Mails mithilfe der 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.

Ort

Organisation → Geräte → Veraltete Geräte melden (geplant)

Vollständiger Runbook-Name

rjgit-org_devices_report-stale-devices_scheduled

Details

Eigenschaft
Wert

Version

1.3.0

Erforderliche Module

RealmJoin.RunbookHelper (>= 0.8.7) Microsoft.Graph.Authentication (>= 2.39.0) Az.Accounts (>= 5.3.4)

Planbar

ja

Hinweise

Dieses Runbook erstellt einen umfassenden Bericht über veraltete Geräte und sendet ihn per E-Mail. Der Bericht enthält Gerätedetails, Plattformaufteilungen und exportiert Berichtsdateien (CSV/xlsx) zur weiteren Analyse.

Voraussetzungen:

  • Der Parameter EmailFrom muss in der Runbook-Anpassung konfiguriert sein (Einstellung RJReport.EmailSender)

Typische Anwendungsfälle:

  • Regelmäßige Geräteinventurprüfungen und Compliance-Berichterstattung

  • Identifizierung von Geräten für die Außerbetriebnahme oder Ausmusterung

  • Sicherheitsprüfungen, um potenziell verlorene Geräte zu finden

  • Überwachung des Gerätezustands im gesamten Unternehmen

  • Verwendung des Parameters MaxDays für gestaffelte Berichte (z. B. 30-60 Tage, 60-90 Tage)

  • Filterung des Benutzerbereichs, um sich auf bestimmte Abteilungen zu konzentrieren oder Dienstkonten auszuschließen

Das Runbook unterstützt optionales Filtern des Benutzerbereichs, um Geräte basierend auf der Mitgliedschaft der primären Benutzergruppe ein- oder auszuschließen.

Berechtigungen

Anwendungsberechtigungen

  • Typ: Microsoft Graph

    • DeviceManagementManagedDevices.Read.All

    • Directory.Read.All

    • Device.Read.All

    • Mail.Send

Parameter

Tage

Anzahl der Tage ohne Aktivität, ab der ein Gerät als veraltet gilt.

Eigenschaft
Wert

Erforderlich

falsch

Standardwert

30

Typ

Int32

Anzeigename im Portal

Minimale Tage ohne Aktivität

MaxDays

Optionale maximale Anzahl an Tagen ohne Aktivität. Wenn festgelegt, werden nur Geräte berücksichtigt, die zwischen Days und MaxDays inaktiv waren.

Eigenschaft
Wert

Erforderlich

falsch

Standardwert

Typ

Int32

Anzeigename im Portal

(Optional) Maximale Tage ohne Aktivität

Windows

Windows-Geräte in die Ergebnisse aufnehmen.

Eigenschaft
Wert

Erforderlich

falsch

Standardwert

Wahr

Typ

Boolesch

Anzeigename im Portal

Windows-Geräte einschließen

MacOS

macOS-Geräte in die Ergebnisse aufnehmen.

Eigenschaft
Wert

Erforderlich

falsch

Standardwert

Wahr

Typ

Boolesch

Anzeigename im Portal

macOS-Geräte einschließen

iOS

iOS-Geräte in die Ergebnisse aufnehmen.

Eigenschaft
Wert

Erforderlich

falsch

Standardwert

Wahr

Typ

Boolesch

Anzeigename im Portal

iOS-Geräte einschließen

Android

Android-Geräte in die Ergebnisse aufnehmen.

Eigenschaft
Wert

Erforderlich

falsch

Standardwert

Wahr

Typ

Boolesch

Anzeigename im Portal

Android-Geräte einschließen

EmailFrom

Die E-Mail-Adresse des Absenders. Diese muss in der Runbook-Anpassung konfiguriert werden

Eigenschaft
Wert

Erforderlich

falsch

Standardwert

Typ

Zeichenfolge

Im Portal ausgeblendet

ja (vorkonfiguriert über Runbook-Anpassung)

ReportFileFormat

Steuert, welche Berichtsdateiformate generiert und bereitgestellt werden: „nur CSV“, „CSV & XLSX“ (Standard) oder „nur XLSX“.

Eigenschaft
Wert

Erforderlich

falsch

Standardwert

CSV & XLSX

Typ

Zeichenfolge

Anzeigename im Portal

Berichtsdateiformat

Portaloptionen

Portaloption
Wert

CSV & XLSX

nur CSV

nur XLSX

Wenn aktiviert, werden die Berichtsdateien in einen Azure Storage Account hochgeladen und zeitlich begrenzte Download-Links zurückgegeben. Standardmäßig deaktiviert.

Eigenschaft
Wert

Erforderlich

falsch

Standardwert

Falsch

Typ

Boolesch

Anzeigename im Portal

Einen Datei-Download-Link erstellen (Bericht in den Speicher hochladen)?

Portaloptionen

Portaloption
Wert

Ja - Bericht hochladen und einen Download-Link zurückgeben

wahr

Nein - keinen Download-Link erstellen

falsch

ContainerName

Name des Storage-Containers, der für den Upload verwendet wird. Pro Runbook konfiguriert (keine globale RJReport-Einstellung).

Eigenschaft
Wert

Erforderlich

falsch

Standardwert

report-stale-devices

Typ

Zeichenfolge

Im Portal ausgeblendet

ja (vorkonfiguriert über Runbook-Anpassung)

ResourceGroupName

Ressourcengruppe, die das Storage-Konto enthält. Stammt aus den RJReport-Mandanteneinstellungen.

Eigenschaft
Wert

Erforderlich

falsch

Standardwert

Typ

Zeichenfolge

Im Portal ausgeblendet

ja (vorkonfiguriert über Runbook-Anpassung)

StorageAccountName

Name des Storage-Kontos, der für den Upload verwendet wird. Stammt aus den RJReport-Mandanteneinstellungen.

Eigenschaft
Wert

Erforderlich

falsch

Standardwert

Typ

Zeichenfolge

Im Portal ausgeblendet

ja (vorkonfiguriert über Runbook-Anpassung)

LinkExpiryDays

Anzahl der Tage, bis der generierte Download-Link abläuft. Stammt aus den RJReport-Mandanteneinstellungen.

Eigenschaft
Wert

Erforderlich

falsch

Standardwert

6

Typ

Int32

Im Portal ausgeblendet

ja (vorkonfiguriert über Runbook-Anpassung)

UseUserScope

Das Filtern des Benutzerbereichs aktivieren, um Geräte basierend auf der Mitgliedschaft der primären Benutzergruppe ein- oder auszuschließen.

Eigenschaft
Wert

Erforderlich

falsch

Standardwert

Falsch

Typ

Boolesch

Anzeigename im Portal

Benutzerbereichsfilterung verwenden

Im Portal ausgeblendet

ja (vorkonfiguriert über Runbook-Anpassung)

IncludeUserGroup

Nur Geräte einbeziehen, deren primäre Benutzer Mitglieder dieser Gruppe sind. Erfordert, dass UseUserScope aktiviert ist.

Eigenschaft
Wert

Erforderlich

falsch

Standardwert

Typ

Zeichenfolge

Anzeigename im Portal

Einzuschließende Benutzer (Gruppe)

Im Portal ausgeblendet

ja (vorkonfiguriert über Runbook-Anpassung)

ExcludeUserGroup

Geräte ausschließen, deren primäre Benutzer Mitglieder dieser Gruppe sind. Erfordert, dass UseUserScope aktiviert ist.

Eigenschaft
Wert

Erforderlich

falsch

Standardwert

Typ

Zeichenfolge

Anzeigename im Portal

Auszuschließende Benutzer (Gruppe)

Im Portal ausgeblendet

ja (vorkonfiguriert über Runbook-Anpassung)

EmailTo

Wenn angegeben, wird eine E-Mail mit dem Bericht an die bereitgestellte(n) Adresse(n) gesendet. Kann eine einzelne Adresse oder mehrere durch Kommas getrennte Adressen (String) sein. Die Funktion sendet aus Datenschutzgründen einzelne E-Mails an jeden Empfänger.

Eigenschaft
Wert

Erforderlich

falsch

Standardwert

Typ

Zeichenfolge

Anzeigename im Portal

Empfänger-E-Mail-Adresse(n)

Zuletzt aktualisiert

War das hilfreich?