Dieser Artikel wurde automatisch übersetzt. Die Übersetzung kann Ungenauigkeiten enthalten.
Zur englischen Originalversion wechseln.
Ctrlk
linkedinx-twitter
For the complete documentation index, see llms.txt. This page is also available as Markdown.

Erweiterte Einrichtung

Mit der erweiterten Einrichtung können Sie Berechtigungen feiner granuliert und individueller zuweisen. Dieser Ansatz ist flexibler, aber komplexer und erfordert die Ausführung des RealmJoin-PowerShell-Moduls.

Das RealmJoin PowerShell-Modul automatisiert die Einrichtung Ihres RealmJoin Tenant. Es:

  • Erstellt die erforderlichen Microsoft Entra ID Service Principals für die RealmJoin-Anwendungen

  • Weist die passenden Microsoft Graph-Berechtigungen basierend auf den von Ihnen ausgewählten Funktionen zu

  • Konfiguriert RealmJoin-Funktionen (Portal, Intune LAPS, Autopilot, Geräteaktionen, Remediationsskripte, Sicherheitsfunktionen)

  • Bereinigt veraltete Anwendungen aus vorherigen Konfigurationen

Das Modul wird veröffentlicht in der PowerShell Gallery.

Voraussetzungen

Die erforderlichen Azure PowerShell-Module (Az.Accounts, Az.Resources, Az.Automation) werden für den aktuellen Benutzer automatisch in den vom Modul festgelegten Versionen installiert, wenn Sie zum ersten Mal einen Befehl ausführen.

  • PowerShell 5.1 oder höher (Windows PowerShell oder PowerShell 7)

  • Ein Konto, das Service Principals erstellen und Anwendungsberechtigungen erteilen kann in Microsoft Entra ID — zum Beispiel Global Administrator oder Privileged Role Administrator

  • Die Anmeldung erfolgt über Connect-AzAccount, das die Azure PowerShell Erstanbieteranwendung verwendet. Tenants, die Benutzerzustimmung einschränken, benötigen möglicherweise zuerst einen Administrator, der dieser Anwendung die Administratorzustimmung erteilt.

  • Zugriff auf das PowerShell Gallery zur Installation des Moduls

Seit Version 2.0 meldet sich das Modul mit der Azure PowerShell Anwendung und den Az Module an. Frühere Versionen verwendeten stattdessen die Microsoft Graph PowerShell-Anwendung — wenn Ihr Tenant nur dafür Zustimmung erteilt hat, ist einmalig die Zustimmung für die Azure PowerShell-Anwendung erforderlich.

Empfohlene Einrichtung

Der im RealmJoin Portal angezeigte Einrichtungsbefehl gewährt Berechtigungen für:

  • Kernfunktionen

  • Intune LAPS

  • Anmeldedaten

  • Remediationsskripte

  • Autopilot

  • Intune-Geräteaktionen

Um alle oder einzelne Funktionen hinzuzufügen, siehe Weitere Befehle.

1

PowerShell unter Windows/Mac öffnen

Wir empfehlen, das RealmJoin PowerShell-Modul in einer neu geöffneten PowerShell-Sitzung auf Ihrem eigenen Gerät zu installieren und auszuführen statt in Azure Cloud Shell. Das Modul erfordert exakte Versionen der Az.* Module; wenn in der Sitzung bereits eine andere Version geladen ist — was in Cloud Shell typischerweise der Fall ist — beendet es sich mit einem Versionskonflikt, der ohne das Öffnen einer neuen Sitzung nicht behoben werden kann.

Eine erhöhte Sitzung („Als Administrator ausführen“) ist nicht erforderlich: Module werden mit -Scope CurrentUser.

2

Kopieren und Ausführen des RealmJoin Onboarding-Skripts

Das Skript fordert Sie auf, sich bei Azure anzumelden. Verwenden Sie ein Konto, das Service Principals erstellen und Anwendungsberechtigungen erteilen kann, zum Beispiel Ihren Global Administrator.

Info 6>&1: Diese Befehle schreiben ihre Fortschrittsaktualisierungen in den Informationsstrom von PowerShell. Die 6>&1 Umleitung zeigt diese Ausgabe in der Konsole an — ohne sie sehen Sie die ausführlichen Fortschrittsmeldungen während der Ausführung nicht.

3

Beginnen Sie mit der Verwendung von RealmJoin

Sobald dies abgeschlossen ist, startet das Skript das RealmJoin Portal

Abmelden danach: Die Azure-Anmeldung bleibt nach Abschluss des Befehls aktiv. Wenn Sie fertig sind, führen Sie Disconnect-AzAccount aus, um sich von der vorhandenen Sitzung abzumelden.

Weitere Befehle

Interaktive Einrichtung

Für eine geführte, menügesteuerte Erfahrung für die Tenant-Einrichtung, Konfigurationsänderungen, den Log Analytics Workspace und das Automation Account:

Um die verfügbaren Funktionen vor der Konfiguration zu überprüfen:

Benutzerdefinierte Konfiguration

Standardfunktionen

Aktiviert die erforderliche Kern-Portal-Funktionalität plus die standardmäßigen optionalen Funktionen (alles außer dem RealmJoin Client):

Minimale Funktionen (nur erforderliche Funktionen)

Vollständiger Funktionsumfang

Schreibgeschützte Berechtigungen

Weist, wo verfügbar, schreibgeschützte Berechtigungen zu (zum Beispiel, Group.ReadWrite.All wird zu Group.Read.All):

Benutzerdefinierte Funktionsauswahl

Vorhandene Konfiguration aktualisieren

Update-RJTenant passt einen bereits konfigurierten Tenant an. Der Alias Complete-RJTenantOnboarding kann austauschbar mit Update-RJTenant.

Neue Funktionen hinzufügen

Funktionen entfernen

Zu schreibgeschützten Berechtigungen wechseln

Änderungen in der Vorschau anzeigen

Azure-Ressourcen

Das Modul stellt außerdem die zugehörigen Azure-Ressourcen bereit, die RealmJoin verwendet. Diese sind keine Microsoft Graph-Berechtigungsfunktionen und werden nicht mit -Features:

Beide Befehle werden mit den passenden Parametern und einem Onboarding-Token auf der jeweiligen Einstellungsseite im RealmJoin Portal generiert.

Verfügbare Funktionen

Verwenden Sie diese Funktionsnamen mit den -Features, -AddFeaturesund -RemoveFeatures Parametern. Erforderliche Funktionen sind immer aktiviert. Die Standardkonfiguration (New-RJTenant ohne Parameter) aktiviert die unten markierten Funktionen; SecurityFeatures und Client müssen explizit ausgewählt werden.

Funktion
Beschreibung
Standard

RealmJoinPortal

Kern-Portal-Funktionalität für Self-Service durch Benutzer und Administratorinteraktion (erforderlich)

☑️

IntuneLAPS

Lokale Administratorkennwörter über Intune LAPS abrufen und verwalten

☑️

ShowSignin

Benutzer-Anmeldeverlauf und Überwachungsprotokolle anzeigen

☑️

Autopilot

Windows Autopilot-Bereitstellungsprofile und Status anzeigen

☑️

DeviceIntuneActions

Privilegierte Geräteaktionen ausführen (Synchronisieren, Neustarten, Zurücksetzen usw.)

☑️

DeviceHealthScript

PowerShell-Remediationsskripte auf Geräten verwalten und bereitstellen

☑️

BitLockerRecoveryKeys

BitLocker-Wiederherstellungsschlüssel für verwaltete Geräte anzeigen

☑️

WindowsDeviceUpdateEnrollment

Windows-Geräteupdate-Registrierung verwalten

☑️

SecurityFeatures

Erweiterter Bedrohungsschutz und Sicherheitsanalysen (erfordert MDE-Lizenzen)

Client

RealmJoin Agent — Clientanwendung für die Geräteverwaltung

Problembehandlung

"Unzureichende Berechtigungen" — das Erstellen von Service Principals und das Erteilen von Anwendungsberechtigungen erfordert ein entsprechend berechtigtes Konto, zum Beispiel Global Administrator oder Privileged Role Administrator. Siehe Voraussetzungen.

"Administratorfreigabe erforderlich" oder ein Zustimmungsfehler während der Anmeldung — die Anmeldung verwendet die Azure PowerShell Erstanbieteranwendung. Wenn Ihr Tenant die Benutzerzustimmung einschränkt, muss ein Administrator dieser Anwendung einmalig die Administratorzustimmung erteilen.

"RealmJoin-Modul ist veraltet - Ausführung kann nicht fortgesetzt werden" — jeder Befehl prüft einmal pro Sitzung, dass Sie die neueste veröffentlichte Version verwenden. Installieren Sie die aktuelle Version, schließen Sie dann die Sitzung und öffnen Sie eine neue:

Ein Modulversionskonflikt wird gemeldet — ein Az.* Modul in einer anderen Version als der, die das Modul festlegt, ist bereits geladen. Dies kann in der laufenden Sitzung nicht behoben werden: Schließen Sie PowerShell, öffnen Sie eine neue Sitzung und führen Sie den Befehl erneut aus.

Wenn das Modul nicht gefunden werden kann, bestätigen Sie, dass die PowerShell Gallery verfügbar ist, und installieren Sie es erneut:

Hilfe erhalten

Zuletzt aktualisiert

War das hilfreich?