Sie sind bereits NinjaOne-Kunde? Melden Sie sich an, um weitere Leitfäden und die neuesten Updates zu sehen.

Benutzerdefiniertes Skript: Agentenverteilung des NinjaOne-Agenten über eine sofort ausgeführte geplante Aufgabe in der Gruppenrichtlinie (GPO)

Thema

In diesem Artikel wird erläutert, wie und in welchen Szenarien das Automatisierungsskript „NinjaOne Agent Deployment by AD Immediate Scheduled Task GPO“ aus der NinjaOne-Automatisierungsbibliothek verwendet wird.

Umgebung

  • NinjaOne Endpunkt-Management
  • Microsoft Windows

Beschreibung

NinjaOne bietet eine Funktion zur AD Erkennung und Verteilung, die die Agentenverteilung in AD-domänengesteuerten Umgebungen vereinfacht. Weitere Informationen zu dieser Option finden Sie unter „NinjaOne Endpoint Management: Active Directory Erkennung und Verteilung “.

Alternativ können Sie ein domänenbasiertes Modell zur Agentenverteilung verwenden, das auf einem sofort ausgeführten, geplanten Task-Gruppenrichtlinienobjekt (GPO) basiert. Die Verwendung dieses Modells ist möglicherweise sinnvoller, wenn mindestens eines der folgenden Szenarien zutrifft:

  • Sie müssen den Agenten auf Remote-Laptops und ähnlichen Geräten bereitstellen, die über ein virtuelles privates Netzwerk (VPN) mit dem Netzwerk verbunden sind.
  • Sie verfügen über eine größere Domäne mit einer großen Anzahl von Organisationseinheiten (OUs), die Ihre Computerobjekte enthalten, oder Sie müssen die Verteilung gleichzeitig in mehreren OUs durchführen.
  • Sie möchten den Agenten auf Ihren Computerobjekten basierend auf der Mitgliedschaft in Sicherheitsgruppen statt anhand der Organisationseinheit bereitstellen.
  • Sie möchten Computerobjekte in verschiedenen OUs oder Sicherheitsgruppen an unterschiedlichen Standorten innerhalb von NinjaOne registrieren.
  • Sie müssen den Agenten häufiger als einmal täglich, wöchentlich oder monatlich auf Computerobjekte übertragen.
  • Ihre Computerobjekte werden über einen Proxy ins Internet weitergeleitet.
  • Sie können NinjaOne aus Sicherheitsgründen nicht in Ihren Domain-Controller (DC) integrieren.
  • Sie haben keinen direkten Zugriff auf den DC und verwalten die Domain stattdessen über die Remote-Server-Verwaltungstools (RSAT).
  • Sie müssen die Verteilung gleichzeitig auf Servern und Arbeitsstationen durchführen.
  • Sie müssen die Bereitstellung auf Computerobjekte in verschiedenen Netzwerksegmenten durchführen, unabhängig davon, in welchem Segment sich der DC befindet.

Um ein domänenbasiertes Modell für die Agentenverteilung mit GPO zu verwenden, greifen Sie auf das Automatisierungsskript in der NinjaOne-Vorlagenbibliothek zu, das den Namen „NinjaOne Agent Deployment by AD Immediate Scheduled Task GPO“ trägt. Informationen zu den Navigationsschritten finden Sie unter „Automatisierungsbibliothek: Skriptvorlagen “.

Index

Auswählen Sie ein Thema, um mehr zu erfahren:

Weitere Funktionen und Vorteile

Zusätzlich zu den im Abschnitt „Beschreibung“ dieses Artikels beschriebenen Anwendungsfällen bietet dieses Skript die folgenden Funktionen und Vorteile:

  • Die durch die Automatisierung generierte GPO ist eine sofort geplante Aufgabe. Die Aufgabe wird sofort bei der nächsten automatischen oder manuellen Aktualisierung der Gruppenrichtlinie angewendet, sodass Sie Ihre Endgeräte nicht neu starten müssen, um den NinjaOne-Agenten bereitzustellen. Die Aufgabe wird danach bei jeder automatischen oder manuellen Aktualisierung der Gruppenrichtlinie kontinuierlich erneut angewendet, bis der Agent erfolgreich bereitgestellt wurde. Die Aufgabe gilt auch für Remote-Geräte wie Laptops, sobald diese eine Verbindung zum Netzwerk herstellen – sei es über ein VPN oder auf andere Weise – und anschließend zum Domänencontroller, ohne dass ein „Immer aktives VPN“ erforderlich ist.
  • Der Prozess lädt automatisch das generische Agent-Installationsprogramm von der NinjaOne-Plattform herunter, auf der der Endpunkt, auf dem es ausgeführt wird, registriert ist, und überprüft die digitale Signatur.
  • Diese Automatisierung ist vollständig kompatibel mit Microsoft Entra Domain Services-Umgebungen, und es ist nicht erforderlich, einen Verwaltungsserver dauerhaft online zu halten. Alle vom Gruppenrichtlinienobjekt (GPO) benötigten Dateien werden im Gruppenrichtlinienspeicher abgelegt.
  • Beachten Sie, dass dieses Skript nicht mit Microsoft Entra ID oder Microsoft Intune kompatibel ist. Anweisungen zur Verteilung über Intune finden Sie unter „NinjaOne-Agent-Installation: Verteilung über Microsoft Intune“.
  • Gegebenenfalls übergibt NinjaOne das Proxy-Passwort über ein sicheres benutzerdefiniertes Feld an die Automatisierung und speichert es ausschließlich in verschlüsselter Form sowie nur innerhalb der unmittelbar geplanten Aufgabe auf dem DC. Die GPO übergibt das verschlüsselte Passwort als PowerShell-Skriptargument an den Endpunkt, sodass es niemals auf dem Endpunkt und nirgendwo im Klartext gespeichert wird.
  • Das nach dem GPO-Aufruf ausgeführte Skript weist folgende Eigenschaften auf:
    • Es erkennt, ob der NinjaOne-Agent-Dienst auf dem Endpunkt installiert ist, und versucht nur dann, den Agenten zu installieren, wenn der Dienst nicht gefunden wird. Das Skript erkennt und entfernt alle Überreste früherer fehlgeschlagener Installationen oder Deinstallationen, um die Wahrscheinlichkeit einer erfolgreichen Verteilung zu maximieren.
    • Es überprüft den Header der aktuellen Installation eines Agenten von NinjaOne (es wird nur der Header heruntergeladen, nicht die gesamte Datei), um festzustellen, ob ein Update verfügbar ist, und lädt dieses gegebenenfalls herunter und überprüft es. Dadurch wird sichergestellt, dass Ihre Endgeräte keinen veralteten Agenten installieren, der sich anschließend sofort selbst aktualisieren würde.
    • Optional kann es Ereignisse in das Windows-Ereignisprotokoll schreiben, um die Fehlerbehebung und Diagnose fehlgeschlagener Verteilungen zu vereinfachen.
  • Als Sicherheitsmaßnahme speichert das Skript für Automatisierungen die Verweise auf Organisationseinheiten (OUs) oder Sicherheitsgruppen, die zur Ermittlung der Standort-Token-ID verwendet werden, als global eindeutige Identifikatoren (GUIDs) und nicht als Namen im Klartext.

Voraussetzungen, benutzerdefinierte Felder und Werte der Skript-Variablen

Die NinjaOne-Automatisierung „Agentenverteilung über AD – sofortige geplante Aufgabe (GPO) “ setzt voraus, dass Sie die Agententokenisierung aktiviert haben, da sie die Token-IDs verwendet, um den Standort zu ermitteln, bei dem sich die Endpunkte registrieren. Weitere Informationen zur Agententokenisierung finden Sie unter NinjaOne-Plattform: Agententokenisierung.

Je nach Ihren Zugriffsrechten innerhalb der Domäne können Sie dieses Skript für die Automatisierung auf jedem Domänencontroller oder auf jedem domänenzugehörigen Computer ausführen, auf dem die optionalen Windows-Funktionen „RSAT Active Directory“ und „RSAT Group Policy“ installiert und aktiviert sind.

Falls Ihre Domänenkonfiguration verhindert, dass das lokale DC-Systemkonto Änderungen auf Domänenebene vornimmt, führen Sie die Automatisierung mit Anmeldeinformationen durch, die über die entsprechenden Berechtigungen verfügen. Zu diesen Änderungen gehören das Erstellen und Importieren von GPOs, das Lesen von AD-Objekten sowie das Lesen aus und Schreiben in die Freigabe „System Volume“ (SYSVOL). Weitere Informationen zur Verwendung von Anmeldeinformationen in NinjaOne finden Sie unter „NinjaOne Endpoint Management: Credential Exchange“.

Wenn Sie auf benutzerdefinierte Felder zugreifen oder diese bearbeiten möchten, müssen Sie die Automatisierung mit Anmeldeinformationen ausführen, deren Berechtigungen dafür erweitert werden können.

Das Skript, das auf den Endpunkten ausgeführt wird, läuft unter dem lokalen Systemkonto des Endpunkts. Es besteht kein Risiko für Domänenadministratoren oder andere Anmeldeinformationen. Es dürfen keine GPO aus einem AD-Erkennung- und Verteilungsauftrag oder andere GPO vorhanden sein, die die Zeichenfolge „NinjaOne“ enthalten. Wenn das Skript solche GPO erkennt, bricht es sofort ab.

Das Automatisierungsskript schreibt die benötigten Dateien in den Ordner {[Ihre GPO-GUID]} innerhalb des Ordners „Policies“ der SYSVOL-Freigabe. Diese Freigabe wird automatisch auf alle anderen Domänencontroller repliziert, ohne dass zusätzliche Windows-Funktionen wie die DFS-Replikation (Distributed File System) erforderlich sind. Daher ist es bei Domänen mit mehreren Domänencontrollern beliebig, auf welchem Domänencontroller Sie das Skript ausführen.

Für die Automatisierung verwendete benutzerdefinierte Felder

Das Automatisierungsskript kann einige oder alle der folgenden benutzerdefinierten Felder verwenden. Diese benutzerdefinierten Felder sind je nach Ihren Anforderungen optional.

NameTypUmfangBerechtigungenBeschreibung
NinjaOne-Standort-Token-IDTextOrganisation, StandortZugriff für Techniker: Bearbeitbare Automatisierungen: SchreibgeschütztDieses Feld enthält die Standort-Token-ID für den Standort, bei dem sich die Geräte registrieren, sofern diese nicht durch die Skriptvariable festgelegt wurde. Weitere Informationen zum Abrufen der Standort-Token-ID finden Sie im Abschnitt „So rufen Sie die Standort-Token-ID ab“ dieses Artikels.
NinjaOne-GPO-Liste der ZieleWYSIWYGGerätTechnikerzugriff: Bearbeitbare Automatisierungen: Lesen/SchreibenWenn der Zielbereich auf „OUs“ oder „Sicherheitsgruppen“ eingestellt ist, enthält dieses Feld die Liste der zu konfigurierenden oder als Ziel zu verwendenden OUs oder Sicherheitsgruppen zusammen mit den jeweiligen Standort-Token-IDs. NinjaOne verwendet dieses Feld bei keinem anderen Zielbereich.
NinjaOne GPO-HostnamenlisteWYSIWYGGerätTechnikerzugriff: Bearbeitbare Automatisierungen: Nur schreibenWenn der Zielbereich auf Organisationseinheiten (OUs) oder Sicherheitsgruppen eingestellt ist, enthält dieses Feld die Liste der Hostnamen von Computerobjekten innerhalb der Ziele. NinjaOne verwendet dieses Feld nicht für andere Zielbereiche.
Proxy-PasswortPasswordOrganisation, StandortTechnikerzugriff: Bearbeitbare Automatisierungen: SchreibgeschütztFür die Proxy-Verbindung enthält dieses Feld gegebenenfalls das Passwort für die Anmeldeinformationen.

Bei groß angelegten Verteilungen kann es sinnvoll sein, das benutzerdefinierte Feld „NinjaOne-Standort-Token-ID“ in großem Umfang mithilfe einer CSV-Importdatei (Comma-Separated Values) zu füllen. Eine Anleitung dazu finden Sie in unserem Skript-Share: Daten aus einer Tabelle in benutzerdefinierte Felder importieren (API) (Dojo-Community-Seite).

Für die Automatisierung verwendete Skript-Variablen

Das Automatisierungsskript verwendet die folgenden Skript-Variablen:

NameTypBeschreibung
GPO-NameTextDiese Variable ist der Name des GPO. Es kann sich um eine beliebige eindeutige Kennung handeln, die mit beliebigen Namenskonventionen übereinstimmt, muss jedoch die Zeichenfolge „NinjaOne“ enthalten.
ZielbereichDropdownDiese Variable steuert die Zielauswahl für das GPO durch Verknüpfungen und gegebenenfalls durch Filterung nach Sicherheitsgruppen. Zur Auswahl stehen „Keine“ (für die Zielauswahl auf Elementebene), „Domänenstamm“, „Organisationseinheiten“ oder „Sicherheitsgruppen“. Bei der Zielauswahl nach Organisationseinheiten und Sicherheitsgruppen wird das Überschreiben der Token-ID des Registrierungsorts unterstützt.
Ereignisprotokoll aktivierenKontrollkästchenWenn diese Option ausgewählt ist, sorgt diese Variable dafür, dass das GPO-Skript während der Ausführung Windows-Ereignisse in das Anwendungsereignisprotokoll unter der Quelle „NinjaOneGPODeployment“ schreibt. Diese Option ist nützlich zur Diagnose von Verteilungsproblemen auf Remote-Endpunkten in großem Maßstab (beispielsweise mit einem Windows-Ereignissammler) oder einzeln auf Endpunkt-Ebene.
Liste der Computer ausgebenKontrollkästchenWenn diese Option ausgewählt ist, gibt diese Variable bei der Ausrichtung auf Organisationseinheiten (OUs) oder Sicherheitsgruppen die Liste der Hostnamen der Computerobjekte in jeder betroffenen Organisationseinheit oder Sicherheitsgruppe in das benutzerdefinierte Feld „NinjaOne GPO-Hostnamenliste“ aus.
Zielliste neu erstellenKontrollkästchenWenn diese Option ausgewählt ist, füllt diese Variable das benutzerdefinierte Feld „NinjaOne GPO-Zielliste“ neu, wenn Organisationseinheiten oder Sicherheitsgruppen als Ziel ausgewählt werden. Verwenden Sie diese Option, um Abweichungen in der Zielliste zu beheben, die durch Änderungen an Ihrer AD-Architektur verursacht wurden.
GPO entfernenKontrollkästchenWenn diese Option ausgewählt ist, werden das GPO sowie die zugehörigen Dateien und Ordner vom DC entfernt. Sie müssen den Zielbereich auf „Kein(e)“ setzen und die Optionen „Zielliste neu erstellen“ und „Computerliste ausgeben“ deaktiviert lassen.
Token-IDTextFügen Sie die Standort-Token-ID in diese Variable ein, wenn Sie hierfür nicht das benutzerdefinierte Feld „NinjaOne-Standort-Token-ID“ verwenden. Details dazu, wie Sie die Standort-Token-ID abrufen können, finden Sie im Abschnitt „So rufen Sie die Standort-Token-ID ab“ dieses Artikels.
Proxy-AutodiscoveryKontrollkästchenWenn diese Option ausgewählt ist, wird diese Variable durch die automatische Proxy-Erkennung verwendet (sofern sich das System hinter einem Proxy befindet).
Proxy-HostIP-AdresseDies ist der Hostname des Proxys und ist obligatorisch, wenn ein Proxy ohne automatische Erkennung verwendet wird.
Proxy-PortGanze ZahlDies ist die Proxy-Portnummer und ist obligatorisch, wenn ein Proxy ohne automatische Erkennung verwendet wird.
Proxy-BenutzernameTextDies ist der Proxy-Benutzername, falls erforderlich.
Proxy-PasswortKontrollkästchenWenn diese Option ausgewählt ist, gibt diese Variable an, dass für den Proxy-Benutzernamen ein Passwort erforderlich ist. Das Skript ruft das Passwort aus dem gesicherten Benutzerdefinierten Feld „Proxy-Passwort“ ab.

Ablauf des Automatisierungsskripts

In diesem Abschnitt werden die Workflow-Phasen des Automatisierungsskript-Prozesses beschrieben.

Phase 1: Vorbereitungen

Das Skript beginnt mit der Validierung aller Voraussetzungen und bricht sofort ab, wenn eine davon nicht erfüllt ist.

Beispiele hierfür sind unter anderem:

  • Validierung der Skript-Variablen
  • Sicherstellen, dass der Endpunkt der Domain angehört und entweder ein Domänencontroller oder ein anderer Computer ist, auf dem RSAT für AD und GPO installiert und aktiv ist
  • Sicherstellen, dass das Konto, unter dem das Skript ausgeführt wird, aktiv ist und Schreibzugriff auf SYSVOL hat

Anschließend ruft das Skript die Liste aller Computerobjekte ab und ermittelt alle Organisationseinheiten (OUs) und Sicherheitsgruppen, die diese enthalten, wodurch diejenigen herausgefiltert werden, die ausschließlich Benutzerobjekte enthalten. Danach ermittelt das Skript die ID des Standort-Tokens entweder aus der Skriptvariablen oder aus dem benutzerdefinierten Feld.

Phase 2: Konfiguration der Zielbereichsauswahl

Die nächste Phase hängt vom Zielbereich ab. Bei Organisationseinheiten und Sicherheitsgruppen füllt das Skript – sofern Sie das Skript zum ersten Mal ausführen oder die Option „Zielliste neu erstellen“ wählen – das benutzerdefinierte Feld „NinjaOne GPO-Zielliste“ mit der Liste der Namen der Organisationseinheiten oder Sicherheitsgruppen zusammen mit der angegebenen Standort-Token-ID und wird anschließend beendet. Das Skript gibt die kanonischen Namen der Organisationseinheiten anstelle ihrer Distinguished Names zurück, damit diese leichter verständlich sind.

An dieser Stelle können Sie den Umfang der Bereitstellung bearbeiten und optional festlegen, an welchen Standorten Sie die Computerobjekte in den einzelnen Organisationseinheiten oder Sicherheitsgruppen registrieren möchten. Anweisungen hierzu finden Sie im Abschnitt dieses Artikels mit dem Titel „So bearbeiten Sie das benutzerdefinierte Feld ‚NinjaOne GPO-Zielliste‘“.

GPO target list_OU.png
Abbildung 1: GPO-Liste der Ziele: Organisationseinheiten (zum Vergrößern anklicken)
GPO target list_security groups.png
Abbildung 2: GPO-Liste der Ziele: Sicherheitsgruppen (zum Vergrößern anklicken)

Schritt 3: Encryption des Proxy-Passworts

Wenn Sie Proxy-Details konfiguriert haben, die ein Passwort enthalten, liest das Skript das sichere Benutzerdefinierte Feld aus und verschlüsselt die Zeichenfolge auf dieselbe Weise wie bei einer lokalen Verschlüsselung.

NinjaOne speichert das verschlüsselte Passwort in der Konfiguration des unmittelbar geplanten Skripts und übergibt es als Argument an das Skript. NinjaOne speichert das Passwort niemals auf dem Endpunkt und niemals irgendwo im Klartext.

Phase 4: Erstellen des Haupt-GPO und der zugehörigen Dateien

Das Automatisierungsskript führt in Phase vier die folgenden Aktionen durch:

  1. Das Automatisierungsskript löscht alle bereits vorhandenen Bereitstellungs-GPOs mit demselben Namen, um alle bestehenden Verknüpfungen zu entfernen.
  2. Das Skript erstellt ein neues GPO und personalisiert die im Automatisierungsskript enthaltene Vorlage für die Domäne und den Domänencontroller, auf denen es ausgeführt wird.
  3. Das Skript importiert den personalisierten GPO-Inhalt in das neu erstellte GPO. Das Skript richtet das GPO entsprechend aus und verknüpft es, entweder an der Domänenwurzel, auf OU-Ebene, an der Domänenwurzel mit Sicherheitsgruppenfilterung der unmittelbar geplanten Aufgabe oder gar nicht.
Example GPO with OU-level targeting.png
Abbildung 3: Beispiel-GPO mit Zuordnung auf OU-Ebene (zum Vergrößern anklicken)
Example GPO with security group filtering.png
Abbildung 4: Beispiel-GPO mit Sicherheitsgruppenfilterung (zum Vergrößern anklicken)
  1. Nachdem das fertige GPO eingerichtet und gegebenenfalls verknüpft und gefiltert wurde, generiert das Automatisierungsskript das Skript, das das GPO bei der Richtlinienaktualisierung auslöst und das entsprechend der Domäne und dem Domänencontroller angepasst ist. Das Skript wird automatisch nach Bedarf personalisiert, einschließlich Windows-Ereignisprotokollierung, Zuordnung auf OU- oder Sicherheitsgruppenebene, Prüfungen auf Agent-Updates und anderer Spezifikationen.

Das Skript wird automatisch im GPO-Ordner gespeichert.

  1. Für die Zielauswahl nach Organisationseinheiten und Sicherheitsgruppen schreibt das Skript eine CSV-Nachschlage-Datei mit den Ziel-GUIDs und den entsprechenden NinjaOne-Standort-GUIDs in den GPO-Ordner. Wenn Sie „Computerliste ausgeben“ ausgewählt haben, schreibt das Skript außerdem die Liste der Ziel-Organisationseinheiten und Sicherheitsgruppen im Geltungsbereich sowie deren jeweilige Computerobjekte in das Benutzerdefinierte Feld „NinjaOne GPO-Hostnamenliste “.
Example hostname list with OU-level targeting.png
Abbildung 5: Beispiel für eine Hostnamenliste mit Zielauswahl auf OU-Ebene (zum Vergrößern anklicken)
  1. Das Automatisierungsskript lädt das Agent-Installationsprogramm in den GPO-Ordner herunter und überprüft die digitale Signatur, bevor es eine abschließende Ergebnismeldung ausgibt.

Phase 5: Ausführung des GPO-Skripts

Wenn die automatische oder manuelle Aktualisierung der Gruppenrichtlinie das Skript aktiviert, prüft das Skript zunächst, ob der NinjaOne-Agent-Dienst existiert, und beendet sich gegebenenfalls sofort.

Existiert der NinjaOne-Agent-Dienst nicht, entfernt das Skript anschließend alle möglichen Rückstände früherer fehlgeschlagener Installations- oder Deinstallationsversuche, um die Wahrscheinlichkeit einer erfolgreichen Installation zu maximieren.

Der nächste Schritt hängt von der Umfang Konfiguration des Zielbereichs ab:

  • Für die OU-Zielauswahl ruft das Skript die GUID der Organisationseinheit (OU) des Endpunkts ab und vergleicht sie mit den Einträgen in der CSV-Abfrage. Dieser Vergleich ermittelt die NinjaOne-Standort-Token-ID.
  • Bei der Zielauswahl nach Sicherheitsgruppen ruft das Skript die GUIDs der Sicherheitsgruppen ab, denen der Endpunkt angehört, und vergleicht sie mit denen in der CSV-Abfrage. Durch diesen Vergleich wird die NinjaOne-Standort-Token-ID ermittelt.
  • Für die Ausrichtung auf die Domänenwurzel oder ohne Ausrichtung ist die von der Skriptvariablen oder dem Benutzerdefinierten Feld bereitgestellte Standort-Token-ID bereits fest codiert.

Die nächste Aktion, die das GPO-Skript ausführt, hängt von der Plattform ab, auf der die Automatisierung ausgeführt wurde. Je nach Fall kopiert das GPO-Skript entweder das Agent-Installationsprogramm vom Domänencontroller oder es überprüft anhand des Header-Datums das Datum des derzeit bei NinjaOne verfügbaren Agent-Installationsprogramms. Wenn das Datum des bei NinjaOne verfügbaren Agent-Installationsprogramms mit dem Datum des Programms auf dem Domänencontroller übereinstimmt, kopiert das Skript das Agent-Installationsprogramm vom Domänencontroller. Ist das Datum der bei NinjaOne verfügbaren Installationsdatei jedoch jünger als das Datum auf dem Domain-Controller, lädt das Skript das neuere Agent-Installationsprogramm herunter und überprüft dessen digitale Signatur. Scheitert der Download oder die Überprüfung der digitalen Signatur, greift das Skript auf das Kopieren der Installationsdatei vom Domain-Controller zurück; bei Erfolg verwendet das Skript die neuere Datei.

Anschließend installiert das Skript den Agenten, richtet das Gerät so ein, dass es sich an dem durch die Standort-Token-ID festgelegten Standort registriert, und löscht die lokale Kopie.

Falls Sie eine Proxy-Konfiguration angegeben haben, richtet das Skript diese bei der Installation des Agenten ein. Enthält die Proxy-Konfiguration ein Passwort, wird dieses als verschlüsselte Zeichenfolge als Skriptargument übergeben, sodass es niemals auf dem Endpunkt gespeichert wird.

Abschließend wartet das Skript auf die Bestätigung der erfolgreichen Registrierung bei der NinjaOne-Plattform; dieser Vorgang kann fehlschlagen, wenn die Standort-Token-ID ungültig ist. Nach Bestätigung des Registrierungsstatus wird das Skript beendet.

Wenn Sie „Ereignisprotokollierung aktivieren“ ausgewählt haben, schreibt das Skript während des gesamten Prozesses Ereignisse mit der Quelle „NinjaOneGPODeployment“ in das Ereignisprotokoll der Anwendung. Beachten Sie in der folgenden Abbildung 6 die Quelle „NinjaOneGPODeployment“ im Ereignisprotokoll der Anwendung:

Example Event Viewer on deployed endpoint, note the NinjaOneGPODeployment source in the Application log.png
Abbildung 6: Beispiel für die Ereignisanzeige auf einem bereitgestellten Endpunkt (zum Vergrößern anklicken)
Devices in different OUs successfully registered to their correct locations.png
Abbildung 7: Beispiel für Geräte in verschiedenen Organisationseinheiten, die erfolgreich an ihren korrekten Standorten eingetragen wurden

So bearbeiten Sie das benutzerdefinierte Feld „NinjaOne GPO-Zielliste“

Sie können das benutzerdefinierte Feld „NinjaOne GPO-Zielliste“ nach dem ersten Ausführen des Skripts, nach dem Neuerstellen der Zielliste oder zu jedem anderen Zeitpunkt danach bearbeiten.

Um eine Organisationseinheit (OU) oder eine Sicherheitsgruppe aus dem Geltungsbereich zu entfernen, löschen Sie die Zeile mit der Option „Zeile löschen“ im Aktionsmenü. Ein anschauliches Beispiel finden Sie in Abbildung 8.

Löschen Sie nicht nur den Inhalt der Zeile; Sie müssen die gesamte Zeile löschen, damit keine leeren Zellen übrig bleiben. Löschen Sie weder die Header-Zeile noch die letzte Zeile. Wenn Sie eine dieser Aktionen ausführen, schlägt die Automatisierung fehl.
GPO target list.png
Abbildung 8: Eine Zeile aus der GPO-Zielliste löschen (zum Vergrößern anklicken)

Sie müssen mindestens eine Änderung an der ursprünglichen Zielliste vornehmen, wenn Sie OUs als Ziel festlegen – entweder durch Löschen einer oder mehrerer Zeilen aus dem Geltungsbereich oder durch Ändern einer oder mehrerer Standort-Token-IDs.

Das Ausführen der Automatisierung bei der Auswahl aller OUs mit derselben Standort-Token-ID führt zum gleichen Ergebnis wie die Auswahl der Domänenwurzel; in diesem Szenario ist die Automatisierung daher fehlgeschlagen.

Beachten Sie, dass dies ein anderes Szenario ist als die Auswahl jeder Sicherheitsgruppe ohne Änderung der Standort-Token-ID, da es Fälle geben kann, in denen nicht jedes Computerobjekt Mitglied einer Gruppe ist.

Für jede Organisationseinheit oder Sicherheitsgruppe, bei der Sie den Zielstandort ändern möchten, benötigen Sie die entsprechende Standort-Token-ID.

So ermitteln Sie die Standort-Token-ID

Um Ihre Standort-Token-ID in NinjaOne zu ermitteln, führen Sie die folgenden Schritte aus:

  1. Navigieren Sie zum NinjaOne-System-Dashboard und öffnen Sie die Registerkarte „Geräte “. Wählen Sie „Agent-Installationsprogramme“ aus.
  2. Kopieren Sie die Token-ID für den gewünschten Standort aus der Spalte „Token“ und fügen Sie sie in die Spalten „Token-ID“ der entsprechenden Zeile in der Zielliste ein. Die von Ihnen gewählte Token-ID muss eine Windows-basierte Gerätefunktion unterstützen, da die Endpunkte sonst nicht auf der Plattform registriert werden können.
dashboard_agent installers_token.png
Abbildung 9: Abrufen der Token-ID auf der Seite „Agent-Installationsprogramm“ in NinjaOne
  1. Speichern Sie die Änderungen, wenn Sie fertig sind.
  2. Führen Sie das Automatisierungsskript erneut aus. Das Skript überprüft die Änderungen und bricht ab, wenn einer oder mehrere der folgenden Punkte zutreffen:
    • Sie haben die Kopfzeile, die Endzeile oder alle Zielzeilen gelöscht.
    • Sie haben Organisationseinheiten (OUs) als Ziel ausgewählt, aber keine Änderungen am benutzerdefinierten Feld vorgenommen.
    • Sie haben den Zielbereich auf „Sicherheitsgruppen“ festgelegt, das benutzerdefinierte Feld enthält jedoch Organisationseinheiten (OUs) oder umgekehrt.
    • Sie haben die Namen von Organisationseinheiten oder Sicherheitsgruppen so bearbeitet, dass sie nicht mehr mit dem Domänencontroller übereinstimmen.
    • Ein oder mehrere Computerobjekte existieren in mehreren Sicherheitsgruppen mit widersprüchlichen Standort-Token-IDs.
    • Eine Token-ID ist in einem ungültigen GUID-Format gespeichert.

Wenn das Automatisierungsskript das benutzerdefinierte Feld validiert, fährt es mit Schritt drei fort.

Zusätzliche Ressourcen

Um mehr über die Automatisierung Ihrer NinjaOne-Workflows und die Personalisierung Ihrer Instanz zu erfahren, lesen Sie die folgenden Artikel:

FAQ

Nächste Schritte