跳至主内容

使用命令行界面

Bitdefender端点安全工具 允许您通过产品控制台(位于Windows终端安装目录中的命令行界面)自动运行本地按需扫描任务和更新。

BEST 命令行界面有两种工作模式:

  • 批量执行多命令 。此模式使用独立命令行界面,可持续输入命令并获取结果直至退出。

    进入此模式的方法:

    1. 前往 c:\ProgramFiles\Bitdefender\EndpointSecurity BEST 的安装目录。

    2. 找到并双击 product.console 可执行文件。命令行界面随即打开。

    3. 执行所需命令。

      示例:

      GetVersion antivirus

      返回结果表示反恶意软件特征库的版本号。

    4. 执行 exit 以关闭命令行界面。

      product-console-interactive.png
  • 单次命令模式 。此模式使用命令提示符,命令执行后返回系统提示符。

    进入此模式的方法:

    1. 打开命令提示符( cmd.exe ).

    2. 使用 cd 命令切换到 BEST .

    3. 执行所需命令。

      示例:

      • C:\Program Files\Bitdefender\Endpoint Security > product.console.exe /c StartUpdate
    4. 若命令成功执行,返回结果为 error0 .

      product-console-cmd.png

支持的命令

命令行界面支持多种命令,部分命令需配合参数才能返回有效结果。

本节所有示例均使用 BEST .

注意

产品控制台命令不区分大小写。

GetUpdateStatusproduct|antivirus

获取最新更新的相关信息。

此命令需要以下参数之一:

  • product – 指 BEST 版本。

  • antivirus – 指反恶意软件签名版本。

示例:

getupdatestatus_product_antivirus.png

GetVersionproduct|antivirus

获取产品当前版本信息。

此命令需要以下参数之一:

  • product – 指 BEST 版本。

  • antivirus – 指反恶意软件签名版本。

示例:

getversion_product_antivirus.png

IsUpdateInProgress

验证产品更新是否正在进行。

输出值:

  • true - 表示产品更新正在进行。

  • false - 当前没有产品更新正在进行。

示例:

update_in_progress.png

IsUpdateRestartNeeded

验证终端在更新后是否需要系统重启。

输出值:

  • true - 该终端在更新后需要系统重启。

  • false - 该终端在更新后不需要系统重启。

示例:

restart_needed.png

StartUpdate

启动更新并获取结果,无需等待任务完成。

示例:

StartUpdate

输出格式: error0 (命令已成功执行)。

start_update.png

StartUpdate-force

覆盖产品更新设置并启动强制更新流程。该命令会返回错误代码。

注意

此命令需要管理员权限。

FileScan.OnDemand.RunScanTaskcustom[选项]

启动按需扫描并显示扫描日志路径及扫描摘要。

此命令需要参数 custom ,随后可根据需要添加一个或多个选项。例如:

scan_task_custom.png

通过选项可自定义扫描任务。这些选项为非必选参数。

每个选项有两个或更多可用值,但只能选用其中一个值。

FileScan.OnDemand.RunScanTask 命令未指定任何选项时,自定义扫描将采用该选项的默认值。

例如,若运行此命令时未提及 scanKeyloggers 选项,则表示 BEST 仍会根据 scanKeyloggers 的默认值( true ).

注意

不存在针对 快速扫描 全盘扫描 的专用命令。但您可根据需要配置 FileScan.OnDemand.RunScanTask ,仅扫描操作系统位置或启用所有选项扫描整个系统。

选项

这些选项可替代 BEST 控制台中的可用选项。更多信息请参阅 配置并运行自定义扫描 .

注意

所有 [选项] 参数均区分大小写。

path="<路径>"

输入扫描目标位置的路径。多个路径请使用: path="<路径1>"path="<路径2>" .

示例:

FileScan.OnDemand.RunScanTask custom path="C:\Program Files"
scan_path.png

useExclusions=true|false

此选项允许您使用或忽略排除项。

默认值: true

useExclusions_35979_en.png

cpuUsage=high|medium|low

此选项允许您限制扫描时的CPU占用率。

默认值: high

cpuUsage_35979_en.png

infectedAction1=ignore|disinfect|disinfectOnly|delete|quarantine

选择检测到感染文件时的第一项操作:忽略、清除、仅清除、删除或移至隔离区。此操作可与 infectedAction2 .

默认值: disinfect

示例:

infected_action1_ignore.png

infectedAction2=ignore|disinfect|disinfectOnly|delete|quarantine

选择检测到感染文件时的第二项操作。当第一项操作失败时执行此操作。

默认值: quarantine

示例:

infected_action2_quarantine.png

suspiciousAction1=ignore|delete|quarantine

选择检测到可疑文件时的第一项操作。此操作可与 suspiciousAction2 .

默认值: 忽略

示例:

suspicious_action1_quarantine.png

suspiciousAction2=忽略|删除|隔离

检测到可疑文件时采取的第二个动作。当第一个动作失败时应用此动作。

默认值: 忽略

示例:

suspicious_action2_delete.png

scanBootSectors=是|否

扫描硬盘的引导扇区。

默认值:

示例:

scan_bootsectors.png

scanRegistry=是|否

扫描终端上的注册表键值。

默认值:

示例:

scan_registry.png

scanMemory=是|否

扫描系统内存中运行的程序。

默认值:

示例:

scan_memory.png

smartScan=是|否

仅扫描新增和变更的文件。

默认值:

示例:

scan_smart.png

scanRootKits=是|否

扫描rootkit及使用它们的隐藏对象。

默认值: false

示例:

scan_rootkits.png

scanKeyloggers=true|false

扫描键盘记录软件。

默认值: true

示例:

scan_keyloggers.png

scanPUA=true|false

扫描潜在有害应用程序(PUA)。

默认值: false

示例:

scan_pua.png

scanArchives=true|false

扫描存档文件中的受感染文件。

默认值: true

示例:

scan_archives.png

extensionType=all|application|custom|none

根据文件扩展名扫描文件:所有文件、仅可执行文件、仅具有指定扩展名的文件,或不扫描任何文件。

默认值: all

示例:

extension_type.png

customExt="<字符串>"

此选项可帮助您仅扫描具有指定扩展名的文件。需要输入一个字符串,列出所需的扩展名,并用竖线分隔。例如, "|exe|ini|txt|" 。此选项仅在同时使用 extensionType=custom .

示例:

custom_ext.png

lowPriority=true|false

以低优先级运行任务。

默认值: false

示例:

low_priority.png

命令行错误代码

命令行工具可能返回以下错误代码:

错误代码

描述

0

命令执行成功

87

参数无效

160

参数错误

1552

StartUpdate 任务已在执行时会出现此错误。

1627

函数执行失败——执行命令时发生错误。

1639

无效命令——若功能未正确编写或未在终端安装, 高级用户 CLI会报此错误。