本文属于机器翻译版本。若本译文内容与英语原文存在差异，则一律以英文原文为准。
安装程序参数
AWS IoT Greengrass Core 软件包含一个安装程序，用于设置软件并预置 Greengrass 核心设备运行所需的 AWS 资源。该安装程序包含以下参数，您可以指定这些参数来配置安装：
-h,--help-
（可选）显示安装程序的帮助信息。
--version-
（可选）显示 AWS IoT Greengrass Core 软件的版本。
-Droot-
（可选）用作 AWS IoT Greengrass Core 软件根目录的文件夹路径。
注意
此参数会设置一个 JVM 属性，因此在运行安装程序时，必须在
-jar前指定该属性。例如，指定java -Droot="。/greengrass/v2默认值：
-
Linux：
~/.greengrass -
Windows：
%USERPROFILE%/.greengrass
-
-ar,--aws-region-
AWS IoT Greengrass Core 软件用来检索或创建其所需 AWS 资源的 AWS 区域。
-p,--provision-
（可选）您可以将此设备注册为 AWS IoT 事物，并预置核心设备所需的 AWS 资源。如果您指定
true，则 AWS IoT Greengrass Core 软件会预置一个 AWS IoT 事物、（可选）一个 AWS IoT 事物组、一个 IAM 角色和一个 AWS IoT 角色别名。默认值：
false -tn,--thing-name-
（可选）您注册为此核心设备的 AWS IoT 事物的名称。如果您的 AWS 账户 中不存在具有该名称的事物，则 AWS IoT Greengrass Core 软件会自行创建。
注意
事物名称不得包含英文冒号 (
:) 字符。必须指定
--provision true才能应用此参数。默认值：
GreengrassV2IotThing_加一个随机 UUID。 -tgn,--thing-group-name-
（可选）您在其中添加此核心设备的 AWS IoT 事物的 AWS IoT 事物组的名称。如果部署以该事物组为目标，则此核心设备在连接到 AWS IoT Greengrass 时会收到该部署。如果您的 AWS 账户 中不存在具有该名称的事物组，则 AWS IoT Greengrass Core 软件会自行创建。
注意
事物组名称不得包含英文冒号 (
:) 字符。必须指定
--provision true才能应用此参数。 -tpn,--thing-policy-name-
此功能适用于 Greengrass Nucleus 组件的 v2.4.0 及更高版本。
（可选）要附加到此核心设备的 AWS IoT 事物证书的 AWS IoT 策略的名称。如果您的 AWS 账户中不存在具有该名称的 AWS IoT 策略，则 AWS IoT Greengrass Core 软件会自行创建。
默认情况下，AWS IoT Greengrass Core 软件会创建宽松的 AWS IoT 策略。您可以缩小此策略的范围，也可以创建自定义策略来限制使用案例的权限。有关更多信息，请参阅AWS IoT Greengrass V2 核心设备的最低 AWS IoT 政策。
必须指定
--provision true才能应用此参数。默认值：
GreengrassV2IoTThingPolicy -trn,--tes-role-name-
（可选）用于获取允许核心设备与 AWS 服务交互的 AWS 凭证的 IAM 角色的名称。如果您的 AWS IoT Greengrass 中不存在具有该名称的角色，则 AWS 账户 Core 软件会使用
GreengrassV2TokenExchangeRoleAccess策略自行创建。此角色无权访问您用于托管组件构件的 S3 存储桶。因此，在创建组件时，您必须为构件的 S3 存储桶和对象添加权限。有关更多信息，请参阅授权核心设备与 AWS 服务交互。必须指定
--provision true才能应用此参数。默认值：
GreengrassV2TokenExchangeRole -tra,--tes-role-alias-name-
（可选）指向为该核心设备提供 AWS 凭证的 IAM 角色的 AWS IoT 角色别名的名称。如果您的 AWS 账户 中不存在具有该名称的角色别名，则 AWS IoT Greengrass Core 软件会自行创建，并将其指向您指定的 IAM 角色。
必须指定
--provision true才能应用此参数。默认值：
GreengrassV2TokenExchangeRoleAlias -ss,--setup-system-service-
（可选）您可以将 AWS IoT Greengrass Core 软件设置为在该设备开机时运行的系统服务。系统服务名称为
greengrass。有关更多信息，请参阅将 Greengrass Nucleus 配置为系统服务。在 Linux 操作系统上，此参数要求设备上具有 systemd 初始化系统。
重要
在 Windows 核心设备上，必须将 AWS IoT Greengrass Core 软件设置为系统服务。
默认值：
false -u,--component-default-user-
AWS IoT Greengrass Core 软件用于运行组件的用户的名称或 ID。例如，您可以指定
ggc_user。在 Windows 操作系统上运行安装程序时，必须使用此值。在 Linux 操作系统上，您还可以选择指定组。指定用户和组，用英文冒号分隔。例如
ggc_user:ggc_group。以下更多注意事项适用于 Linux 操作系统：
-
如果您以根用户身份运行，则默认组件用户是在配置文件中定义的用户。如果配置文件未定义用户，则默认为
ggc_user:ggc_group。如果ggc_user或ggc_group不存在，则软件将自行创建。 -
如果您以非根用户身份运行，则 AWS IoT Greengrass Core 软件会使用该用户来运行组件。
-
如果您未指定组，则 AWS IoT Greengrass Core 软件会使用系统用户的主要组。
有关更多信息，请参阅配置运行组件的用户。
-
-d,--deploy-dev-tools-
（可选）您可以将 Greengrass CLI 组件下载并部署到此核心设备上。您可以使用此工具来开发和调试此核心设备。
重要
我们建议您仅在开发环境中使用此组件，不要在生产环境中使用。此组件允许访问您在生产环境中通常不需要的信息和操作。遵循最低权限原则，将此组件仅部署到有需求的核心设备。
必须指定
--provision true才能应用此参数。默认值：
false -init,--init-config-
（可选）用于安装 AWS IoT Greengrass Core 软件的配置文件的路径。例如，您可以使用此选项来设置具有特定内核配置的新核心设备。
重要
您指定的配置文件与核心设备上现有的配置文件合并。这包括核心设备上的组件和组件配置。我们建议配置文件仅列出您正在尝试更改的配置。
-tp,--trusted-plugin-
（可选）要作为可信插件加载的 JAR 文件的路径。使用此选项提供预置插件 JAR 文件，例如使用实例集预置或自定义预置进行安装，或者使用私有密钥和证书安装在硬件安全模块中。
-s,--start-
（可选）您可以在安装 AWS IoT Greengrass Core 软件后启动该软件，也可以选择预置资源。
默认值：
true
