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

Bericht über Windows-Geräte ohne Autopilot, geplant

Windows-Geräte in Entra ID ohne Autopilot-Eintrag melden

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

Listet Windows-Geräteobjekte in Entra ID auf, auf die keine Windows Autopilot-Registrierung verweist, zusammen mit ihrem Join-Typ. Entra-verbundene Objekte in der Liste sind oft Überreste von Geräten, die ohne Bereinigung zurückgesetzt, neu installiert oder ersetzt wurden, und können vor dem Löschen überprüft werden. Hybrid-verbundene und Entra registrierte Geräte werden ebenfalls aufgeführt, sind aber in der Regel in Verwendung. Es wird nichts geändert. Der Bericht kann per E-Mail gesendet oder als Downloadlink bereitgestellt werden.

Bericht über Windows-Geräte ohne Autopilot-Objekt

Dieses Runbook listet jedes Windows-Geräteobjekt in Entra ID auf und gleicht es mit den Windows Autopilot-Geräteidentitäten in Intune ab. Geräte, die kein zugeordnetes Autopilot-Objekt haben (abgeglichen über die Eigenschaft des Autopilot-Objekts azureActiveDirectoryDeviceId) werden mit ihrem Join-Typ gemeldet.

Die JoinType Spalte, die letzte Spalte des Berichts, wird aus der Eigenschaft des Geräteobjekts trustType:

  • Entra-verbunden (AzureAd) - Objekte ohne ein Autopilot-Objekt sind typischerweise Überreste von Geräten, die ohne Bereinigung zurückgesetzt, neu installiert oder ersetzt wurden. Das sind die Kandidaten für die Bereinigung; prüfen Sie sie, bevor Sie sie löschen.

  • Hybrid-verbunden (ServerAd) - domänenverbundene Geräte, die mit Entra ID synchronisiert sind. Sie werden angezeigt, wenn kein Autopilot-Objekt auf ihr Geräteobjekt verweist, sind aber normalerweise in Verwendung und nicht verwaist.

  • Entra registriert (Arbeitsplatz) - persönliche oder BYOD-Geräte, die von einem Benutzer registriert wurden. Sie sind normalerweise in Verwendung und nicht verwaist.

Löschen Sie hybrid-verbundene oder Entra registrierte Geräte nicht allein aufgrund dieses Berichts.

Jeder Lauf schreibt das Ergebnis als Output-Data-Tabellen (Zusammenfassung und Geräte), die im RealmJoin-Portal sortiert, gefiltert und exportiert werden können. Die Berichtsübermittlung Die Option fügt zusätzlich Berichtdateien hinzu:

  • Nur Output Data - keine Berichtsdateien.

  • Den Bericht zusätzlich per E-Mail senden - das Feld für die Empfängeradresse (EmailTo) wird angezeigt und der Bericht wird per E-Mail mit den angehängten Berichtsdateien gesendet.

  • Erstelle außerdem einen Downloadlink (Standard) - die Berichtsdateien werden in einen Azure Storage Account hochgeladen und ein zeitlich begrenzter Downloadlink wird zurückgegeben.

  • Den Bericht zusätzlich per E-Mail und Downloadlink senden - beides.

Format der Berichtdatei wählt CSV, XLSX oder beides für die Berichtsdateien.

Einrichtung bezüglich des Storage Accounts

Der CSV-Bericht wird in einen Azure Storage Account hochgeladen. Der Ziel-Storage Account wird aus dem freigegebenen RJReport Tenant-Einstellungen übernommen, sodass er einmal konfiguriert und für alle Bericht-Runbooks wiederverwendet werden kann:

  • RJReport.StorageAccount.ResourceGroup

  • RJReport.StorageAccount.StorageAccountName

  • RJReport.StorageAccount.SubscriptionId (optional, empfohlen; siehe Abonnement des Storage Account)

  • RJReport.StorageAccount.LinkExpiryDays (optional, Standardwert 6)

Der Containername wird pro Runbook konfiguriert (Parameter ContainerName, Standard windows-devices-without-autopilot) und ist absichtlich nicht Teil der globalen RJReport-Einstellungen.

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

Die verwaltete Identität des Automation Account benötigt die Reader and Data Access Rolle auf dem Storage Account.

Einrichtung in Bezug auf den E-Mail-Versand

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 Tenant-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 Anpassung des Runbooks eine vorhandene E-Mail-Adresse konfigurieren.

E-Mail-Branding

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

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

  • Footer-Link – Ziel des Footer-Bildes

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

Wenn diese Einstellungen nicht konfiguriert sind, werden die standardmäßigen RealmJoin-Grafiken und -Farben verwendet. Ein Bild, das nicht heruntergeladen oder validiert werden kann, oder ein ungültiger Farbwert verhindert die Berichts-E-Mail niemals – stattdessen wird der entsprechende Standard verwendet.

Einrichtungsanweisungen und Bildanforderungen: E-Mail-Branding.

Ort

Organisation → Geräte → Windows-Geräte ohne Autopilot melden (geplant)

Vollständiger Runbook-Name

rjgit-org_devices_report-windows-devices-without-autopilot_scheduled

Details

Eigenschaft
Wert

Version

1.4.0

Erforderliche Module

RealmJoin.RunbookHelper (>= 0.8.10) Microsoft.Graph.Authentication (>= 2.41.2) Az.Accounts (>= 5.5.2)

Planbar

ja

Berechtigungen

Anwendungsberechtigungen

  • Typ: Microsoft Graph

    • Device.Read.All

      • Listet Entra-Geräte gefiltert nach Windows auf, um alle registrierten Windows-Geräte aufzulisten

    • DeviceManagementServiceConfig.Read.All

      • Listet windowsAutopilotDeviceIdentities auf, um Geräte ohne Autopilot-Registrierung zu erkennen

    • Organization.Read.All

      • Liest /organization für den Tenant-Namen im Bericht

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

      • Sendet den Bericht über Send-RjReportEmail, wenn die E-Mail-Berichterstellung aktiviert ist

Hinweise zu Berechtigungen

Azure IaaS: - Contributor - Zugriff auf das für den Export verwendete Abonnement oder die Ressourcengruppe

Parameter

SendMail

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

Eigenschaft
Wert

Erforderlich

falsch

Standardwert

Falsch

Typ

Boolesch

Im Portal ausgeblendet

ja (vordefiniert über die Runbook-Anpassung)

EmailTo

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

Eigenschaft
Wert

Erforderlich

falsch

Standardwert

Typ

Zeichenfolge

Anzeigename im Portal

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

Im Portal ausgeblendet

ja (vordefiniert über die Runbook-Anpassung)

EmailFrom

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

Eigenschaft
Wert

Erforderlich

falsch

Standardwert

Typ

Zeichenfolge

Im Portal ausgeblendet

ja (vordefiniert über die Runbook-Anpassung)

BrandingHeaderImageUrl

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

Eigenschaft
Wert

Erforderlich

falsch

Standardwert

Typ

Zeichenfolge

Im Portal ausgeblendet

ja (vordefiniert über die Runbook-Anpassung)

BrandingFooterImageUrl

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

Eigenschaft
Wert

Erforderlich

falsch

Standardwert

Typ

Zeichenfolge

Im Portal ausgeblendet

ja (vordefiniert über die Runbook-Anpassung)

Link hinter dem Footerbild der Berichts-E-Mail. Wird aus der Tenant-Einstellung RJReport.Branding.FooterLink übernommen; wenn leer, wird realmjoin.com verwendet.

Eigenschaft
Wert

Erforderlich

falsch

Standardwert

Typ

Zeichenfolge

Im Portal ausgeblendet

ja (vordefiniert über die Runbook-Anpassung)

BrandingAccentColor

Akzentfarbe der Berichts-E-Mail als 6-stelliger Hex-Wert. Wird aus der Tenant-Einstellung RJReport.Branding.AccentColor übernommen; wenn leer oder ungültig, wird der RealmJoin-Standard verwendet.

Eigenschaft
Wert

Erforderlich

falsch

Standardwert

Typ

Zeichenfolge

Im Portal ausgeblendet

ja (vordefiniert über die Runbook-Anpassung)

BrandingTextColor

Textfarbe der Berichts-E-Mail als 6-stelliger Hex-Wert. Wird aus der Tenant-Einstellung RJReport.Branding.TextColor übernommen; wenn leer oder ungültig, wird der RealmJoin-Standard verwendet.

Eigenschaft
Wert

Erforderlich

falsch

Standardwert

Typ

Zeichenfolge

Im Portal ausgeblendet

ja (vordefiniert über die Runbook-Anpassung)

ReportFileFormat

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

Eigenschaft
Wert

Erforderlich

falsch

Standardwert

CSV & XLSX

Typ

Zeichenfolge

Anzeigename im Portal

Format der Berichtdatei

Im Portal ausgeblendet

ja (vordefiniert über die Runbook-Anpassung)

Portaloptionen

Portaloption
Wert

CSV & XLSX

CSV & XLSX

Nur CSV

Nur CSV

Nur XLSX

Nur XLSX

Lädt den Bericht zusätzlich hoch und gibt einen Downloadlink zurück, der nach einigen Tagen abläuft.

Eigenschaft
Wert

Erforderlich

falsch

Standardwert

Wahr

Typ

Boolesch

Im Portal ausgeblendet

ja (vordefiniert über die Runbook-Anpassung)

ContainerName

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

Eigenschaft
Wert

Erforderlich

falsch

Standardwert

windows-devices-without-autopilot

Typ

Zeichenfolge

Im Portal ausgeblendet

ja (vordefiniert über die Runbook-Anpassung)

ResourceGroupName

Ressourcengruppe des Storage Account für Bericht-Uploads. Wird aus der Tenant-Einstellung RJReport.StorageAccount.ResourceGroup übernommen.

Eigenschaft
Wert

Erforderlich

falsch

Standardwert

Typ

Zeichenfolge

Im Portal ausgeblendet

ja (vordefiniert über die Runbook-Anpassung)

StorageAccountName

Storage Account für Bericht-Uploads. Wird aus der Tenant-Einstellung RJReport.StorageAccount.StorageAccountName übernommen.

Eigenschaft
Wert

Erforderlich

falsch

Standardwert

Typ

Zeichenfolge

Im Portal ausgeblendet

ja (vordefiniert über die Runbook-Anpassung)

SubscriptionId

Abonnement-ID des Storage Account für Bericht-Uploads. Wird aus der Tenant-Einstellung RJReport.StorageAccount.SubscriptionId übernommen; wenn leer, wird das Abonnement verwendet, bei dem sich die verwaltete Identität anmeldet.

Eigenschaft
Wert

Erforderlich

falsch

Standardwert

Typ

Zeichenfolge

Im Portal ausgeblendet

ja (vordefiniert über die Runbook-Anpassung)

LinkExpiryDays

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

Eigenschaft
Wert

Erforderlich

falsch

Standardwert

6

Typ

Int32

Im Portal ausgeblendet

ja (vordefiniert über die Runbook-Anpassung)

Zuletzt aktualisiert

War das hilfreich?