cchurch.win_vipre

概述版本洞察

Win-VIPRE

在Windows上管理VIPRE商业病毒防护服务器。支持备份、恢复、安装、更新和卸载VIPRE商业、商业高级版或端点安全。

角色变量

下面粗体显示的变量是通常用于配置角色的变量；其他变量用于高级用法。角色的步骤始终按以下顺序执行：

备份（当vipre_backup为true时）
卸载（当vipre_uninstall为true时）
安装（当vipre_install为true时）
恢复（当vipre_restore为true时）

如果不将vipre_backup、vipre_restore、vipre_install或vipre_uninstall中至少一个设置为true，则角色只会检查VIPRE是否已安装。

使用以下变量指定要管理的VIPRE产品和版本。这些变量会影响该角色的安装和卸载步骤：

**vipre_product**：VIPRE商业产品，应为 "standard"、"premium" 或 "endpoint" 之一，默认值为 "standard"。
**vipre_version**：要安装、升级或卸载的VIPRE商业版本。有效值为"latest"、"11.0"和"10.0"（仅限"endpoint"）， "10.1"（适用于"standard"和"premium"），以及 "9.6"、"9.5" 和 "9.3" （适用于任何产品）；默认值为 "latest"。
vipre_regkey_name：指定VIPRE注册表键的备用路径组件，通常仅在使用自定义 vipre_download_url 或 vipre_product_id 时需要旧版本。默认值为 "VIPRE Business"。
vipre_datadir_name：指定VIPRE数据目录的备用路径组件，通常仅在使用自定义 vipre_download_url 或 vipre_product_id 时需要旧版本。默认值为 "VIPRE Business"。

要备份VIPRE数据库（仅限内部SQLite数据库，不支持SQL Server），请使用以下变量：

**vipre_backup**：设置为true以启用以下各种备份选项，默认值为false。
vipre_backup_remote：将数据库备份到远程系统的目的地，默认值为true。
vipre_backup_remote_path：存储数据库备份的远程路径。默认值为""，使用完整的数据库文件名并附加vipre_backup_suffix。
vipre_backup_local：将数据库备份到本地（控制）系统的目的地，默认值为false。
vipre_backup_local_path：存储数据库备份的本地路径。默认值为""，使用当前目录（playbook_dir）和数据库文件名，并附加vipre_backup_suffix。
vipre_backup_suffix：附加到数据库备份文件名的后缀，默认值为ansible_date_time.iso8601_basic_short，将附加时间戳。
vipre_backup_ini：将VIPRE站点GUID和注册代码备份到INI文件中，与数据库备份一起，默认值为true。INI文件名将与数据库备份文件名相同，仅附加.ini。

对于卸载，可以使用以下变量：

vipre_uninstall：设置为true以卸载VIPRE商业并启用以下各种卸载选项，默认值为false。
vipre_uninstall_product：指定要卸载的VIPRE产品，默认值为vipre_product。
vipre_uninstall_version：指定要卸载的VIPRE版本，默认值为vipre_version。
vipre_uninstall_product_id：指定要卸载的备用产品GUID，默认值基于vipre_uninstall_product和vipre_uninstall_version。
vipre_uninstall_registry：设置为true以删除所有VIPRE商业注册表键，默认值为false。
vipre_uninstall_data：设置为true以删除所有VIPRE商业数据文件（通常在%ProgramData%中），默认值为false。

对于安装，可以使用以下变量：

**vipre_install**：设置为true以安装或升级VIPRE商业，默认值为false。如果下载的版本低于已安装版本，将进行升级。
vipre_force_install：设置为true以强制安装，即使已安装版本小于或等于下载版本，默认值为false。
vipre_download_url：指定VIPRE安装程序的备用下载URL，默认基于vipre_version和vipre_product。
vipre_product_id：指定将要安装的产品GUID，默认基于vipre_version和vipre_product。

要从备份中恢复VIPRE内部SQLite数据库，请使用以下变量：

**vipre_restore**：设置为true以启用以下各种恢复选项。
**vipre_restore_remote**：从远程系统的备份文件恢复数据库，默认值为false。如果设置为true，则vipre_restore_local必须为false。
**vipre_restore_remote_path**：数据库文件的远程路径；如果vipre_restore_remote为true，则必须提供。
vipre_restore_local：从本地（控制）系统的备份文件恢复数据库，默认值为false。如果设置为true，vipre_restore_remote必须为false。
vipre_restore_local_path：数据库文件的本地路径；如果vipre_restore_local为true，则必须提供。
**vipre_restore_site_guid**：指定要恢复到注册表的站点GUID值；默认值为""，表示不恢复站点GUID。
vipre_restore_reg_code：指定要恢复到注册表的注册代码值；默认值为""，表示不恢复注册代码。此选项仅更新注册表，因此如果数据库不匹配，可能会被覆盖。
vipre_restore_post_install_wizard：设置一个注册表键，表示已运行后安装向导；默认值为true。

示例剧本

以下示例剧本在角色的第一次调用中安装旧版本的VIPRE商业高级版，然后在第二次调用中进行备份并升级到最新版本：

- hosts: vipre
  vars:
    vipre_product: premium
  roles:
    - role: cchurch.vipre
      vipre_version: 10.1
      vipre_install: true
    - role: cchurch.vipre
      vipre_backup: true
      vipre_install: true