SupportCompanion

#SupportCompanion

Beschreibung

Support Companion ist eine macOS-Hilfsanwendung, die Endbenutzern die Möglichkeit gibt, schnell und einfach auf wichtige Informationen und Aktionen zuzugreifen. Diese Anwendung wurde entwickelt, um eine Vielzahl von Aufgaben zu optimieren und umfangreiche Suchvorgänge und komplexe Navigation überflüssig zu machen. Support Companion ist mit einer Reihe von Funktionen ausgestattet, die die Benutzerproduktivität steigern.

Es lässt sich für Anwendungsinformationen und Updates in Munki und Intune integrieren und bietet so eine einheitliche Plattform für die Verwaltung dieser Dienste. Benutzer können Systeminformationen wie macOS-Version, Modell und Seriennummer auf einen Blick anzeigen und mit nur wenigen Klicks Aktionen wie das Ändern von Passwörtern, einen Neustart und mehr ausführen.

Diese erste Version basiert auf Munki und/oder Intune für Anwendungsinformationen und Updates. Wenn Sie Munki oder Intune nicht verwenden, stellt diese App derzeit möglicherweise nicht so detaillierte Informationen bereit.

Wenn Sie weitere MDM-spezifische Aktionen und Informationen hinzufügen möchten, lassen Sie es mich bitte wissen. Ich bin offen dafür, in Zukunft weitere MDM-Anbieter hinzuzufügen, wenn Bedarf besteht. Ich kann nur mit Intune testen. Wenn Sie also einen anderen MDM-Anbieter haben, würde ich mich über Ihre Hilfe beim Testen freuen.

Merkmale

• Aktionen : Führen Sie Aktionen wie „Kennwort ändern“, „Intune MDM Agent beenden“, „Protokolle sammeln“, „Neustart“ und mehr aus.

• Systeminformationen : Sehen Sie sich schnell Systeminformationen wie macOS-Version, Modell, Seriennummer und letzte Startzeit an.

• Immergrün : Sehen Sie, in welchen Munki-Katalogen die Geräte Mitglied sind (erfordert ein lokales Gerätemanifest mit der SN als Namen).

• Batterie : Zeigen Sie Batterieinformationen an, z. B. die Anzahl der Zyklen und den Zustand.

• MDM : MDM-Informationen wie Anmeldestatus und Anmeldedatum anzeigen.

• Festplatte : Anzeigen von Festplatteninformationen wie Speicherplatz und FileVault-Status.

• Fortschritt beim Patchen von Anwendungen : Sehen Sie sich den Fortschritt beim Patchen von Anwendungen an.

• Ausstehende Updates : Ausstehende Updates für Anwendungen anzeigen.

• Anwendungen : Installierte Anwendungen und deren Versionen anzeigen.

• Identität : Zeigen Sie die Profilinformationen des aktuellen Benutzers und Kerberos-SSO- oder Plattform-SSO-Informationen an.

• Desktop-Info : Zeigt Informationen auf dem Desktop an, z. B. Gerätename, Seriennummer, macOS-Version und IP-Adresse.

• Benutzerdefinierte Widgets : Fügen Sie der Home-Ansicht benutzerdefinierte Widgets hinzu, um die Anzeige spezifischer Informationen für Ihre Organisation zu ermöglichen.

• Self Service : Zeigt alle Aktionen in der App an, die im MDM-Profil konfiguriert sind. Dies ermöglicht dem Benutzer ein Self-Service-Erlebnis, indem er die Benutzeroberfläche und nicht nur das Menüleistensymbol verwendet.

Lokalisierung

Die App ist auf Swedish , Norwegian , French und German lokalisiert. Die App wird in der bevorzugten Sprache des Benutzers angezeigt, wenn sie in macOS auf eine dieser Sprachen eingestellt ist. Wenn die bevorzugte Sprache des Benutzers keine dieser Sprachen ist, wird die App standardmäßig auf Englisch eingestellt.

Beiträge in anderen Sprachen sind willkommen!

Installation

1. Besorgen Sie sich das neueste PKG-Installationsprogramm von Releases.

2. Laden Sie hier das MacAdmins-Python-Paket herunter und installieren Sie es.

• Dies ist erforderlich, damit die App die Skripte ausführen kann, beispielsweise zum Sammeln von MDM-Informationen.

3. Führen Sie das PKG-Installationsprogramm aus.

4. Optional

• Installieren Sie das der Version beigefügte Launch Agent-Paket, um die App automatisch zu starten und am Laufen zu halten.

Installierte Dateien

Die App wird im Ordner /Applications/Utilities installiert und die folgenden Dateien und Ordner werden installiert:

• /Applications/Utilities/SupportCompanion.app – Das App-Bundle

• /Library/Application Support/SupportCompanion – Ordner mit den folgenden Dateien:

• Scripts – Skripte, die zum Abrufen von Informationen wie dem MDM-Status verwendet werden

• Von den Skripten generierte JSON-Dateien, die von der App gelesen werden können

• /Library/LaunchDaemons/com.almenscorner.supportcompanion.plist – LaunchDaemon für die App zum Ausführen der Skripte

• ~/Library/Application Support/SupportCompanion/ – Ordner mit App-Daten wie Benachrichtigungszeitstempeln

Deinstallation

Ein Deinstallationsskript ist im App-Bundle enthalten. Das Skript befindet sich am folgenden Speicherort: /Applications/Utilities/Support Companion.app/Contents/Resources/Uninstall.sh

Über den Launch Agent

Der als signiertes, notariell beglaubigtes und geheftetes Paket bereitgestellte Launch Agent wird, wenn es installiert und geladen ist, Folgendes tun:

• Starten Sie die App, wenn sie nicht ausgeführt wird

• Starten Sie die App erneut, wenn sie vom Benutzer beendet wird

• Starten Sie die App beim Anmelden

Dieser Launch Agent ist optional und Sie können Ihren eigenen Launch Agent erstellen, wenn Sie möchten.

Über das Suite-Paket

Das Suite-Paket ist ein signiertes, notariell beglaubigtes und geheftetes Paket, das die App und das Launch Agent-Paket enthält. Dieses Paket dient der Bequemlichkeit und kann zur gleichzeitigen Installation der App und des Launch Agents verwendet werden.

AutoPkg

Ein Rezept für AutoPkg finden Sie hier.

Eine Anmerkung zu Symbolen

Beim Konfigurieren von Symbolen für benutzerdefinierte Widgets oder Aktionen sollte der Symbolname ein Materialsymbolname von https://pictogrammers.com/library/mdi/ sein. Apple-Finder wäre zum Beispiel AppleFinder.

Nutzung der App

Wenn die App gestartet wird, erscheint ein Menüleistensymbol. Wenn Sie auf das Symbol klicken, werden die verfügbaren Aktionen angezeigt, z. B. das Öffnen der App. Für die App wird kein Dock-Symbol angezeigt und der Zugriff auf die App sollte über das Menüleistensymbol erfolgen. Dadurch soll sichergestellt werden, dass die App nicht im Weg ist und das Dock nicht überfüllt wird. Außerdem soll es Administratoren leicht gemacht werden, die App über ein Terminal oder Skript zu starten, ohne sie dem Endbenutzer anzuzeigen. Durch die Initialisierung der App auf diese Weise werden Benachrichtigungen an den Benutzer gesendet, wenn beispielsweise Software-Updates verfügbar sind.

Fehlerbehebung

Protokolle können durch Ausführen des folgenden Befehls im Terminal angezeigt werden: log stream --debug --info --predicate 'subsystem contains "com.almenscorner.supportcompanion"'

Oder indem Sie in der Konsolen-App nach subsystem: com.almenscorner.supportcompanion suchen.

Konfiguration

Viele Aspekte der App können mithilfe von MDM-Profilen konfiguriert werden. Folgende Tasten stehen zur Verfügung:

Schlüssel	Typ	Standard	Erforderlich	Beschreibung
BrandName	Zeichenfolge	Keiner	FALSCH	Konfiguriert den im Menü angezeigten Markennamen
BrandColor	Zeichenfolge	Blau	FALSCH	Konfiguriert die in der App angezeigte Markenfarbe. Verfügbare Farben sind: Blau, Grün, Rot, Orange
BrandLogo	Zeichenfolge	Keiner	FALSCH	Konfiguriert das im Seitenmenü der Apps angezeigte Markenlogo. Geben Sie einen lokalen Pfad oder eine Base64-Zeichenfolge an
SupportPageUrl	Zeichenfolge	Keiner	FALSCH	Konfiguriert die URL, die geöffnet wird, wenn der Benutzer auf die Schaltfläche „Support anfordern“ klickt
ChangePasswordUrl	Zeichenfolge	Keiner	FALSCH	Konfiguriert die URL, die geöffnet wird, wenn der Benutzer auf die Schaltfläche „Passwort ändern“ klickt
ChangePasswordMode	Zeichenfolge	lokal	FALSCH	Konfiguriert den Modus für die Schaltfläche „Passwort ändern“. Verfügbare Modi sind: local , SSOExtension , url
SupportEmail	Zeichenfolge	Keiner	FALSCH	Konfiguriert die E-Mail-Adresse, die angezeigt wird, wenn der Benutzer auf die Schaltfläche „Support-Info“ klickt
SupportPhone	Zeichenfolge	Keiner	FALSCH	Konfiguriert die Telefonnummer, die angezeigt wird, wenn der Benutzer auf die Schaltfläche „Support-Info“ klickt
HiddenWidgets	Array	Keiner	FALSCH	Konfiguriert, welche Widgets ausgeblendet werden sollen. Verfügbare Widgets sind: DeviceInfo , MunkiPendingApps , MunkiUpdates , IntunePendingApps , IntuneUpdates , Storage , MdmStatus , Actions , Battery , EvergreenInfo
HiddenActions	Array	Keiner	FALSCH	Konfiguriert, welche Aktionen ausgeblendet werden sollen. Verfügbare Aktionen sind: Support , ManagedSoftwareCenter , ChangePassword , Reboot , KillAgent , SoftwareUpdates , GatherLogs
NotificationInterval	Ganze Zahl	4	FALSCH	Konfiguriert das Intervall für Benachrichtigungen in Stunden für Benachrichtigungen zu Anwendungsaktualisierungen und Softwareaktualisierungen. Durch die Einstellung 0 werden Benachrichtigungen deaktiviert
NotificationTitle	Zeichenfolge	Support-Begleiter	FALSCH	Konfiguriert den Titel für Benachrichtigungen
NotificationImage	Zeichenfolge	Keiner	FALSCH	Konfiguriert ein Bild zum Hinzufügen zu Benachrichtigungen. Der Pfad sollte angegeben werden
SoftwareUpdateNotificationMessage	Zeichenfolge	Es sind Software-Updates verfügbar. Werden Sie jetzt aktiv! ud83cudf89	FALSCH	Konfiguriert die Nachricht für Benachrichtigungen für Software-Update-Benachrichtigungen
SoftwareUpdateNotificationButtonText	Zeichenfolge	Details ud83dudc40	FALSCH	Konfiguriert den Schaltflächentext für Benachrichtigungen für Software-Update-Benachrichtigungen
AppUpdateNotificationMessage	Zeichenfolge	Es sind App-Updates verfügbar. Werden Sie jetzt aktiv! ud83cudf89	FALSCH	Konfiguriert die Nachricht für Benachrichtigungen für App-Updates-Benachrichtigungen
AppUpdateNotificationButtonText	Zeichenfolge	Details ud83dudc40	FALSCH	Konfiguriert den Schaltflächentext für Benachrichtigungen für App-Updates-Benachrichtigungen
CustomColors	Array	Keiner	FALSCH	Konfiguriert benutzerdefinierte Farben für die App, sollte im Hex-Format angegeben werden, siehe Beispiel unten. Verwenden Sie BrandColor nicht in Verbindung mit diesem Schlüssel
IntuneMode	Bool	FALSCH	FALSCH	Konfiguriert die App so, dass sie Intune für Anwendungsinformationen verwendet. Unterstützt nur Apps vom Typ PKG und DMG, nicht LOB.
LogFolders	Array	/Library/Logs/Microsoft	FALSCH	Konfiguriert die Protokollordner, aus denen Protokolle gesammelt werden sollen. Wird nur beim Sammeln von Protokollen verwendet.
Actions	Array	Keiner	FALSCH	Konfiguriert benutzerdefinierte Aktionen zum Hinzufügen zum Taskleistenmenü. Siehe Beispiel unten.
ShowMenuToggle	Bool	WAHR	FALSCH	Konfiguriert, ob die Menüumschalttaste im Seitenmenü der Apps angezeigt werden soll.
ShowDesktopInfo	Bool	FALSCH	FALSCH	Konfiguriert, ob Informationen auf dem Desktop angezeigt werden sollen.
DesktopPosition	Zeichenfolge	ObenRechts	FALSCH	Konfiguriert die Position der Desktop-Informationen. Verfügbare Positionen sind: TopLeft , TopRight , BottomLeft , BottomRight
DesktopInfoLevel	Zeichenfolge	Voll	FALSCH	Konfiguriert die Informationsstufe, die auf dem Desktop angezeigt werden soll. Verfügbare Stufen sind: Minimal , Hardware , Full , Custom
DesktopInfoCustomItems	Array	Keiner	FALSCH	Wenn DesktopInfoLevel auf Custom festgelegt ist, verwenden Sie dieses Array, um zu bestimmen, welche Informationen angezeigt werden sollen. Verfügbare Informationen sind: HostName , Model , SerialNumber , Processor , IpAddress , MemSize , OsBuild , OsVersion , LastBootTime , StorageInfo , SupportPhone , SupportEmail , Separator
DesktopInfoBackgroundColor	Zeichenfolge	Transparent	FALSCH	Konfiguriert die Hintergrundfarbe für die Desktop-Informationen. Konfigurieren Sie im Hex-Format
DesktopInfoBackgroundOpacity	Real	1,0	FALSCH	Konfiguriert die Hintergrundopazität für die Desktop-Informationen. Konfigurieren Sie einen Wert zwischen 1,0 und 0,1
DesktopInfoColorHighlight	Bool	WAHR	FALSCH	Konfiguriert, ob der Text in den Desktop-Informationen hervorgehoben werden soll.
DesktopInfoFontSize	Ganze Zahl	17	FALSCH	Konfiguriert die Schriftgröße für die Desktop-Informationen.
CustomWidgetsPath	Zeichenfolge	Keiner	FALSCH	Konfiguriert einen Pfad zu einer JSON-Datei, die benutzerdefinierte Widgets enthält, die in der Home-Ansicht angezeigt werden sollen.
SystemProfilerApps	Bool	Keiner	FALSCH	Konfiguriert die App so, dass alle unter /Applications installierten Anwendungen und deren Versionen aufgelistet werden. Nützlich, wenn Munki oder Intune nicht verwendet wird.

Beispielkonfiguration

Um für Anwendungsinformationen von Munki zu Intune zu wechseln, fügen Sie dem Profil den folgenden Schlüssel hinzu:

 IntuneMode

 


  
    PayloadContent
    
      
        Markenname
        AwesomeCorp
        ChangePasswordMode
        SSOExtension
        BenutzerdefinierteFarben
        
          
            PrimaryColor
            #00A0D0
            AccentColor
            #45637A
          
        
        Aktionen
        
           
               Name
               Zwischenablage neu starten?
               Befehl
               killall pboard
           
           
               Name
               Intune Agent neu starten ⚡️
               Befehl
               /usr/bin/osascript -e 'Shell-Skript „sudo killall IntuneMdmAgent“ mit Administratorrechten ausführen'
           
            
                Name
                ️Eine tolle Aktion
                Befehl
                echo „Ich bin großartig“