企业官网建设流程全解析

如何通过 Microsoft Intune 批量部署 screenpipe enterprise 到 Windows 设备？

【免费下载链接】screenpipeYC (S26) | Open Computer History | Record your screen continuously locally and provide context to your agents (Claude, Codex, Openclaw, Hermes, Runner...)项目地址: https://gitcode.com/GitHub_Trending/sc/screenpipe

screenpipe 支持在 Microsoft Intune 中创建 Win32 应用，把 screenpipe enterprise 安装到 Microsoft Entra（Azure AD）安全组内的所有 Windows 设备：IT 管理员只需上传一次.intunewin包并分配给组，设备在下一次 Intune 同步时自动完成安装，无需逐台手动操作。整个流程按文档估算在拿到 enterprise 许可证后约 10 分钟可走完。

这条路径只适用于screenpipe enterprise客户——消费版和团队版不提供.intunewin包。开始之前，完整操作文档位于仓库的 intune-deployment.mdx，本文按该文档整理。

前置条件

按文档列出的要求，需要同时具备：

• screenpipe enterprise 许可证（管理员邮箱在许可证的admin_emails中）；
• Microsoft Intune 订阅（包含在 Microsoft 365 E3/E5、EMS E3/E5 或 Intune 独立订阅中）；
• 一个包含目标用户的 Microsoft Entra 安全组；
• 对 Intune admin center（intune.microsoft.com）的访问权限。

第 1 步：下载 .intunewin 安装包

用许可证上的管理员邮箱登录 screenpi.pe/enterprise 控制台，打开builds标签页，下载最新的windows x64intunewin文件。

.intunewin是 Microsoft Win32 Content Prep 工具封装的产物，里面包含代码签名的 NSIS 安装程序（screenpipe_<version>_x64-setup.exe）和安装包装脚本，screenpipe 为每个 enterprise 版本构建它。仓库中的 exe-to-intunewin.ps1 展示了官方是如何生成这个包的：调用IntuneWinAppUtil.exe，把安装包和install-screenpipe-enterprise.ps1一起打包。

第 2 步：在 Intune 中创建 Win32 应用

在 Intune admin center 中：

1. Apps → Windows → Add，应用类型选择Windows app (Win32)；
2. App package file上传第 1 步下载的.intunewin，Intune 会自动读取安装程序元数据；
3. 填写 App information：名称、发布者、描述按需填写，最终用户会在 Company Portal 中看到；图标可从 screenpi.pe/icon.png 下载。

第 3 步：配置安装与卸载命令

在Program一节填写：

powershell.exe -ExecutionPolicy Bypass -File install-screenpipe-enterprise.ps1

"%ProgramFiles%\screenpipe\uninstall.exe" /S

.intunewin包内除了签名 NSIS 安装程序，还包含install-screenpipe-enterprise.ps1。该包装脚本会以静默方式运行安装程序，然后写入注册表标记HKLM\SOFTWARE\screenpipe下的InstallSource=Intune、UpdateManager=mdm和Version=<构建版本>，应用和企业控制台据此判断更新由 Intune 管理。这一机制在 install_metadata.rs 中可以看到：应用启动时读取该注册表键来识别 MDM 管理状态。

同一页面还要确认：

第 4 步：设置部署系统要求

第 5 步：配置检测规则

选择Manually configure detection rules。

首次安装用文件存在性规则即可：

Intune 用它判断安装是否成功，并在后续检查时确认设备是否已安装。

如果要发版升级，建议使用注册表检测规则来识别具体版本：

没有版本感知的检测规则时，Intune 只能知道设备上有 screenpipe，无法判断设备是否还停留在旧版本。

第 6 步：依赖与版本替代

screenpipe 把 WebView2、ONNX Runtime、ffmpeg 全部打包在 NSIS 安装器内，dependencies 保持为空。

如果是从旧部署版本升级，把supersedence指向旧的 Intune 应用条目，Intune 会先干净地卸载旧版本再装新版。

第 7 步：选择更新策略

screenpipe enterprise 支持两种更新管理器：

• Intune/MDM 管理：集中管理机群推荐的默认方式。每发新版就上传新的.intunewin，配合上面的注册表Version检测规则，并让新应用条目 supersedence 旧条目；
• screenpipe 自动更新：在企业控制台中启用后，应用可从签名的 enterprise 发行版自我更新。

企业控制台中应用更新保持auto-detect，除非你明确希望应用自更新。通过本 Intune 包安装的设备被盖上UpdateManager=mdm标记，auto-detect 会保持应用内更新关闭，让 Intune 作为唯一更新来源。

第 8 步：分配应用

将应用以Required分配给包含目标用户的 Microsoft Entra 安全组（例如screenpipe-users）。Intune 会在组内成员登录的每一台设备上安装，通常在下次 Intune 检查时（约 1 小时内）完成；用户也可以在 Company Portal 中点Sync立即触发。

文档建议的可选项：再创建一个 "screenpipe-revoke" 组并分配Uninstall策略作为一键吊销开关——把用户移入该组后，设备下次检查时自动卸载。

第 9 步：激活企业许可证

screenpipe 需要许可证密钥才能启用企业模式（集中遥测、策略强制、控制台访问）。文档给出两种激活方式：

方式一：用户粘贴一次。Intune 装好 screenpipe 后，用户打开应用，选择use enterprise key并粘贴许可证密钥，密钥保存在设备本地的 screenpipe 配置中。如果组织策略要求账号登录，用户改选sign in with enterprise account；该策略下纯密钥路径会被禁用。

方式二：注册表预置（零接触）。在 Intune 设备配置 profile 中添加PowerShell script并分配给同一组，在 screenpipe 首次启动前把密钥写入注册表：

$key = "ENT-XXXX-XXXX-XXXX-XXXX" # 替换为你的许可证密钥 New-Item -Path "HKLM:\SOFTWARE\screenpipe" -Force | Out-Null Set-ItemProperty -Path "HKLM:\SOFTWARE\screenpipe" -Name "EnterpriseLicenseKey" -Value $key -Type String

其中ENT-XXXX-XXXX-XXXX-XXXX需替换为你实际的企业许可证密钥。screenpipe 启动时读取HKLM\SOFTWARE\screenpipe\EnterpriseLicenseKey并自动激活，无需用户交互。64 位注册表视图优先，32 位视图也兼容旧部署脚本，会被读取。

验证部署结果

文档给出的三个检查点：

• Intune admin center：Apps → screenpipe → Device install status，逐台设备查看安装状态；
• 设备端：C:\Program Files\screenpipe\screenpipe-app.exe存在，且用户首次登录后系统托盘出现 screenpipe 图标；
• 企业控制台devices标签页：每台已安装设备在启动后数分钟内开始发送心跳，且限定在你的许可证范围内。

排查与限制

Intune 显示安装成功但应用打不开。NSISperMachine安装到%ProgramFiles%\screenpipe，但默认不会添加开始菜单自启动。用户可以从开始菜单手动启动，或者通过企业控制台 →policy→ 打开autostart_on_login: true启用登录自启动。

设备报安装失败，退出码 2 或 1603。文档指出几乎都是权限不足：确认 install behavior 是System而不是User，用户上下文安装无法写入%ProgramFiles%。

安装后显示 "license invalid"。两种可能：注册表预置脚本没在首次启动前运行（检查 Intune 脚本分配和执行顺序），或许可证已过期。在 企业控制台 →policy→ license info 中查看有效期。

录音不启动。Windows 上麦克风访问受系统权限门控。要么部署 Windows 隐私设置 profile 授予 screenpipe 麦克风访问，要么让用户在首次启动时手动批准一次。文档说明策略批量授权对机群部署更干净，AppX 风格的 manifest 映射需要联系 screenpipe 官方获取。

参考

• 完整部署文档：docs/mintlify/docs-mintlify-mig-tmp/intune-deployment.mdx
• 官方 Intune 包生成脚本：apps/screenpipe-app-tauri/scripts/exe-to-intunewin.ps1
• MDM 安装来源检测实现：apps/screenpipe-app-tauri/src-tauri/src/enterprise/install_metadata.rs

文档说明 macOS 的 Jamf / Kandji / Mosyle 分发流程形态相同，需要使用 macOS MDM 工具，具体联系 screenpipe 官方获取。

【免费下载链接】screenpipeYC (S26) | Open Computer History | Record your screen continuously locally and provide context to your agents (Claude, Codex, Openclaw, Hermes, Runner...)项目地址: https://gitcode.com/GitHub_Trending/sc/screenpipe