Support Companion — это вспомогательное приложение для macOS, предназначенное для расширения возможностей конечных пользователей, предоставляя им быстрый и простой доступ к важной информации и действиям. Это приложение создано для упрощения выполнения различных задач, устраняя необходимость в обширном поиске и сложной навигации. Support Companion оснащен рядом функций, повышающих производительность пользователя.
Он интегрируется с Munki и Intune для получения информации и обновлений приложений, предоставляя единую платформу для управления этими службами. Пользователи могут сразу просмотреть информацию о системе, такую как версия, модель и серийный номер macOS, а также выполнить такие действия, как смена паролей, перезагрузка и многое другое, всего несколькими щелчками мыши.
Эта первоначальная версия использует Munki и/или Intune для получения информации о приложениях и обновлений. Если вы не используете Munki или Intune, это приложение на данный момент может не предоставлять столь подробную информацию.
Если есть пожелания добавить другие действия и информацию, относящиеся к MDM, дайте мне знать. Я готов добавить больше поставщиков MDM в будущем, если на это будет спрос. Я могу тестировать только с помощью Intune, поэтому, если у вас есть другой поставщик MDM, я буду признателен за вашу помощь в тестировании.
Действия : выполнение таких действий, как изменение пароля, уничтожение агента Intune MDM, сбор журналов, перезагрузка и многое другое.
Информация о системе : быстрый просмотр информации о системе, такой как версия macOS, модель, серийный номер и время последней загрузки.
Evergreen : посмотрите, членом какого каталога Munki являются устройства (требуется локальный манифест устройства с серийным номером в качестве имени).
Батарея : просмотр информации о батарее, такой как количество циклов и состояние батареи.
MDM : просмотр информации MDM, такой как статус и дата регистрации.
Диск : просмотр информации о диске, такой как дисковое пространство и состояние FileVault.
Ход установки исправлений приложений : просмотр хода установки исправлений приложений.
Ожидающие обновления : просмотр ожидающих обновлений для приложений.
Приложения : просмотр установленных приложений и их версий.
Идентификация : просмотр информации профиля текущего пользователя и информации единого входа Kerberos или единого входа платформы.
Информация о рабочем столе : отображение на рабочем столе такой информации, как имя устройства, серийный номер, версия macOS и IP-адрес.
Пользовательские виджеты : добавьте пользовательские виджеты на главный экран, это позволяет отображать информацию, специфичную для вашей организации.
Самообслуживание : отображаются все действия в приложении, настроенные в профиле MDM. Это позволяет пользователю осуществлять самообслуживание с помощью пользовательского интерфейса, а не только значка в строке меню.
Приложение локализовано на Swedish
, Norwegian
, French
и German
. Приложение будет отображаться на предпочитаемом пользователем языке, если в macOS для него установлен один из этих языков. Если предпочтительный язык пользователя не входит в число этих, в приложении по умолчанию будет выбран английский.
Вклады на других языках приветствуются!
Получите последнюю версию установщика PKG из выпусков.
Загрузите и установите пакет MacAdmins Python отсюда.
Это необходимо, чтобы приложение запускало сценарии, например сбор информации MDM.
Запустите установщик PKG.
Необязательный
Установите пакет агента запуска, прикрепленный к выпуску, чтобы автоматически запускать и поддерживать работу приложения.
Приложение устанавливается в папку /Applications/Utilities
, а также устанавливаются следующие файлы и папки:
/Applications/Utilities/SupportCompanion.app
— пакет приложения.
/Library/Application Support/SupportCompanion
— папка, содержащая следующие файлы:
Scripts
— сценарии, используемые для получения такой информации, как статус MDM.
Файлы JSON, созданные сценариями для чтения приложения.
/Library/LaunchDaemons/com.almenscorner.supportcompanion.plist
— LaunchDaemon для запуска скриптов приложения.
~/Library/Application Support/SupportCompanion/
— папка, содержащая данные приложения, такие как отметки времени уведомлений.
Сценарий удаления включен в комплект приложения. Сценарий можно найти в следующем месте: /Applications/Utilities/Support Companion.app/Contents/Resources/Uninstall.sh
Агент запуска, предоставленный в виде подписанного, нотариально заверенного и скрепленного пакета, если он установлен и загружен:
Запустите приложение, если оно не запущено
Запустите приложение снова, если пользователь вышел из него
Запустите приложение при входе в систему
Этот агент запуска является необязательным, и вы можете создать свой собственный агент запуска, если захотите.
Пакет пакета — это подписанный, нотариально заверенный и скрепленный пакет, содержащий приложение и пакет агента запуска. Этот пакет предоставляется для удобства и может использоваться для одновременной установки приложения и агента запуска.
Рецепт для AutoPkg доступен здесь.
При настройке значков для пользовательских виджетов или действий имя значка должно быть именем значка материала из https://pictogrammers.com/library/mdi/. Например, поиск яблок будет AppleFinder.
Когда приложение запустится, появится значок в строке меню. При нажатии на значок отобразятся доступные действия, например открытие приложения. Для приложения значок в доке не будет отображаться, и доступ к приложению следует осуществлять через значок в строке меню. Это делается для того, чтобы приложение не мешало, не загромождало док-станцию, а администраторам было проще запускать приложение из терминала или сценария, не показывая приложение конечному пользователю. При инициализации приложения таким способом пользователю отправляются уведомления, например, если у него есть доступные обновления программного обеспечения.
Журналы можно просмотреть, выполнив в терминале следующую команду: log stream --debug --info --predicate 'subsystem contains "com.almenscorner.supportcompanion"'
Или выполнив поиск subsystem: com.almenscorner.supportcompanion
в приложении «Консоль».
Многие аспекты приложения можно настроить с помощью профилей MDM. Доступны следующие ключи:
Ключ | Тип | По умолчанию | Необходимый | Описание |
---|---|---|---|---|
BrandName | Нить | Никто | ЛОЖЬ | Настраивает название бренда, отображаемое в меню. |
BrandColor | Нить | Синий | ЛОЖЬ | Настраивает цвет бренда, отображаемый в приложении. Доступные цвета: синий, зеленый, красный, оранжевый. |
BrandLogo | Нить | Никто | ЛОЖЬ | Настраивает логотип бренда, отображаемый в боковом меню приложений. Укажите локальный путь или строку base64. |
SupportPageUrl | Нить | Никто | ЛОЖЬ | Настраивает URL-адрес, который будет открываться, когда пользователь нажимает кнопку «Получить поддержку». |
ChangePasswordUrl | Нить | Никто | ЛОЖЬ | Настраивает URL-адрес, который будет открываться, когда пользователь нажимает кнопку «Изменить пароль». |
ChangePasswordMode | Нить | местный | ЛОЖЬ | Настраивает режим для кнопки «Изменить пароль». Доступные режимы: local , SSOExtension , url |
SupportEmail | Нить | Никто | ЛОЖЬ | Настраивает адрес электронной почты, отображаемый, когда пользователь нажимает кнопку «Информация о поддержке». |
SupportPhone | Нить | Никто | ЛОЖЬ | Настраивает номер телефона, отображаемый, когда пользователь нажимает кнопку «Информация о поддержке». |
HiddenWidgets | Множество | Никто | ЛОЖЬ | Настраивает виджеты, которые нужно скрыть. Доступные виджеты: DeviceInfo , MunkiPendingApps , MunkiUpdates , IntunePendingApps , IntuneUpdates , Storage , MdmStatus , Actions , Battery , EvergreenInfo |
HiddenActions | Множество | Никто | ЛОЖЬ | Настраивает действия, которые нужно скрыть. Доступные действия: Support , ManagedSoftwareCenter , ChangePassword , Reboot , KillAgent , SoftwareUpdates , GatherLogs |
NotificationInterval | Целое число | 4 | ЛОЖЬ | Настраивает интервал уведомлений в часах для уведомлений об обновлениях приложений и программного обеспечения. Установка значения 0 отключает уведомления. |
NotificationTitle | Нить | Поддержка компаньона | ЛОЖЬ | Настраивает заголовок для уведомлений |
NotificationImage | Нить | Никто | ЛОЖЬ | Настраивает изображение для добавления в уведомления. Путь должен быть указан |
SoftwareUpdateNotificationMessage | Нить | У вас есть доступные обновления программного обеспечения. Примите меры сейчас! ud83cudf89 | ЛОЖЬ | Настраивает сообщение для уведомлений об обновлениях программного обеспечения. |
SoftwareUpdateNotificationButtonText | Нить | Подробности | ЛОЖЬ | Настраивает текст кнопки для уведомлений об обновлениях программного обеспечения. |
AppUpdateNotificationMessage | Нить | У вас доступны обновления приложения. Примите меры сейчас! ud83cudf89 | ЛОЖЬ | Настраивает сообщение для уведомлений об обновлениях приложений. |
AppUpdateNotificationButtonText | Нить | Подробности | ЛОЖЬ | Настраивает текст кнопки для уведомлений об обновлениях приложений. |
CustomColors | Множество | Никто | ЛОЖЬ | Настраивает пользовательские цвета для приложения. Их следует указывать в шестнадцатеричном формате, см. пример ниже. Не используйте BrandColor вместе с этим ключом. |
IntuneMode | Бул | ЛОЖЬ | ЛОЖЬ | Настраивает приложение для использования Intune для получения информации о приложении. Поддерживается только приложения типа PKG и DMG, но не LOB. |
LogFolders | Множество | /Библиотека/Журналы/Microsoft | ЛОЖЬ | Настраивает папки журналов для сбора журналов. Используется только при сборе журналов. |
Actions | Множество | Никто | ЛОЖЬ | Настраивает пользовательские действия для добавления в меню на панели задач. См. пример ниже. |
ShowMenuToggle | Бул | Истинный | ЛОЖЬ | Определяет, отображать ли кнопку переключения меню в боковом меню приложений. |
ShowDesktopInfo | Бул | ЛОЖЬ | ЛОЖЬ | Настраивает, отображать ли информацию на рабочем столе. |
DesktopPosition | Нить | Верхний правый | ЛОЖЬ | Настраивает положение информации на рабочем столе, доступные позиции: TopLeft , TopRight , BottomLeft , BottomRight |
DesktopInfoLevel | Нить | Полный | ЛОЖЬ | Настраивает уровень информации для отображения на рабочем столе. Доступные уровни: Minimal , Hardware , Full , Custom |
DesktopInfoCustomItems | Множество | Никто | ЛОЖЬ | Если для DesktopInfoLevel установлено Custom , используйте этот массив, чтобы определить, какую информацию отображать. Доступная информация: HostName , Model , SerialNumber , Processor , IpAddress , MemSize , OsBuild , OsVersion , LastBootTime , StorageInfo , SupportPhone , SupportEmail , Separator . |
DesktopInfoBackgroundColor | Нить | Прозрачный | ЛОЖЬ | Настраивает цвет фона для информации на рабочем столе. Настройка с использованием шестнадцатеричного формата |
DesktopInfoBackgroundOpacity | Настоящий | 1.0 | ЛОЖЬ | Настраивает непрозрачность фона для информации на рабочем столе. Настройте значение от 1,0 до 0,1. |
DesktopInfoColorHighlight | Бул | Истинный | ЛОЖЬ | Определяет, следует ли выделять текст в информации о рабочем столе. |
DesktopInfoFontSize | Целое число | 17 | ЛОЖЬ | Настраивает размер шрифта для информации на рабочем столе. |
CustomWidgetsPath | Нить | Никто | ЛОЖЬ | Настраивает путь к файлу JSON, содержащему пользовательские виджеты, которые будут отображаться на главном экране. |
SystemProfilerApps | Бул | Никто | ЛОЖЬ | Настраивает приложение для отображения списка всех приложений, установленных в папке /Applications , и их версий. Полезно, если не используются Munki или Intune. |
Чтобы переключиться с Munki на Intune для получения информации о приложении, добавьте в профиль следующий ключ:
IntuneMode <правда/>
<диктат> Содержимое полезной нагрузки <массив> <диктат>Название бренда AwesomeCorp ИзменитьPasswordMode Расширение SSO Пользовательские цвета <массив> <диктат>Основной цвет #00A0D0 AccentColor #45637A массив>Действия <массив> <диктат>Имя Перезапустить буфер обмена? Команда killall pboard <диктат>Имя Перезапустить агент Intune ⚡️ Команда /usr/bin/osascript -e 'выполнить сценарий оболочки «sudo killall IntuneMdmAgent» с правами администратора' <диктат>Имя ️Какое-то потрясающее действие Команда echo «Я потрясающий» Значок AppleFinder массив>Название уведомления AwesomeCorp IT PayloadDisplayName SupportCompanion Идентификатор полезной нагрузки SupportCompanion Тип полезной нагрузки SupportCompanion UUID полезной нагрузки a7a0d79f-1cf0-42f2-bc7e-e67d7413a3c5 Версия полезной нагрузки <целое>1целое>Электронная почта поддержки [email protected] Телефон поддержки 123-456-789 SupportUrl https://awesomecorp.support массив>PayloadDisplayName SupportCompanion Идентификатор полезной нагрузки 9c4a8e5e-4c70-4b82-83f7-44a053c146f4 Тип полезной нагрузки Конфигурация UUID полезной нагрузки 3D47F3E6-62ED-4668-A30F-6DA1DAE87B18 Версия полезной нагрузки <целое>1целое>
АвалонияUI
СукиUI