Primäre Benutzer von Geräten zu Gruppe hinzufügen, geplant

Eine Gruppe mit den primären Benutzern von Intune-Geräten synchron halten

Dies ist ein geplantes Runbook. Es ist dafür vorgesehen, 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

Erfasst die Primärbenutzer aller Intune-Geräte der gewählten Plattformen und hält eine Entra ID-Gruppe mit ihnen synchron. Benutzer ohne passendes Gerät werden entfernt, sofern das Entfernen nicht deaktiviert ist. Eine Einschlussgruppe begrenzt, welche Benutzer zulässig sind; eine Ausschlussgruppe blockiert Benutzer. Ein Nur-Bericht-Modus zeigt die Änderungen per E-Mail in der Vorschau an, ohne etwas anzuwenden.

Häufige Anwendungsfälle

• Eine Verteilungs- oder Conditional Access-Zielgruppe mit „wer aktuell ein verwaltetes Gerät hat“ synchron halten, gefiltert nach Plattform, über einen erweiterten OData-Filter oder über einen Einschluss-/Ausschlussgruppenbereich.
• Validierung eines neuen oder geänderten Filters oder Bereichs, bevor er in eine Produktionsgruppe schreiben darf.

Ein täglicher Zeitplan wird empfohlen.

Nur-Bericht-Modus für Pilotprojekte und Tests

Aktivieren Nur-Bericht um denselben Hinzufügen-/Entfernen-Unterschied zu berechnen, den ein echter Lauf erzeugen würde, ohne eine Änderung an der Gruppe anzuwenden. Stattdessen wird eine Markdown-Vorschau-E-Mail mit den betroffenen Benutzern nach UPN an EmailTo: jede Liste (würde hinzugefügt, würde entfernt) zeigt im E-Mail-Text höchstens 10 Benutzer, mit einem Hinweis „... und N weitere“, wenn eine Liste länger ist, und die vollständigen Listen sind als Berichtsdatei(en) im von ReportFileFormat. Führen Sie diesen Modus einmal aus, nachdem Sie die Plattformauswahl geändert haben, Erweiterter Filter oder die Einschluss-/Ausschlussgruppen, prüfen Sie die Vorschau und deaktivieren Sie dann Nur-Bericht damit die Synchronisierung angewendet wird.

Wechselwirkungen der Parameter

• Erweiterter Filter, wenn festgelegt, ersetzt die Windows/macOS/iOS/Android-Plattformauswahl vollständig, anstatt sie mit ihr zu kombinieren.
• Benutzer entfernen, wenn kein Gerät übereinstimmt steuert sowohl den echten Lauf als auch die Nur-Bericht Vorschau: Wenn deaktiviert, werden in beiden Fällen keine Benutzer entfernt, sodass die Vorschau immer widerspiegelt, was ein echter Lauf tun würde.

Einrichtung für den E-Mail-Versand

Das Senden eines E-Mail-Berichts ist optional und erfolgt nur, wenn die Nur-Bericht Option aktiviert ist; ein Empfänger (EmailTo) ist dann erforderlich. Die Absenderadresse wird aus dem 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, jeweils max. 200 KB
• Footer-Link – Ziel des Footer-Bildes
• Akzent- und Textfarbe – 6-stellige Hexwerte, 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 niemals die Berichts-E-Mail – stattdessen wird der entsprechende Standard verwendet.

Einrichtungsanweisungen und Bildanforderungen: E-Mail-Branding.

Ort

Organisation → Allgemein → Primäre Benutzer von Geräten zur Gruppe hinzufügen (geplant)

Vollständiger Runbook-Name

rjgit-org_general_add-primary-users-of-devices-to-group_scheduled

Details

Eigenschaft	Wert
Version	1.2.0
Erforderliche Module	RealmJoin.RunbookHelper (>= 0.8.9) Microsoft.Graph.Authentication (>= 2.39.0)
Planbar	ja

Berechtigungen

Anwendungsberechtigungen

• Typ: Microsoft Graph

  • DeviceManagementManagedDevices.Read.All

    • Liest von Intune verwaltete Geräte, gefiltert nach Betriebssystem, um den Primärbenutzer jedes Geräts zu erfassen
  • Group.Read.All

    • Validiert die Ziel-/Einschluss-/Ausschlussgruppen und liest deren Mitgliedslisten
  • GroupMember.ReadWrite.All

    • Fügt Benutzer in der Zielgruppe über gebündelte /groups/{id}/members/$ref-Aufrufe hinzu und entfernt sie
  • User.Read.All

    • Liest die Mitglieds-ID und UPN, um Benutzer-Mitglieder zu identifizieren und Entfernungen zu protokollieren

Parameter

TargetGroupId

Gruppe, die die Primärbenutzer empfängt. Ihre Mitgliedschaft wird ausschließlich von diesem Runbook verwaltet.

Eigenschaft	Wert
Erforderlich	ja
Standardwert
Typ	Zeichenfolge
Anzeigename im Portal	Zielgruppe

Windows

Enthält die Primärbenutzer von Windows-Geräten.

Eigenschaft	Wert
Erforderlich	nein
Standardwert	Falsch
Typ	Boolesch
Anzeigename im Portal	Windows-Geräte einbeziehen?

macOS

Enthält die Primärbenutzer von macOS-Geräten.

Eigenschaft	Wert
Erforderlich	nein
Standardwert	Falsch
Typ	Boolesch
Anzeigename im Portal	macOS-Geräte einbeziehen?

iOS

Enthält die Primärbenutzer von iOS- und iPadOS-Geräten.

Eigenschaft	Wert
Erforderlich	nein
Standardwert	Falsch
Typ	Boolesch
Anzeigename im Portal	iOS-Geräte einschließen?

Android

Enthält die Primärbenutzer von Android-Geräten.

Eigenschaft	Wert
Erforderlich	nein
Standardwert	Falsch
Typ	Boolesch
Anzeigename im Portal	Android-Geräte einschließen?

Erweiterter Filter

OData-Filter für die Geräte statt der Plattformschalter, zum Beispiel startsWith(deviceName,'FWP-') und operatingSystem eq 'Windows'.

Eigenschaft	Wert
Erforderlich	nein
Standardwert
Typ	Zeichenfolge
Anzeigename im Portal	Benutzerdefinierter Filter

Benutzer entfernen, wenn kein Gerät übereinstimmt

Entfernt Benutzer aus der Zielgruppe, wenn sie nicht mehr Primärbenutzer eines passenden Geräts sind. Deaktivieren, um nur hinzuzufügen.

Eigenschaft	Wert
Erforderlich	nein
Standardwert	Wahr
Typ	Boolesch
Anzeigename im Portal	Benutzer ohne passendes Gerät entfernen?

Einschlussgruppen-ID

Nur Mitglieder dieser Gruppe können der Zielgruppe hinzugefügt werden.

Eigenschaft	Wert
Erforderlich	nein
Standardwert
Typ	Zeichenfolge
Anzeigename im Portal	Benutzer aus Gruppe einbeziehen
Im Portal ausgeblendet	ja (vorkonfiguriert über Runbook-Anpassung)

ExcludeGroupId

Mitglieder dieser Gruppe werden nie hinzugefügt und werden entfernt, falls vorhanden.

Eigenschaft	Wert
Erforderlich	nein
Standardwert
Typ	Zeichenfolge
Anzeigename im Portal	Benutzer aus Gruppe ausschließen
Im Portal ausgeblendet	ja (vorkonfiguriert über Runbook-Anpassung)

Nur-Bericht

Zeigt die Änderungen in der Vorschau an, ohne sie anzuwenden. Die Vorschau wird per E-Mail gesendet, mit den ersten 10 Benutzern pro Liste im Text und den vollständigen Listen als Anhang.

Eigenschaft	Wert
Erforderlich	nein
Standardwert	Falsch
Typ	Boolesch
Anzeigename im Portal	Nur-Bericht?

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)

BrandingFooterLink

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)

EmailTo

Adresse, an die die Vorschau gesendet wird. Nur im Nur-Bericht-Modus verwendet.

Eigenschaft	Wert
Erforderlich	nein
Standardwert
Typ	Zeichenfolge
Anzeigename im Portal	Vorschaubericht senden an

ReportFileFormat

Hängt die vollständigen Listen als CSV, als Excel-Arbeitsmappe oder beides an. Nur im Nur-Bericht-Modus verwendet.

Eigenschaft	Wert
Erforderlich	nein
Standardwert	CSV & XLSX
Typ	Zeichenfolge
Anzeigename im Portal	Dateiformat des Vorschauberichts

Portaloptionen

Portaloption	Wert
CSV & XLSX	CSV & XLSX
Nur CSV	Nur CSV
Nur XLSX	Nur XLSX

Zurück zur Runbook-Reference-Übersicht