Skip to main content
Dieses Library Item ist für Mac-Computer, iPhone, iPad, Apple TV und Apple Vision Pro verfügbar
Wenn Apple eine neue Konfiguration für Declarative Device Management (DDM) veröffentlicht, können Sie sie mit dem Custom Declarations Library Item anstelle eines dedizierten Library Items bereitstellen. Fügen Sie das Deklarations-JSON hinzu, wählen Sie aus, wo es installiert wird, und weisen Sie das Library Item mit einem Blueprint zu. Iru prüft das JSON anhand der Schemas von Apple, liefert es an Geräte aus und zeigt den Status jeder Deklaration an. Wenn Iru später ein dediziertes Library Item für dieselbe Konfiguration hinzufügt, verweist ein Befund vom Typ Empfehlung im Validierungsbereich darauf. Iru validiert die Struktur Ihrer Deklarationen. Es testet nicht, wie sich die Software von Apple verhält, wenn ein Gerät sie anwendet. Testen Sie jede Deklaration auf einem Pilotgerät, bevor Sie sie umfassend zuweisen.
Hintergrundinformationen zu Deklarationen finden Sie in der Dokumentation zu Declarative Device Management von Apple.

Custom Declarations Library Item erstellen

Halten Sie das Deklarations-JSON bereit, bevor Sie beginnen. Um stattdessen ein .mobileconfig-Profil bereitzustellen, verwenden Sie ein Custom Profile. Datei hochladen und Manuelle Eingabe sind Alternativen. Verwenden Sie eine der beiden Optionen, um das Deklarations-JSON hinzuzufügen, nicht beide.
1

Library öffnen

Gehen Sie zu Library.
2

Library Item hinzufügen

Wählen Sie Library Item hinzufügen und dann Custom Declarations.
3

Titel des Library Items festlegen

Geben Sie einen Titel für das Library Item ein.
4

Installieren auf auswählen

Wählen Sie unter Installieren auf die Plattformen aus, für die dieses Library Item gilt. Iru sendet jede Deklaration nur an die ausgewählten Plattformen, die ihren Typ unterstützen.
5

Assignment Maps zuweisen

Weisen Sie die Assignment Maps zu, die dieses Library Item erhalten sollen. Siehe Blueprints konfigurieren.
6

Option 1: Datei hochladen

Verwenden Sie diese Option, wenn Ihre Deklaration als .json-Datei gespeichert ist. Wählen Sie unter Einstellungen die Option Datei hochladen. Ziehen Sie die Datei auf die Seite oder wählen Sie Datei auswählen. Iru lädt die Datei in den Editor und prüft sie auf dieselbe Weise. Die Datei selbst wird nicht gespeichert. Siehe Deklarations-JSON.
Custom Declarations-Einstellungen mit ausgewählter Option Datei hochladen. Ziehen Sie ein Deklarations-JSON auf die Seite oder wählen Sie eine Datei aus.
7

Option 2: Manuelle Eingabe

Verwenden Sie diese Option, um das JSON selbst einzufügen. Wählen Sie unter Einstellungen die Option Manuelle Eingabe und fügen Sie das JSON dann in JSON eingeben ein. Validierung wird während der Eingabe aktualisiert. Siehe Deklarations-JSON.
Custom Declarations-Einstellungen mit ausgewählter Option Manuelle Eingabe. Links JSON eingeben und rechts die Validierung überprüfen.
8

Validierung überprüfen

Überprüfen Sie die Befunde unter Validierung und beheben Sie alles, was als Fehler markiert ist. Siehe Validierungsbefunde.
9

Speichern

Wählen Sie Speichern.

Einstellungen

Deklarations-JSON

Fügen Sie eine oder mehrere Apple-Konfigurationsdeklarationen ein oder laden Sie sie hoch. Jede Deklaration benötigt einen Type und einen Payload. Sie können eine einzelne Deklaration oder eine Liste hinzufügen. Dieses Beispiel ist eine Liste mit einer Deklaration für Safari-Lesezeichen:
  • Ein Library Item enthält 1 bis 100 Deklarationen mit insgesamt bis zu 128 KB.
  • Jede Deklaration erhält eine eigene Aktivierung, sodass ein Fehler die anderen nicht blockiert.
  • Iru akzeptiert Konfigurationsdeklarationen (com.apple.configuration.*). Aktivierungen oder Verwaltungsdeklarationen werden nicht akzeptiert.
  • Identifier ist optional. Wenn Sie ihn weglassen, weist Iru einen zu. Jeder Identifier muss innerhalb des Library Items eindeutig sein.
  • Wenn Sie ein ServerToken angeben, entfernt Iru es beim Speichern und berechnet ein eigenes.
  • Sie können globale Variablen wie $EMAIL oder $ASSET_TAG verwenden. Iru löst sie für jedes Gerät auf. Eine Variable ohne Wert wird zu leerem Text.

Kanal

Iru wählt den Geräte- oder Benutzerkanal für jede Deklaration anhand des Schemas von Apple aus. Nur Mac-Computer und Shared iPad verfügen über einen Benutzerkanal.

Validierungsbefunde

Iru prüft Ihre Deklarationen während der Bearbeitung, kurz nachdem Sie die Eingabe beenden, und erneut beim Speichern. Befunde werden unter Validierung angezeigt und sind der Zeile zugeordnet, die sie betreffen. Während eines Apple-Betazyklus zeigt der Bereich außerdem einen Beta-Tab an. Jeder Befund hat einen Schweregrad:
  • Fehler: Apple würde die Deklaration ablehnen. Beispielsweise hat ein Wert den falschen Typ oder ein erforderlicher Schlüssel fehlt.
  • Warnung: Die Deklaration funktioniert möglicherweise trotzdem, aber Iru kann dies nicht bestätigen. Beispielsweise ist ein Schlüssel oder Typ unbekannt oder wird nicht auf allen ausgewählten Plattformen unterstützt.
  • Info: Iru ändert etwas oder hält etwas zurück. Beispielsweise entfernt Iru ein ServerToken oder liefert ein Asset nicht aus.
  • Empfehlung: Iru verfügt über ein integriertes Library Item für diesen Deklarationstyp. Der Befund verweist darauf.
Befunde blockieren das Speichern nicht, da die Kopie der Apple-Schemas in Iru hinter neuen Versionen zurückliegen kann. Folgende Probleme blockieren das Speichern:
  • Ungültiges JSON
  • Eine Deklaration ohne Type oder Payload
  • Eine Deklarationsart, die Iru nicht unterstützt
  • Ein doppelter Identifier
  • Keine Plattform unter Installieren auf ausgewählt
  • Mehr als 100 Deklarationen oder mehr als 128 KB

Überlegungen

Sie können Asset-Deklarationen (com.apple.asset.*) speichern, aber Iru liefert sie nicht aus. Eine Konfiguration, die auf eines dieser Assets verweist, wird ebenfalls nicht ausgeliefert. Beide werden auf dem Gerät als Inkompatibel angezeigt. Unterstützung für DDM-Assets wird in einer zukünftigen Version hinzugefügt.
Custom Declarations stellt nur Deklarationen bereit. Um eine .mobileconfig-Datei bereitzustellen, verwenden Sie ein Custom Profile.
Wenn ein Gerät eine Deklaration nicht übernehmen kann, sendet Iru sie nicht und markiert sie mit einer Begründung als Inkompatibel. Zu den Gründen gehören ein nicht unterstütztes Betriebssystem oder eine nicht unterstützte Plattform, ein Asset sowie ein Typ, den Apple auf Shared iPad nicht zulässt. Iru liefert die Deklaration aus, sobald das Gerät sie übernehmen kann.
Öffnen Sie den Status eines Geräts, um jede Deklaration nach ihrem Identifier aufgelistet zu sehen. Der Gesamtstatus des Library Items folgt einer Regel: Wenn eine Deklaration einen Fehler aufweist, zeigt das Item Fehler an. Andernfalls zeigt das Item Ausstehend an, wenn eine Deklaration Ausstehend ist. Andernfalls zeigt es Bestanden an. Wenn eine Deklaration fehlschlägt, zeigt Iru den Fehlertext von Apple an.
Eine Deklaration, die Apple akzeptiert, aber als inaktiv markiert, wird mit den Gründen von Apple als Ausstehend angezeigt. Wenn der Grund ein Error.*-Code ist, wird die Deklaration als Fehler angezeigt.
Wenn Sie eine Deklaration bearbeiten, sendet Iru nur diese Deklaration erneut. Das Neuanordnen oder Bearbeiten anderer Einträge ändert die übrigen nicht.
Während der Automated Device Enrollment wartet der Setup Assistant, bis alle Deklarationen aktiv sind oder eine davon fehlschlägt. Auf Deklarationen mit dem Status Inkompatibel wartet er nicht. Geräte, deren Betriebssystem Declarative Device Management nicht ausführen kann, erhalten das Library Item stattdessen über MDM.
Das Entfernen einer Deklaration oder das Aufheben der Zuweisung des Library Items entfernt sie von den Geräten. Iru fordert Sie zur Bestätigung auf. Bei sehr großen Tenants erfolgt das Entfernen in Batches, sodass es auf den Geräten mehrere Minuten dauern kann.
Iru prüft, dass jeder Identifier innerhalb eines Library Items eindeutig ist. Denselben Identifier in einem anderen Library Item erkennt Iru nicht. Verwenden Sie unterschiedliche Identifier in verschiedenen Library Items.

Best Practices

1

Auf einem Pilotgerät testen

Iru prüft die Struktur, nicht das Verhalten der Software von Apple. Testen Sie jede Deklaration auf einem Pilotgerät, bevor Sie sie umfassend zuweisen.
2

Integriertes Library Item verwenden

Wenn ein Befund vom Typ Empfehlung auf ein integriertes Library Item für dieselbe Konfiguration verweist, verwenden Sie dieses Library Item.
3

Eindeutige Identifier verwenden

Iru kennzeichnet den Status nach Identifier. Aussagekräftige Namen beschleunigen die Fehlerbehebung.
4

Zusammengehörige Deklarationen gruppieren

Fassen Sie zusammengehörige Deklarationen in einem Library Item zusammen, bis zu 100.
5

Fehler-Befunde vor dem Zuweisen beheben

Befunde blockieren das Speichern nicht, aber ein Fehler bedeutet in der Regel, dass ein Gerät die Deklaration ablehnt.
6

Status nach dem Zuweisen prüfen

Öffnen Sie den Gerätestatus und vergewissern Sie sich, dass jede Deklaration Bestanden anzeigt.

Fehlerbehebung

Iru hat die Deklaration nicht gesendet. Öffnen Sie den Gerätestatus und lesen Sie die Begründung.Mögliche Ursachen:
  • Das Betriebssystem oder die Plattform des Geräts unterstützt den Deklarationstyp nicht.
  • Die Deklaration ist ein Asset, oder eine Konfiguration verweist auf ein Asset.
  • Der Typ ist auf Shared iPad nicht zulässig.
Lösungen:
  • Aktualisieren Sie das Gerät auf ein unterstütztes Betriebssystem oder entfernen Sie die Deklaration aus dem Library Item.
  • Entfernen Sie Verweise auf Assets.
Mögliche Ursachen:
  • Das Gerät hat sich noch nicht gemeldet oder noch keinen Status übermittelt.
  • Apple hat die Deklaration akzeptiert und als inaktiv markiert.
Lösungen:
  • Vergewissern Sie sich, dass das Gerät online ist und sich gemeldet hat.
  • Öffnen Sie den Gerätestatus und lesen Sie die Gründe von Apple für die Deklaration.
Mögliche Ursachen:
  • Eine Deklaration enthält einen falschen Wert, einen fehlenden Schlüssel oder einen Wert außerhalb des von Apple zulässigen Bereichs.
  • Apple hat einen Error.*-Grund gemeldet.
Lösungen:
  • Öffnen Sie den Gerätestatus, suchen Sie die Deklaration anhand des Identifier und lesen Sie den Fehlertext von Apple.
  • Korrigieren Sie die Deklaration und speichern Sie. Iru sendet nur das Geänderte erneut.
Mögliche Ursachen:
  • Das JSON ist ungültig.
  • Eine Deklaration hat keinen Type oder Payload.
  • Zwei Deklarationen verwenden denselben Identifier.
  • Unter Installieren auf ist keine Plattform ausgewählt.
  • Das Library Item enthält mehr als 100 Deklarationen oder ist größer als 128 KB.
  • Der Text ist größer als 2 MB.
Lösungen:
  • Lesen Sie die Meldung unter Validierung und korrigieren Sie die Zeile, auf die sie verweist.
  • Wenn der Text größer als 2 MB ist, reduzieren Sie ihn unter das Limit. Iru lehnt ihn sofort ab und zeigt seine Größe an.
Mögliche Ursachen:
  • Die Validierungsprüfung wurde nicht abgeschlossen.
Lösungen:
  • Warten Sie einen Moment und bearbeiten Sie das JSON erneut, um die Prüfung auszuführen.
  • Wenn die Deklarationen gültig sind, können Sie trotzdem speichern.
Mögliche Ursachen:
  • Die Datei ist ein .mobileconfig-Profil und kein Deklarations-JSON.
Lösungen:

Library-Übersicht

Library Items kuratieren, erstellen und verwalten und zu Blueprints hinzufügen

Übersicht über Custom Profiles

Ein .mobileconfig-Profil bereitstellen, wenn eine Deklaration nicht der richtige Payload ist

Blueprints konfigurieren

Library Items mit einem Blueprint Geräten zuweisen

Globale Variablen

Werte des Geräts und des zugewiesenen Benutzers in eine Deklaration einfügen