首页>编程相关>其他源码
下载

#SupportCompanion

描述

Support Companion 是一款 macOS 帮助应用程序，旨在为最终用户提供快速、轻松的访问关键信息和操作的能力。该应用程序旨在简化各种任务，消除大量搜索和复杂导航的需要。 Support Companion 配备了一系列可提高用户工作效率的功能。

它与 Munki 和 Intune 集成以获取应用程序信息和更新，为管理这些服务提供统一平台。用户可以一目了然地查看 macOS 版本、型号、序列号等系统信息，只需点击几下即可执行更改密码、重启等操作。

此初始版本依赖 Munki 和/或 Intune 来获取应用程序信息和更新。如果您不使用 Munki 或 Intune，此应用目前可能无法提供详细信息。

如果希望添加其他 MDM 特定操作和信息，请告诉我。如果有需求，我愿意在未来添加更多 MDM 提供商。我只能使用 Intune 进行测试，因此如果您有其他 MDM 提供商，我将不胜感激您在测试方面的帮助。

特征

  • 操作：执行更改密码、终止 Intune MDM 代理、收集日志、重新启动等操作。

  • 系统信息：快速查看系统信息，例如 macOS 版本、型号、序列号和上次启动时间。

  • Evergreen ：查看设备属于哪个 Munki 目录（需要以 SN 作为名称的本地设备清单）。

  • 电池：查看电池信息，例如循环次数和运行状况。

  • MDM ：查看 MDM 信息，例如注册状态和注册日期。

  • 磁盘：查看磁盘信息，例如磁盘空间和 FileVault 状态。

  • 应用程序修补进度：查看修补应用程序的进度。

  • 待定更新：查看应用程序的待定更新。

  • 应用程序：查看已安装的应用程序及其版本。

  • 身份：查看当前用户的个人资料信息和 Kerberos SSO 或平台 SSO 信息。

  • 桌面信息：显示桌面上的信息，例如设备名称、序列号、macOS 版本和 IP 地址。

  • 自定义小部件：将自定义小部件添加到主页视图，这允许显示特定于您的组织的信息。

  • 自助服务：显示 MDM 配置文件中配置的应用程序中的所有操作。这允许用户使用 UI 而不仅仅是菜单栏图标获得自助服务体验。

本土化

该应用程序已本地化为Swedish 、 Norwegian 、 French和German 。如果应用程序在 macOS 中设置为这些语言之一，则该应用程序将以用户的首选语言显示。如果用户的首选语言不是其中之一，则应用程序将默认为英语。

欢迎对其他语言做出贡献！

安装

  1. 从版本中获取最新的 PKG 安装程序。

  2. 从此处下载并安装 MacAdmins Python 包。

    • 这是应用程序运行脚本（例如收集 MDM 信息）所必需的。

  3. 运行 PKG 安装程序。

  4. 选修的

    • 安装该版本附带的启动代理包以自动启动并保持应用程序运行。

已安装的文件

该应用程序安装在/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

关于启动代理

作为签名、公证和装订包提供的启动代理如果安装并加载，将：

  • 如果应用程序未运行，则启动该应用程序

  • 如果用户退出，请重新启动应用程序

  • 登录时启动应用程序

此启动代理是可选的，如果您愿意，您可以自由创建自己的启动代理。

关于套房套餐

套件包是经过签名、公证和装订的包，其中包含应用程序和 Launch Agent 包。提供此软件包是为了方便起见，可用于同时安装应用程序和 Launch Agent。

自动包装

AutoPkg 的配方可在此处找到。

关于图标的注释

为自定义小部件或操作配置图标时，图标名称应该是 https://pictogrammers.com/library/mdi/ 中的材质图标名称。例如，apple-finder 就是 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细绳详情 ud83dudc40错误的配置软件更新通知的按钮文本
AppUpdateNotificationMessage细绳您有可用的应用程序更新。立即行动！ ud83cudf89错误的配置应用程序更新通知的通知消息
AppUpdateNotificationButtonText细绳详情 ud83dudc40错误的配置应用程序更新通知的通知按钮文本
CustomColors大批没有任何错误的为应用程序配置自定义颜色，应以十六进制格式指定，请参见下面的示例。请勿将BrandColor与此键结合使用
IntuneMode布尔错误的错误的配置应用程序以使用 Intune 获取应用程序信息。仅支持 PKG 和 DMG 类型的应用程序，不支持 LOB。
LogFolders大批/库/日志/微软错误的配置从中收集日志的日志文件夹。仅在收集日志时使用。
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
        更改密码模式
        SSO扩展
        自定义颜色
        <数组>
          <字典>
            原色
            <字符串>#00A0D0
            <键>强调颜色
            <字符串>#45637A
          
        
        <键>操作
        <数组>
           <字典>
               <键>名称
               重新启动剪贴板？
               <键>命令
               killall pboard
           
           <字典>
               <键>名称
               重新启动 Intune Agent ⚡️
               <键>命令
               /usr/bin/osascript -e '使用管理员权限执行 shell 脚本“sudo Killall IntuneMdmAgent”'
           
            <字典>
                <键>名称
                ️一些很棒的动作
                <键>命令
                echo "I am Awesome"Icon
                <字符串>AppleFinder
            
        
        通知标题
        AwesomeCorp IT
        有效负载显示名称
        支持伴侣
        有效负载标识符
        支持伴侣
        <键>有效负载类型
        支持伴侣
        PayloadUUID
        <字符串>a7a0d79f-1cf0-42f2-bc7e-e67d7413a3c5
        有效负载版本
        <整数>1
        支持电子邮件
        <字符串>[email protected]
        支持电话
        <字符串>123-456-789
        支持网址
        <字符串>https://awesomecorp.support
      
    
    有效负载显示名称
    支持伴侣
    有效负载标识符
    <字符串>9c4a8e5e-4c70-4b82-83f7-44a053c146f4
    <键>有效负载类型
    <字符串>配置
    PayloadUUID
    <字符串>3D47F3E6-62ED-4668-A30F-6DA1DAE87B18
    有效负载版本
    <整数>1

概述

家

应用程序

身份

支持信息

收集日志

桌面信息

通知

制作人员

  • 阿瓦洛尼亚用户界面

  • 苏琪UI

展开
附加信息
相关应用
为您推荐
相关资讯 全部
网友评论