2.3.3.5 MySQL 安装程序控制台参考

MySQL 8.0 参考手册 / 第 2 章安装和升级 MySQL / 2.3 在 Microsoft Windows 上安装 MySQL / 2.3.3 Windows 版 MySQL 安装程序 / 2.3.3.5 MySQL 安装程序控制台参考

2.3.3.5 MySQL 安装程序控制台参考

MySQLInstallerConsole.exe提供类似于 MySQL Installer 的命令行功能。它在最初执行 MySQL Installer 时安装，然后在 MySQL Installer for Windows目录中可用。默认情况下，C:\Program Files (x86)\MySQL\MySQL Installer for Windows控制台命令必须以管理权限执行。

要使用控制台：

从 “开始”中选择“ Windows 系统”，打开具有管理权限的命令提示符，然后右键单击“命令提示符”，选择“更多”，然后选择“以管理员身份运行”。
从命令行中，可选择将目录更改为MySQLInstallerConsole.exe命令所在的目录。例如，要使用默认安装位置：
```
cd Program Files (x86)\MySQL\MySQL Installer for Windows
```

键入MySQLInstallerConsole.exe（或 mysqlinstallerconsole）后跟执行任务的命令操作。例如，显示控制台的帮助：

MySQLInstallerConsole.exe --help

===================开始初始化===================
MySQL Installer 以社区模式运行

正在尝试更新清单。
初始化产品需求。
正在加载产品目录。
检查捆绑包中的产品包。
分类产品目录。
查找所有已安装的软件包。
您的产品目录最后更新于 23/08/2022 12:41:05 pm
您的产品目录的版本号为 671。
===================结束初始化===================

可以执行以下操作：

配置 - 配置一个或多个已安装的程序。
帮助 - 提供可用命令操作的列表。
安装 - 安装和配置一个或多个可用的 MySQL 程序。
列表 - 列出所有可用的 MySQL 产品。
修改 - 修改已安装产品的功能。
删除 - 从系统中删除一个或多个产品。
设置 - 配置 MySQL 安装程序的常规选项。
状态 - 显示所有已安装产品的状态。
更新 - 更新当前产品目录。
升级 - 升级一个或多个已安装的程序。

使用 MySQL Installer 命令操作的基本语法。括号表示可选实体。
大括号表示可能实体的列表。

...

MySQL 产品名称

许多MySQLInstallerConsole命令操作接受一个或多个可以匹配目录中的 MySQL 产品（或产品）的缩写短语。下表显示了当前用于命令的一组有效短语。

表 2.6 用于 MySQLInstallerConsole.exe 命令的 MySQL 产品短语

短语	MySQL产品
`server`	MySQL服务器
`workbench`	MySQL 工作台
`shell`	MySQL外壳
`visual`	用于 Visual Studio 的 MySQL
`router`	路由器
`backup`	MySQL Enterprise Backup（需要商业版）
`net`	MySQL连接器/网络
`odbc`	MySQL 连接器/ODBC
`c++`	MySQL 连接器/C++
`python`	MySQL 连接器/Python
`j`	MySQL连接器/J
`documentation`	MySQL 服务器文档
`samples`	MySQL 示例（sakila 和 world 数据库）

命令语法

可以使用或不使用文件扩展名 ( ) 发出MySQLInstallerConsole.exe命令，并且该.exe命令不区分大小写。

mysqlinstallerconsole[ .exe] [[[ --] action] [ action_blocks_list] [ options_list]]

描述：

action

允许的操作之一。如果省略，则默认操作等同于 --status操作。使用 --前缀对于所有操作都是可选的。

可能的操作有：[--] configure、[--] help、[--] install、[--] list、[--] modify、[--] remove、[--] set、[--] status、[--]update和[--] upgrade。

action_blocks_list

块列表，其中每个块代表不同的项目，具体取决于所选操作。块以逗号分隔。

和操作允许指定星号字符 ( --remove) 来指示所有产品。如果在该块的开头检测到该字符，则假定要处理所有产品并且忽略该块的其余部分。 --upgrade**

句法： *|action_block[,action_block][,action_block]...

action_block：包含一个产品选择器，后跟不定数量的参数块，这些参数块的行为取决于所选操作（请参阅命令操作）。

options_list

零个或多个选项，可能的值由空格分隔。请参阅命令操作以确定相应操作允许的选项。

句法： option_value_pair[ option_value_pair][ option_value_pair]...

option_value_pair：单个选项（例如，--silent）或键的元组和带有选项前缀的相应值。键值对的形式为 . --key[=value]

命令动作

MySQLInstallerConsole.exe支持以下命令操作：

笔记

包含冒号字符 ( ) 的配置块（或 arguments_block: ）值必须用引号引起来。例如， install_dir="C:\MySQL\MySQL Server 8.0"。

[--]configure [product1]:[configuration_argument]=[value], [product2]:[configuration_argument]=[value], [...]
在您的系统上配置一个或多个 MySQL 产品。可以为每个产品配置多个 configuration_argument=对。value
选项：

--continue
在处理包含每个产品参数的操作块时，如果发现错误，则继续处理下一个产品。如果未指定，则在出现错误时中止整个操作。
--help
显示相应操作的选项和可用参数。如果存在，则不执行操作，仅显示帮助，因此也会忽略其他与操作相关的选项。
--show-settings
通过在之后传入产品名称来显示所选产品的可用选项 --show-settings。

--silent
禁用确认提示。

例子：
```
MySQLInstallerConsole --configure --show-settings server
```
```
mysqlinstallerconsole.exe --configure server:port=3307
```
[--]help
显示带有用法示例的帮助消息，然后退出。传递额外的命令操作以接收特定于该操作的帮助。
选项：

--action=[action]
显示特定操作的帮助。与将--help选项与操作一起使用相同。
允许的值为：all、 configure、help （默认值）、install、 list、modify、 remove、status、 update、upgrade和set。
--help
显示相应操作的选项和可用参数。如果存在，则不执行操作，仅显示帮助，因此也会忽略其他与操作相关的选项。

例子：
```
MySQLInstallerConsole help
```
```
MySQLInstallerConsole help --action=install
```
[--]install [product1]:[features]:[config block]:[config block], [product2]:[config block], [...]
在您的系统上安装一个或多个 MySQL 产品。如果有预释放产品可用，则当 --type期权值的值为Developer和Client或 Full。使用这些设置类型时，使用该 --only_ga_products选项将产品集限制为 GA 产品。
描述：

[product]
每个产品都可以由带有或不带有分号分隔的版本限定符的产品短语指定。单独传入产品关键字会选择产品的最新版本。如果多个体系结构可用于该版本的产品，该命令将返回清单列表中的第一个体系结构以进行交互确认。或者，您可以使用该选项在产品关键字之后传入确切的版本和体系结构(x86或 ) 。x64--silent

[features]
默认安装与 MySQL 产品相关的所有功能。功能块是以分号分隔的功能列表或*选择所有功能的星号字符 ( )。要删除功能，请使用 modify命令。

[config block]
可以指定一个或多个配置块。每个配置块都是一个以分号分隔的键值对列表。块可以包含 a config或user type 键；config如果未定义，则为默认类型。
包含冒号字符 ( :) 的配置块值必须用引号引起来。例如， installdir="C:\MySQL\MySQL Server 8.0"。每个产品只能定义一个配置类型块。应为每个要在产品安装期间创建的用户定义一个用户块。

笔记

user重新配置产品时不支持类型密钥。

选项：

--auto-handle-prereqs
如果存在，MySQL Installer 会尝试下载并安装一些当前不存在的必备软件。这可以通过最少的干预来解决。如果该 --silent选项不存在，您将看到每个先决条件的安装页面。如果 --auto-handle-prereqs省略选项，则不会安装缺少先决条件的包。
--continue
在处理包含每个产品参数的操作块时，如果发现错误，则继续处理下一个产品。如果未指定，则在出现错误时中止整个操作。
--help
显示相应操作的选项和可用参数。如果存在，则不执行操作，仅显示帮助，因此也会忽略其他与操作相关的选项。
--mos-password=password
为 MySQL 安装程序的商业版本设置 My Oracle Support (MOS) 用户的密码。
--mos-user=user_name
指定用于访问商业版 MySQL 安装程序的 My Oracle Support (MOS) 用户名。如果不存在，则只有捆绑包中的产品（如果有）可供安装。
--only-ga-products
将产品集限制为仅包含 GA 产品。
--setup-type=setup_type
安装一组预定义的软件。安装类型可以是以下之一：
Developer：安装完整的开发环境。
Server：安装单个 MySQL 服务器
Client：安装客户端程序和库
Full: 安装一切
Custom：安装用户选择的产品。这是默认选项。
笔记

非自定义安装类型仅在未安装其他 MySQL 产品时有效。
--show-settings
通过在之后传入产品名称，显示所选产品的可用选项 -showsettings。

--silent
禁用确认提示。

例子：
```
mysqlinstallerconsole.exe --install j;8.0.29, net;8.0.28 --silent
```
```
MySQLInstallerConsole install server;8.0.30:*:port=3307;server_id=2:type=user;user=foo
```
传入额外配置块的示例，^以适合分隔：
```
MySQLInstallerConsole --install server;8.0.30;x64:*:type=config;open_win_firewall=true; ^
   general_log=true;bin_log=true;server_id=3306;tcp_ip=true;port=3306;root_passwd=pass; ^
   install_dir="C:\MySQL\MySQL Server 8.0":type=user;user_name=foo;password=bar;role=DBManager
```
[--]list
当不带选项使用此操作时，它会激活一个交互式列表，从中可以搜索所有可用的 MySQL 产品。输入 MySQLInstallerConsole --list并指定要搜索的子字符串。
选项：

--all
列出所有可用的产品。如果使用此选项，将忽略所有其他选项。
--arch=architecture
包含指定架构的列表。允许的值为：x86、 x64和any （默认值）。该选项可以与 --name和 --version选项结合使用。
--help
显示相应操作的选项和可用参数。如果存在，则不执行操作，仅显示帮助，因此也会忽略其他与操作相关的选项。
--name=package_name
列出包含指定名称的产品（参见产品词组），该选项可以与 --version和 --arch选项结合使用。
--version=version
列出包含指定版本的产品，例如 8.0 或 5.7。该选项可以与--name和 --arch选项结合使用。

例子：
```
MySQLInstallerConsole --list --name=net --version=8.0
```
[--]modify [product1:-removelist|+addlist], [product2:-removelist|+addlist] [...]
修改或显示以前安装的 MySQL 产品的功能。要显示产品的特性，请在命令后附加产品关键字，例如：
```
MySQLInstallerConsole --modify server
```
选项：

--help
显示相应操作的选项和可用参数。如果存在，则不执行操作，仅显示帮助，因此也会忽略其他与操作相关的选项。
--silent
禁用确认提示。

例子：
```
MySQLInstallerConsole --modify server:+documentation
```
```
MySQLInstallerConsole modify server:-debug
```
[--]remove [product1], [product2] [...]
从您的系统中删除一种或多种产品。*可以传入星号（），一条命令删除所有MySQL产品。
选项：

--continue
即使发生错误，也要继续操作。
--help
显示相应操作的选项和可用参数。如果存在，则不执行操作，仅显示帮助，因此也会忽略其他与操作相关的选项。
--keep-datadir
删除 MySQL 服务器产品时跳过数据目录的删除。
--silent
禁用确认提示。

例子：
```
mysqlinstallerconsole.exe remove *
```
```
MySQLInstallerConsole --remove server --continue
```
[--]set
设置一个或多个可配置选项，这些选项会影响 MySQL Installer 程序如何连接到 Internet 以及是否激活自动产品目录更新功能。
选项：

--catalog-update=bool_value
启用（true，默认）或禁用（false）自动产品目录更新。此选项需要有效连接到互联网。
--catalog-update-days=int_value
接受 1（默认值）和 365 之间的整数，以指示启动 MySQL 安装程序时检查新目录更新之间的天数。如果 --catalog-update是 false，则忽略此选项。
--connection-validation=validation_type
设置 MySQL 安装程序如何执行互联网连接检查。允许的值为 automatic(default) 和 manual.
--connection-validation-urls=url_list
一个双引号括起来并以逗号分隔的字符串，它定义了 URL 列表，用于在 --connection-validation设置为时检查 Internet 连接manual。按照提供的相同顺序进行检查。如果第一个 URL 失败，则使用列表中的下一个 URL，依此类推。
--reset-defaults
将与操作关联的 MySQL 安装程序选项重置为 --set默认值。

例子：
```
MySQLIntallerConsole.exe set --reset-defaults
```
```
mysqlintallerconsole.exe --set --catalog-update=false
```
```
MySQLIntallerConsole --set --catalog-update-days=3
```
```
mysqlintallerconsole --set --connection-validation=manual 
--connection-validation-urls="https://www.bing.com,http://www.google.com"
```
[--]status
提供系统上安装的 MySQL 产品的快速概览。信息包括产品名称和版本、体系结构、安装日期和安装位置。
选项：

--help
显示相应操作的选项和可用参数。如果存在，则不执行操作，仅显示帮助，因此也会忽略其他与操作相关的选项。

例子：
```
MySQLInstallerConsole status
```
[--]update
将最新的 MySQL 产品目录下载到您的系统。成功后，目录将在下次执行MySQLInstaller或执行MySQLInstallerConsole.exe时应用。
n如果自上次检查以来已经过去了几天，MySQL Installer 在启动时会自动检查产品目录更新。从 MySQL Installer 1.6.4 开始，默认值为 1 天。以前，默认值为 7 天。
选项：

--help
显示相应操作的选项和可用参数。如果存在，则不执行操作，仅显示帮助，因此也会忽略其他与操作相关的选项。

例子：
```
MySQLInstallerConsole update
```
[--]upgrade [product1:version], [product2:version] [...]
升级系统上的一个或多个产品。此操作允许使用以下字符：

*
传入*将所有产品升级到最新版本，或传入特定产品。
!
!作为版本号传入以将 MySQL 产品升级到其最新版本。

选项：

--continue
即使发生错误，也要继续操作。
--help
显示相应操作的选项和可用参数。如果存在，则不执行操作，仅显示帮助，因此也会忽略其他与操作相关的选项。
--mos-password=password
为 MySQL 安装程序的商业版本设置 My Oracle Support (MOS) 用户的密码。
--mos-user=user_name
指定用于访问商业版 MySQL 安装程序的 My Oracle Support (MOS) 用户名。如果不存在，则只有捆绑包中的产品（如果有）可供安装。
--silent
禁用确认提示。

例子：
```
MySQLInstallerConsole upgrade *
```
```
MySQLInstallerConsole upgrade workbench:8.0.31
```
```
MySQLInstallerConsole upgrade workbench:!
```
```
MySQLInstallerConsole --upgrade server;8.0.30:!, j;8.0.29:!
```