前置条件与预计耗时
检查前需要确认终端操作系统、McAfee Agent 或 Trellix Agent 的安装状态，并准备本机管理员权限；如果还要核对企业策略和最近通信记录，还需要能够登录企业安全管理控制台。单台终端完成基础检查通常需要 5 至 10 分钟，连同控制台对照和异常定位，建议预留 15 至 30 分钟。不同 Agent 版本、操作系统和企业管理平台的命令路径可能不同，下面先给出通用检查思路，再说明如何自行确认本机适用的命令和入口。
第一步：确认终端是否安装并运行代理
目标是先排除“没有安装代理”或“代理服务未启动”这两类基础问题。Windows 终端可以打开“服务”管理工具，查找名称中包含 McAfee Agent、McAfee Framework、Trellix Agent 或相近名称的服务，观察其状态是否为“正在运行”，并记录启动类型。也可以在已安装程序、系统应用列表或企业软件目录中查找 Agent 安装项。不要只凭桌面右下角是否有图标判断，因为部分企业环境会隐藏状态图标。
Linux 或 macOS 终端则应先检查 Agent 的安装目录、服务进程或启动项。企业环境中常见的 Agent 命令工具名称是 cmdagent，但具体位置可能因版本和安装方式不同而变化。可以先在安装目录中搜索 cmdagent，或者通过系统的服务和进程管理工具查看相关进程，再使用该版本提供的帮助参数确认可用选项。
验收标准是：能够找到 Agent 安装痕迹，相关服务或进程处于运行状态，并且没有持续出现启动失败、服务自动停止或权限错误。常见失败是完全找不到服务或安装目录，这通常表示代理未安装、已被卸载、安装损坏，或者当前账号没有查看完整服务信息的权限。此时应先核对设备是否属于企业管理范围，再联系管理员重新部署或修复 Agent，不要直接复制其他版本的程序文件覆盖安装。
第二步：在 Windows 上使用 cmdagent 查看状态
目标是获取 Agent 自身报告的状态信息，而不仅是查看服务是否启动。Windows 环境中，McAfee Agent 通常提供 cmdagent.exe 工具。打开命令提示符，并根据实际安装路径切换到该工具所在目录；如果系统已经将其加入环境变量，也可以直接执行 cmdagent.exe。常见的状态查询参数是“cmdagent.exe -s”，信息查询参数通常是“cmdagent.exe -i”。不同版本支持的参数可能不完全相同，执行前可查看工具帮助信息，不能把某一版本的参数强行套用到所有终端。
执行状态查询后，重点观察 Agent 是否处于运行状态、是否能够与管理服务器通信、最近一次通信或唤醒时间、当前版本以及是否存在错误提示。执行信息查询时，重点记录 Agent 版本、设备识别信息和管理服务器相关信息。涉及设备名称、GUID、IP 地址或组织信息的输出，不建议直接粘贴到公开工单或群聊中。
验收标准是：命令能够正常执行，返回的状态不是持续错误或停止状态，最近通信时间与企业要求的检查周期基本一致，版本信息也符合组织当前的部署标准。若出现“不是内部或外部命令”、路径不存在或拒绝访问，应先确认命令文件位置、使用的终端类型和管理员权限。若命令可以执行但返回通信失败，不要立即反复执行刷新命令，应继续检查网络、代理配置、证书、DNS 和管理服务器可达性。
第三步：在 Linux 或 macOS 上定位并执行状态查询
目标是在非 Windows 终端上获得同等信息。先使用文件搜索或系统服务管理工具确认 cmdagent 的实际位置，再在该目录下执行状态参数。常见做法是运行该工具的帮助选项，查看当前版本支持的状态和信息查询参数；如果厂商文档或企业部署脚本规定了固定路径，应以该路径为准。不要根据 Windows 的 exe 文件名或路径直接推断 Linux、macOS 的安装位置。
状态输出中需要关注运行状态、版本、最近通信结果、管理服务器地址或连接错误。若系统采用权限隔离，普通用户可能只能查看部分信息，执行查询时应按企业安全规范使用具备相应权限的账号。对于服务器、开发机和办公终端，还要注意系统时间是否准确，因为时间偏差可能影响证书校验和通信判断。
验收标准是：命令返回有效信息，Agent 进程正在运行，通信时间能够更新，且日志中没有持续重复的连接或注册错误。常见失败包括命令路径错误、参数不受支持、权限不足以及 Agent 服务没有启动。处理时先执行帮助查询并确认版本，再检查服务状态和日志；如果系统刚完成升级，优先确认旧进程是否残留、服务是否指向正确的安装目录。
第四步：从企业管理控制台核对终端状态
目标是确认“本机认为正常”与“管理平台实际收到数据”是否一致。登录企业使用的安全管理控制台，进入设备、系统或终端资产相关页面，通过设备名称、登录用户、序列号或其他已知标识找到目标终端。不同企业可能使用 McAfee ePO、Trellix 管理平台或集成后的其他控制台，菜单名称和状态字段会有所不同，因此应以本单位管理员提供的入口和字段定义为准。
重点核对终端是否仍被纳入管理、最近一次 Agent 通信时间、上报的 Agent 版本、策略应用时间、威胁或任务状态，以及设备是否被标记为失联、重复注册或待处理。控制台显示在线，不一定代表本机每项安全策略都已成功应用；反过来，本机服务运行也不代表数据已经成功上传到服务器。
验收标准是：控制台中的设备身份与本机一致，最近通信时间在企业规定范围内，Agent 版本和策略状态符合要求，且没有重复设备或长期失联标记。常见失败是本机正常但控制台长时间不更新，这时应检查终端到管理服务器的网络路径、代理服务器设置、DNS、时间同步和防火墙规则，并查看 Agent 日志。若控制台出现多个同名设备，应通过唯一设备标识和最近通信时间区分，避免对错误终端下发策略。
第五步：执行通信验证并判断结果
目标是判断问题究竟出在本机服务、网络链路还是管理平台。确认基础状态后，可按照企业操作规范使用 Agent 自带的检查通信、唤醒或策略更新功能。部分版本提供用于触发通信或策略执行的 cmdagent 参数，但参数名称和行为可能随版本变化，必须先查看本机帮助信息或企业运维文档。执行前应记录当前状态和最近通信时间，执行后再比较是否发生更新。
验收标准是：操作后日志出现新的通信或策略处理记录，控制台的最近通信时间能够按预期更新，策略版本或应用时间发生变化，并且没有新增错误。若通信触发后仍无变化，先不要连续循环执行，因为这可能造成日志噪声，也不能修复证书、网络或注册问题。应根据错误信息分层判断：服务未运行先修服务；无法解析地址先查 DNS；连接超时查防火墙和代理；证书或身份错误查系统时间、证书链和设备注册关系；控制台任务排队则检查管理服务器端任务状态。
常见问题与处理边界
“服务正在运行，为什么控制台仍显示离线？”服务运行只说明本地进程存在，不能证明通信成功。应以 Agent 日志和控制台最近通信时间为准，继续检查网络出口、代理配置、管理服务器地址、DNS、防火墙及证书。
“cmdagent -s 没有结果或提示参数错误怎么办？”先确认调用的是本机实际安装版本的 cmdagent，再执行帮助参数查看支持的选项。不同版本不能只凭网络文章中的示例判断；若企业部署脚本已有固定查询命令，应优先采用脚本中的版本适配方式。
“重新安装 Agent 前需要注意什么？”重新安装可能改变设备注册关系、生成新的标识，甚至造成控制台出现重复资产。应先保存设备名称、当前 Agent 版本、错误日志和控制台记录，并确认企业管理员允许重新部署，再选择修复、重新注册或卸载重装方案。
“如何判断状态检查已经完成？”不要只看一个字段。至少要同时满足本机服务运行、状态命令能返回信息、最近通信时间合理、控制台设备身份匹配、策略或版本状态符合要求这几个条件。任何一项不一致，都应保留证据后继续定位。
检查清单
完成后确认：已核对操作系统和 Agent 版本；已确认服务或进程正在运行；已通过本机命令或对应工具查看状态；已记录最近通信、版本和错误信息；已在企业控制台确认设备身份与在线状态；已核对策略应用情况；网络、DNS、代理、防火墙、时间和证书均无明显异常；所有命令输出和设备标识均按企业要求妥善保存。若仍无法判断，应将终端系统、Agent 版本、状态输出摘要、最近通信时间、相关日志时间段和控制台截图一并提供给企业安全管理员，避免只描述“Agent 不在线”而缺少可定位信息。
