---
title: 代理 UI
slug: neurons/help/zh_cn/ui
createdAt: 2026-09-07T07:01:35.224Z
---

在 Windows 设备上，Ivanti Neurons 代理用户界面可帮助最终用户保护他们的计算机。 此界面可以显示 Ivanti Neurons 代理的状态并允许最终用户执行管理员配置的操作。

除了代理 UI 之外，可以使用所有操作系统上的 stagentctl 命令行实用程序来控制代理。 有关更多信息，请参阅 [stagentctl 命令行实用程序](docId\:dD-OoozN-o_-BG1IAzjNP)。

代理 UI 是 Ivanti Neurons 代理的一项功能。 要在代理端点上安装此功能，请在[代理策略](docId:6WXR2KmystrghED4NReMh)中启用**代理 UI** 功能。

:::hint{type="info"}
.Net v8 已安装在端点上，是代理 UI 的必要组件。
:::

## 访问代理 UI

您或您的最终用户可以在目标设备上通过两种方式访问 Ivanti Neurons 代理 UI：

- 选择**开始 > Ivanti Neurons 代理 > Ivanti Neurons Cloud 代理**
- 双击以下可执行文件：
  `C:\Program Files\Ivanti\Ivanti Cloud Agent\STUILauncher.exe`

## 如何操作代理 UI

操作代理 UI 很简单。 从主页开始，这是所有操作的起点。 主页包含许多不同的磁贴。 点击任意磁贴可查看关联数据和执行关联任务。

:::hint{type="success"}
如果您在代理 UI 进行软件更新时偶然启动该程序，则会显示该程序的受限版本。 如果发生这种情况，请等待一两分钟，然后重新启动程序即可。
:::

## “代理控制”磁贴

“代理控制”磁贴始终是主页的第一个磁贴。 该磁贴显示有关代理的一般信息，包括：

- **已连接到：**&#x4EE3;理连接到的 Ivanti Neurons 租户的 URL。
- **策略：**&#x5DF2;分配给此代理的代理策略的 ID。
- **上次签入：**&#x6B64;代理上次签入 Ivanti Neurons 的日期和时间。
- **代理版本：**&#x4EE3;理软件的版本。
- **SDK 版本**：代理框架和引擎构建组件的版本。

### 如何查看代理日志和执行操作

通过点击“代理控制”磁贴，可查看代理日志和执行多项操作。 代理日志中显示的消息为系统级消息，仅供参考。 无需针对这些消息采取任何操作。

系统会显示以下按钮：

- **主页：**&#x8FD4;回主页。
- **签入：**&#x6307;示代理签入 Ivanti Neurons 并下载所有策略更改。 最终用户通常不需要使用此按钮，除非管理员有所指示。
- **更新二进制文件：**&#x6307;示代理下载最新的扫描引擎和数据文件。 最终用户通常不需要使用此按钮，除非管理员有所指示。
- **清除系统日志：**&#x6E05;除日志文件中的所有信息。

## “修补程序引擎”磁贴

您可以使用“修补程序引擎”磁贴执行以下任务：

- 执行定期扫描以检测所有缺失的修补程序和产品等级
  以下任何修补或系统事件都会自动触发修补程序扫描：
  - 紧接着修补程序部署前后
  - 在为部署[暂存修补程序内容](docId\:uqe71wOem0hd8OaGqzoLK)之前
  - 每天（如果前两次触发事件均未发生）
  - 重新启动计算机（如果已错过三天的频率）

也可手动启动修补程序扫描，方法是使用代理客户端程序或者从命令提示符发出代理命令。

:::ExpandableHeading
## 代理命令

可以使用 stagentctl 命令行实用程序来控制代理。 通过显示内置帮助信息，即可了解实用程序。

1. 在代理计算机上打开管理员命令提示符。
2. 更改为 `C:\Program Files\Ivanti\Ivanti Cloud Agent` 目录。
3. 显示 stagentctl 实用程序的帮助信息。
   `stagentctl`
:::

- 部署任何缺失的修补程序和产品等级，以修复软件中的安全漏洞

“修补程序引擎”磁贴显示在最近的修补程序扫描中检测到的缺失产品等级和修补程序的数量。

:::hint{type="info"}
如果修补程序配置未与代理策略中的“修补程序管理”功能关联，则不会显示“修补程序引擎”磁贴。
:::

### 如何查看可用任务和执行操作

通过点击“修补程序引擎”磁贴，可查看经配置可供使用的修补程序任务。 每个可用的修补程序任务都有一个对应的日志文件。 每个日志都包含与该任务最近执行的操作相关的状态消息。 提供了关于修补程序下载、安装、成功和失败的详细信息。 此处可能会列出若干可供选择的任务，具体取决于您配置[修补程序配置](docId\:uqe71wOem0hd8OaGqzoLK)的方式。

系统会显示以下按钮：

- **主页：**&#x8FD4;回主页。
- **开始任务：**&#x70B9;击任务名称后，对应的任务将开始在计算机上执行。 系统会使用为该修补程序任务配置的唯一选项来执行任务。
  修补程序任务将扫描计算机中缺少的软件修补程序和产品等级。 扫描将在后台运行，使您能够在执行扫描时继续工作。 扫描结果将报告给 Ivanti Neurons。 任务日志中将显示扫描记录。
  如果扫描检测到一个或多个缺失的修补程序，则系统可能会自动部署该修补程序，具体取决于您配置修补程序任务的方式。 修补程序部署（如果发生）将报告给 Ivanti Neurons。 任务日志中将显示部署记录。
  有关您或您的最终用户是否应手动执行修补程序任务的建议，请参阅企业安全策略。 例如，某些组织可能需要每 30 天执行一次修补程序任务，或者可能需要对长时间断电或断开网络连接的计算机执行修补任务。 其他组织可能需要定期执行计划的修补程序任务，并且可能禁止执行手动修补程序任务。
- **停止任务：**&#x505C;止当前正在进行的修补程序任务。 每当您停止一项任务，日志中都会记录一条消息。 如果没有活动任务，则该按钮将会禁用。
- **重置重试计数：**&#x91CD;置所有修补程序计数器。 对于程序尝试下载的每一个修补程序和程序尝试安装的每一个修补程序，都存在一个唯一的修补程序计数器。 每当修补程序下载失败或修补程序安装失败，修补程序计数器都会增加。 失败的下载和安装尝试将记录在修补程序日志中。 如果修补程序在 10 次尝试后仍无法下载或无法安装，则客户端程序将停止尝试部署特定修补程序（Windows：单个修补周期最多三次，单个端点最多五次。 Mac：最多三次。 Linux：不重试）。 唯一能继续部署该修补程序的方法是点击**重置重试计数**。
- **更新修补程序数据：**&#x6307;示代理签入 Ivanti Neurons 并下载最新的修补程序数据。 最终用户通常不需要使用此按钮，除非管理员有所指示。

## stagentctl 命令行实用程序

stagentctl 命令行实用程序支持控制所有操作系统上的代理。 要使用 stagentctl，请在代理计算机上打开管理员命令提示符并导航到相应的目录：

- **Windows**：`C:\Program Files\Ivanti\Ivanti Cloud Agent\`
- **Mac**：`/usr/local/com.ivanti.cloud.agent/IvantiAgent/bin/`
- **Linux**：`opt/ivanti/cloudagent/bin/`

要查看带有帮助文本的可用命令列表，请输入 `stagentctl`。

:::hint{type="success"}
命令 `stagentctl available-tasks` 会列出可用的任务以及操作系统特定任务的索引。 接下来，可以使用索引 1 运行任务，例如使用 `stagentctl dispatch --index 1`。
:::

### 相关主题

[代理策略](docId:6WXR2KmystrghED4NReMh)

[代理部署](docId\:HUqXH3gqevyB2cGIKs3Wc)
