NinjaOne Endpunkt-Management: Personalisierung des Brandings mit dem Systray-Icon

Thema

In diesem Artikel wird erläutert, wie Sie das Systray-Icon als Teil Ihrer benutzerdefinierten NinjaOne-Website einrichten und verwenden können.

Umgebung

NinjaOne Endpunkt-Management

Beschreibung

Mit NinjaOne können Sie ein benutzerdefiniertes Systray-Symbol für Ihre Organisation erstellen und bereitstellen.

Branding: Systray-Icon (NinjaOne Inc. 02:05)

Index

Wählen Sie eine Kategorie aus, um mehr zu erfahren:

Aktivieren des Systray-Icons
Konfigurieren des Systray-Icons
- Erstellen des Menüs für das Systray-Icon
- Erläuterungen zu den Menüpunkten
Bereitstellen der Systray-Konfiguration
Das Systray-Icon löschen oder bearbeiten
Die Benutzererfahrung
Erweitete Verwendung
- Platzhalter für Menüpunkte
- Platzhalter für Hilfeformulare
Zusätzliche Ressourcen

Aktivieren des Systray-Icons

Bevor Sie das Systray-Icon nutzen können, müssen Sie es in NinjaOne aktivieren. Navigieren Sie dazu zu „Administration“ → „Allgemein“ → „Systray“ → „Aktivieren“.

**Abbildung 1:** „Administration“ → „Allgemein“ → „Systray“ → „Aktivieren“ (zum Vergrößern anklicken)

Sobald es aktiviert ist, können Sie es über die Schaltfläche „Systray hinzufügen“ konfigurieren.

add systray.png — **Abbildung 2**: „Administration“ → „Allgemein“ → „Systray“ → „Systray Hinzufügen“ (zum Vergrößern anklicken)

Konfigurieren des Systray-Icons

Klicken Sie im Anwendungsfenster von „Systray“ auf „Systray hinzufügen“, um ein neues Systray-Symbol zu konfigurieren. Um ein bestehendes Systray-Symbol zu konfigurieren, klicken Sie auf die Schaltfläche mit den drei Punkten und wählen Sie „Bearbeiten“.

add or edit systray.png — **Abbildung 3:**Systray-Icon hinzufügen oder bearbeiten (zum Vergrößern anklicken)

Im Menü „Systray hinzufügen “ können Sie personalisieren, was angezeigt wird, wenn Nutzer auf das Systray-Icon klicken.

systray config modal.png — **Abbildung 4:**Optionen zum Hinzufügen von Systray (zum Vergrößern anklicken)

Klicken Sie auf „Systray hinzufügen“, vergewissern Sie sich, dass Sie sich auf der Registerkarte „Allgemein“ befinden, und füllen Sie dann die folgenden Felder aus:

Name: Geben Sie dem Systray-Icon einen aussagekräftigen Namen.
Beschreibung: Fügen Sie optional eine Beschreibung hinzu.
Tooltip: Fügen Sie Text hinzu, der angezeigt wird, wenn ein Nutzer den Mauszeiger über das Informations-Icon verschiebt.
Systray-Icon des Betriebssystems: Laden Sie die Grafik hoch, die Sie als Systray-Icon verwenden möchten. Dieses Bild muss eine JPG- oder PNG-Datei mit einer Größe zwischen 16x16 und 128x128 Pixel sein.

Erstellen des Systray-Icon-Menüs

In diesem Schritt konfigurieren Sie das Menü, das angezeigt wird, wenn Nutzer auf das Systray-Icon klicken.

Menüpunkte hinzufügen

Klicken Sie auf der Registerkarte „Systray-Menü “ auf „Menüpunkt hinzufügen“ und wählen Sie dann den Menüpunkttyp aus dem Drop-down-Menü aus.

systray menu_add menu item.png — **Abbildung 5:**Konfiguration des Taskleistenmenüs hinzufügen (zum Vergrößern anklicken)

Konfigurieren Sie die Einstellungen des Menüpunkts. Die Konfigurationsoptionen variieren je nach dem von Ihnen ausgewählten Menüpunkt-Typ. Informationen zu den einzelnen Menüpunkt-Typen finden Sie in der Tabelle „Erläuterungen zu den Menüpunkten“ weiter unten.

**Abbildung 6:** Konfiguration der Automatisierungen (zum Vergrößern anklicken)

Menüpunkte bearbeiten

Um einen Menüpunkt zu bearbeiten, bewegen Sie den Mauszeiger darüber und klicken Sie auf die Option „Bearbeiten“, sobald diese angezeigt wird. Sie können Elemente im Menübaum auch per Drag & Drop verschieben, um sie nach Ihren Wünschen anzuordnen. Klicken Sie anschließend auf „Änderungen speichern“.

**Abbildung 7:** Menüpunkt bearbeiten (zum Vergrößern anklicken)

Menüpunkte löschen

Um einen Menüpunkt zu löschen, bewegen Sie den Mauszeiger darüber und klicken Sie auf die Option „Entfernen“, sobald diese angezeigt wird.

**Abbildung 8:** Icon „Menüpunkt entfernen“ (zum Vergrößern anklicken)

Erläuterungen zu den Menüpunkten

In der folgenden Tabelle werden die verschiedenen Arten von Menüpunkten erläutert.

Menüpunkt-Typ	Beschreibung
Über	Über diesen Menüpunkt können Sie Informationen zu Ihrem Unternehmen einfügen. Er ist einmalig verwendbar und befindet sich immer auf der obersten Ebene; er kann nicht verschachtelt werden. Das Feld „Beschreibung“ unterstützt Basis-HTML. Das System zeigt hier die unter „Branding“ angelegte E-Mail-Adresse und Telefonnummer an.
Automatisierung	NinjaOne bietet nur Automatisierungen an, die mit dem ausgewählten Betriebssystem kompatibel sind. Wenn ein Benutzer eine Automatisierung auswählt, führt der NinjaRMM-Agent die Automatisierung und alle zugehörigen Skripte nacheinander aus. Ausgeführte Automatisierungen, die über die Taskleiste ausgeführt werden, lösen auf Geräteebene die Aktivität „Start vom Endbenutzer des Geräts angefordert“ aus. Sie können diese Aktivitäten im Gerät-Dashboard filtern. Sie können Automatisierungen hinzufügen, die nicht nativ in NinjaOne enthalten sind. Fügen Sie die Automatisierung zunächst der Automatisierungsbibliothek hinzu. Anweisungen finden Sie unter „Erste Schritte mit der NinjaOne-Automatisierungsbibliothek (Skripting)“. Führen Sie Systray-Automatisierungen auf Remote-Desktop-Servern nicht als „derzeit angemeldeter Benutzer“ aus. Andernfalls wird das Skript in einer Mehrbenutzerumgebung in der ersten Sitzung ausgeführt und zielt somit nicht auf einen bestimmten Benutzer ab.
E-Mail	Mit dem E-Mail-Typ können Sie eine E-Mail personalisieren, die ein Kunde an Sie senden kann. Diese Option nutzt das auf dem Knoten konfigurierte E-Mail-Programm. Sie können beim Menüpunkt „E-Mail“ auch Umgebungsvariablen verwenden.
Beenden	Dieses Einmal-Element befindet sich immer auf der obersten Ebene. Es kann nicht verschachtelt werden. Das Element fügt eine „Beenden“-Option ein, mit der Ihre Benutzer die Systray-Ausführungsdatei schließen können.
Gruppe	Mit „Gruppe“ können Sie Menüüberschriften für Ihre Systray-Elemente erstellen. Standardmäßig werden Elemente auf der obersten Ebene hinzugefügt. Sie können so viele Gruppen erstellen, wie Sie benötigen.
Formular Hilfeanforderung	Dieses Einmal-Element befindet sich immer auf der obersten Ebene; es kann nicht verschachtelt werden. Mit diesem Elementtyp können Sie ein dynamisches Formular konfigurieren, das Sie an eine E-Mail-Adresse, Ihr integriertes PSA-Tool oder NinjaOne Ticketing weiterleiten können. Wenn Sie die Anfrage an Ihr integriertes PSA-Tool senden, können Sie die Ticketvorlage auswählen. Diese Option wird nicht für NinjaOne Ticketing angewendet. Die Felder „Betreff“ und „Beschreibung“ unterstützen einfaches HTML und Platzhalter. Standardmäßig werden alle verfügbaren Platzhalter zum Formular hinzugefügt (und sind unten in Textform aufgeführt). Sie können Platzhalter nach Belieben hinzufügen, entfernen und neu anordnen. Sie können jedes der Felder kürzen, was bei der Weiterleitung an ein PSA-Tool hilfreich ist, das die Länge von Ticket-Titeln begrenzt. Beispiel: `„Hilfe-Anfrage von ${Kundenname?truncate(25)} / ${form.subject?truncate(100)}“` Sie können Umgebungsvariablen mit dem Menüpunkt „Formular Hilfeanforderung “ verwenden. Weitere Informationen finden Sie unter „Branding: Umgebungsvariablen über das Systray-Symbol “. Endnutzer können Screenshots senden und Bildanhänge hinzufügen. Wenn Ihr Hilfeanfrageformular so eingerichtet ist, dass es an ein integriertes PSA-Tool weitergeleitet wird, erscheint die E-Mail (zusammen mit allen anderen Inhalten) als Notiz im Ticket. Die E-Mail füllt keine Felder in Ihrem PSA automatisch aus und wird nicht mit einem bestehenden Kontakt synchronisiert.
Start	Mit diesem Elementtyp können Sie Startbefehle für Ihre Kunden bereitstellen. Sie können den Pfad und den Dateinamen der auszuführenden Datei sowie Befehlszeilenargumente angeben. Diese Funktion führt Anwendungen als angemeldeten Benutzer aus. Hier sind einige Beispiele für cmd-Befehle, die Sie über das Systray-Icon ausführen können (diese Liste ist nicht vollständig): Programme einblenden/entfernen: `Cmd.exe /c „appwiz.cpl“` Computerverwaltung einblenden:`Cmd.exe /c "compmgmt.msc"` Systemsteuerung einblenden:`Cmd.exe /c „control panel“` Eingabeaufforderung starten:`Cmd.exe` Geräteverwaltung einblenden:`Cmd.exe /c "devmgmt.msc"` Datenträgerverwaltung einblenden:`Cmd.exe /c "diskmgmt.msc"` Ereignisanzeige einblenden:`Cmd.exe /c „eventvwr.msc“` Netzwerkverbindungen einblenden:`Cmd.exe /c „control netconnections“` Drucker einblenden:`Cmd.exe /c "control printers"` MTSC einblenden:`Cmd.exe /c „mstsc“` Dienste einblenden:`Cmd.exe /c „services.msc“` „msinfo“ einblenden:`Cmd.exe /c „msinfo32“` Taskmanager einblenden: `Cmd.exe /c "taskmgr"` Computernamen einblenden:`Cmd.exe /c „Control sysdm.cpl“` Vollständige IP-Konfigurationsinformationen einblenden:`Cmd.exe /k „ipconfig /all“` IP-Adresse freigeben: `Cmd.exe /k "ipconfig /release"` IP-Adresse erneuern:`Cmd.exe /k „ipconfig /renew“` DNS-Resolver-Cache leeren: `Cmd.exe /k "ipconfig /flushdns"` Hinweis: Der vollständige Pfad ist nicht erforderlich für ausführbare Dateien, die sich in Verzeichnissen befinden, die in der Umgebungsvariablen PATH aufgeführt sind Verwenden Sie für macOS-Geräte den in macOS nativ integrierten Befehl „open“. Beispiel: `open "/Applications/Google Chrome.app"` Weitere Beispiele für die Verwendung des Befehls „open“ finden Sie mit dem Befehl „man open“ im nativen Terminal oder im Ninja Remote Terminal. Auf macOS-Geräten können Sie außerdem das folgende Beispiel verwenden, um in ein benutzerdefiniertes Feld zu schreiben:` `"/Applications/NinjaRMMAgent/programdata/ninjarmm-cli" set Systraymacinstallshottr true``
Trennzeichen	Dieser Typ fügt ein Trennzeichen zwischen Menüpunkten oder Gruppen ein.
Statisch	Mit diesem Befehl können Sie statischen Text eingeben, den das System dem Nutzer anzeigt.
URL	Mit diesem Elementtyp können Sie bestimmte URLs konfigurieren, die Ihre Kunden bei Bedarf aufrufen können. Dieser Befehl ist hilfreich, wenn Sie Ihren Kunden ermöglichen möchten, Sie über Skype oder eine andere dynamische URL anzurufen.

Bereitstellung der Systray-Konfiguration

Nach dem Konfigurieren des Systray-Icons können Sie es in einer oder mehreren Organisationen bereitstellen.

Navigieren Sie zur Registerkarte „Administration “ → „Organisationen “.
Aktivieren Sie das Kontrollkästchen neben den gewünschten Organisationen. Sie können mehr als eine Organisation auswählen.
Klicken Sie auf „Einstellungen bearbeiten “ und wählen Sie „Systray“ aus dem Dropdown-Menü aus.

**Abbildung 9:** Einstellungen bearbeiten → Systray (zum Vergrößern anklicken)

Aktivieren Sie den Schalter „Systray aktivieren“, wählen Sie die gewünschte Systray-Vorlage aus und klicken Sie anschließend auf „Anwenden“, um die Änderungen zu speichern.

Alternativ können Sie das Systray-Icon über die Seite der Organisation zur Konfiguration bereitstellen:

Navigieren Sie zur Registerkarte „Administration → Organisationen“ und wählen Sie die Organisation aus. Die Registerkarte „Allgemein“ ist standardmäßig geöffnet.
Aktivieren Sie den Schalter „Systray-Symbol“, wählen Sie die gewünschte Symbolvorlage aus dem Drop-down-Menü aus und klicken Sie auf „Speichern“.

**Abbildung 10: Bearbeitung** von der Konfigurationsseite (zum Vergrößern anklicken)

Löschen oder Bearbeiten des Systray-Icons

Stellen Sie sicher, dass das Systray-Symbol nicht konfiguriert oder einer Organisation zugeordnet ist, bevor Sie versuchen, es zu löschen. Das Standard-Systray-Symbol kann nicht gelöscht werden.

Navigieren Sie zu „Administration“ → „Allgemein “ und öffnen Sie die Registerkarte „Systray “.
Verschieben Sie den Mauszeiger über die Systray -Zeile und klicken Sie auf das Icon mit den drei Punkten.
Auswählen Sie die gewünschte Aktion.

Das System zeigt eine Fehlermeldung an, wenn das Systray-Symbol bereits für eine Organisation konfiguriert ist. Sie können das Systray-Symbol erst löschen, nachdem Sie die zugehörige Organisationskonfiguration gelöscht haben. Klicken Sie im Dialogfeld auf den Namen der Organisation, um das Systray-Symbol dieser Organisation zu ändern.

Die Benutzererfahrung

Nach der Bereitstellung des Systray-Symbols wird auf dem System des Benutzers das von Ihnen festgelegte Symbol (oder das standardmäßige Zahnrad-Symbol) angezeigt, und Benutzer können mit den von Ihnen konfigurierten Tooltips interagieren.

Beispiel für Microsoft Windows

**Abbildung 11:** Windows-Systray-Iconvon „“ (zum Vergrößern anklicken)

Beispiel für Apple macOS

**Abbildung 12:** Systray-Icon unterApple macOS (zum Vergrößern anklicken)

Beispiel für Linux

**Abbildung 13: Linux** -Systray-Icon (zum Vergrößern anklicken)

Möglicherweise müssen Sie eine Tray-Erweiterung (z. B. GNOME)installieren, um das Taskleisten-Symbol mit dem Linux-Agenten nutzen zu können. Die Tray-Erweiterung hängt von der verwendeten Desktop-Umgebung ab.

Erweitete Verwendung

Platzhalter für Menüpunkte

Platzhalter zur Verwendung in Menüpunkten (URLs, Start oder Dialogfeld „Über“ ):

${IP_ADDR}: IP-Adressen
${USERNAME}: Benutzername des aktuellen Nutzers
${HOSTNAME}: Hostname des Rechners
${DOMAIN}: Domain des Computers, dem der Node beigetreten ist
${TIMESTAMP}: Aktueller Zeitstempel im ISO-Format (UTC)
Irgendeine Umgebungsvariable, z. B. ${PROCESSOR_ARCHITECTURE}

Hilfe zu Formular-Platzhaltern

Vorname: $ {form.firstName}
Nachname: ${form.lastName}
E-Mail: ${form.email}
Telefon: ${form.phone}
Betreff: ${form.subject}
Problembeschreibung: ${form.body}
Gerät: ${node.displayName}
Ninja URL: ${node.URL}
Gerät Rolle: ${node.nodeRole}
Öffentliche IP: ${node.publicIpAddress}
Private IP-Adressen: ${node.ipAddress}
Geräte-ID: ${node.id}
Organisation: $ {client.name}
Beschreibung: ${client.description}
URL der Organisation: ${client.url}
Richtlinie: ${policy.name}
Richtlinienbeschreibung: ${policy.description}
Richtlinien-URL: ${policy.url}

Darüber hinaus können Sie jede im System konfigurierte Umgebungsvariable mit dem Präfix „env.“ verwenden.

COMPUTERNAME: ${COMPUTERNAME}
OS: ${env.OS}
ANZAHL_DER_PROZESSOREN: ${ANZAHL_DER_PROZESSOREN}
PROZESSORARCHITEKTUR: ${PROZESSORARCHITEKTUR}
USERDOMAIN: ${USERDOMAIN}
Benutzername: ${BENUTZERNAME}

Zusätzliche Ressourcen

Weitere Informationen finden Sie in der folgenden Dokumentation: