安装程序参数 - Amazon IoT Greengrass
Amazon Web Services 文档中描述的 Amazon Web Services 服务或功能可能因区域而异。要查看适用于中国区域的差异，请参阅 中国的 Amazon Web Services 服务入门 (PDF)。

本文属于机器翻译版本。若本译文内容与英语原文存在差异，则一律以英文原文为准。

安装程序参数

Amazon IoT GreengrassCore 软件包括一个安装程序，用于设置软件并配置 Greengrass 核心设备运行所需的Amazon资源。安装程序包含以下参数，您可以指定这些参数来配置安装：

-h, --help

（可选）显示安装程序的帮助信息。

--version

（可选）显示Amazon IoT Greengrass核心软件的版本。

-Droot

（可选）用作Amazon IoT Greengrass核心软件根目录的文件夹路径。

注意

此参数设置 JVM 属性，因此您必须在运行安装程序之前-jar指定该属性。例如，指定 java -Droot="/greengrass/v2" -jar /path/to/Greengrass.jar。

默认值：

  • Linux：~/.greengrass

  • Windows：%USERPROFILE%/.greengrass

-ar, --aws-region

Amazon IoT Greengrass核心软件用来检索或创建其所需Amazon资源的。Amazon Web Services 区域

-p, --provision

（可选）您可以将此设备注册为Amazon IoT事物，并配置核心设备所需的Amazon资源。如果您指定true，则Amazon IoT Greengrass核心软件会预置一个Amazon IoT事物、（可选）一个Amazon IoT事物组、一个 IAM 角色和一个Amazon IoT角色别名。

默认值：false

-tn, --thing-name

（可选）您注册为该核心设备的设备名称。Amazon IoT如果你的名字中不存在这个名字Amazon Web Services 账户，那么 Amazon IoT Greengrass Core 软件就会创建它。

注意

事物名称不能包含冒号 (:) 字符。

必须指定--provision true才能应用此参数。

默认：GreengrassV2IotThing_加上一个随机的 UUID。

-tgn, --thing-group-name

（可选）您在其中添加此核心设备Amazon IoT的事Amazon IoT物组的名称。如果部署以该事物组为目标，则该核心设备在连接到时会收到该部署Amazon IoT Greengrass。如果您中不存在具有此名称的事物组Amazon Web Services 账户，则 Amazon IoT Greengrass Core 软件会创建它。

注意

事物组名称不能包含冒号 (:) 字符。

必须指定--provision true才能应用此参数。

-tpn, --thing-policy-name

此功能适用于 Greengrass nucleus 组件的 v2.4.0 及更高版本。

（可选）要附加到该核心设备Amazon IoT的事物证书的Amazon IoT策略名称。如果您的Amazon IoT策略中不存在带有此名称的策略Amazon Web Services 账户，则由 Amazon IoT Greengrass Core 软件创建该策略。

默认情况下，Amazon IoT GreengrassCore 软件会创建宽松Amazon IoT策略。您可以缩小此策略的范围，也可以创建自定义策略来限制用例的权限。有关更多信息，请参阅 Amazon IoT Greengrass V2核心设备的最低Amazon IoT政策。

必须指定--provision true才能应用此参数。

默认值：GreengrassV2IoTThingPolicy

-trn, --tes-role-name

（可选）用于获取允许核心设备与Amazon服务交互的Amazon证书的 IAM 角色的名称。如果您的角色中不存在具有此名称的角色Amazon Web Services 账户，则Amazon IoT Greengrass核心软件会使用GreengrassV2TokenExchangeRoleAccess策略创建该角色。此角色无权访问托管组件工件的 S3 存储桶。因此，在创建组件时，必须为工件的 S3 存储桶和对象添加权限。有关更多信息，请参阅 授权核心设备与Amazon服务。

必须指定--provision true才能应用此参数。

默认值：GreengrassV2TokenExchangeRole

-tra, --tes-role-alias-name

（可选）指向为该Amazon IoT核心设备提供Amazon证书的 IAM 角色的角色别名的名称。如果您的中不存在具有此名称的角色别名Amazon Web Services 账户，则 Amazon IoT Greengrass Core 软件会创建该别名并将其指向您指定的 IAM 角色。

必须指定--provision true才能应用此参数。

默认值：GreengrassV2TokenExchangeRoleAlias

-ss, --setup-system-service

（可选）您可以将 Amazon IoT Greengrass Core 软件设置为在该设备启动时运行的系统服务。系统服务名称是greengrass。有关更多信息，请参阅 将 Greengrass 核心配置为系统服务。

在 Linux 操作系统上，此参数要求设备上有 systemd 初始化系统。

重要

在 Windows 核心设备上，必须将Amazon IoT Greengrass核心软件设置为系统服务。

默认值：false

-u, --component-default-user

C Amazon IoT Greengrass ore 软件用于运行组件的用户的名称或 ID。例如，您可以指定 ggc_user。在 Windows 操作系统上运行安装程序时，必须使用此值。

在 Linux 操作系统上，您也可以选择指定组。指定用冒号分隔的用户和组。例如，ggc_user:ggc_group。

以下其他注意事项适用于 Linux 操作系统：

  • 如果您以 root 身份运行，则默认组件用户是在配置文件中定义的用户。如果配置文件未定义用户，则默认为ggc_user:ggc_group。如果存在ggc_user或ggc_group不存在，则由软件创建它们。

  • 如果您以非 root 用户身份运行，则 Amazon IoT Greengrass Core 软件将使用该用户来运行组件。

  • 如果您未指定组，则 Amazon IoT Greengrass Core 软件将使用系统用户的主组。

有关更多信息，请参阅 配置运行组件的用户。

-d, --deploy-dev-tools

（可选）您可以将 Greengrass CLI 组件下载并部署到该核心设备上。您可以使用此工具在此核心设备上开发和调试组件。

重要

我们建议您仅在开发环境中使用此组件，而不是在生产环境中使用。此组件提供对生产环境中通常不需要的信息和操作的访问。遵循最低权限原则，将此组件仅部署到需要的核心设备。

必须指定--provision true才能应用此参数。

默认值：false

-init, --init-config

（可选）用于安装Amazon IoT Greengrass核心软件的配置文件的路径。例如，您可以使用此选项来设置具有特定 nucleus 配置的新核心设备。

重要

您指定的配置文件与核心设备上的现有配置文件合并。这包括核心设备上的组件和组件配置。我们建议配置文件仅列出您正在尝试更改的配置。

-tp, --trusted-plugin

（可选）要作为可信插件加载的 JAR 文件的路径。使用此选项提供配置插件 JAR 文件，例如使用队列配置或自定义配置进行安装，或者使用私钥和证书安装在硬件安全模块中。

-s, --start

（可选）您可以在安装Amazon IoT Greengrass核心软件后启动它，也可以选择配置资源。

默认值：true