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

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

Greengrass 命令行界面

Greengrass CLI 组件 (aws.greengrass.Cli) 提供了本地命令行界面，您可以在核心设备上使用该界面在本地开发和调试组件。例如，Greengrass CLI 允许您在核心设备上创建本地部署和重启组件。

您可以在安装Amazon IoT Greengrass Core 软件时安装此组件。有关更多信息，请参阅教程：Amazon IoT Greengrass V2 入门：

安装此组件后，请运行以下命令查看其帮助文档。安装此组件时，它会在/greengrass/v2/bin文件夹greengrass-cli中添加符号链接。您可以从此路径运行 Greengrass CLI，也可以将其添加到您的PATH环境变量中，以便在没有绝对路径greengrass-cli的情况下运行。

Linux or Unix

/greengrass/v2/bin/greengrass-cli help

Windows

C:\greengrass\v2\bin\greengrass-cli help

例如，以下命令重新启动名com.example.HelloWorld为的组件。

Linux or Unix

sudo /greengrass/v2/bin/greengrass-cli component restart --names "com.example.HelloWorld"

Windows

C:\greengrass\v2\bin\greengrass-cli component restart --names "com.example.HelloWorld"

有关更多信息，请参阅Greengrass Command Line Interface：

版本

此组件有以下版本：

类型

此组件是插件组件 (aws.greengrass.plugin)。Greengrass 核心在与核心相同的 Java 虚拟机 (JVM) 中运行此组件。当你在核心设备上更改此组件的版本时，nucleus 会重新启动。

该组件使用与 Greengrass 核心相同的日志文件。有关更多信息，请参阅监控Amazon IoT Greengrass日志：

有关更多信息，请参阅组件类型：

操作系统

要求

此组件有以下要求：

附属物

部署组件时，Amazon IoT Greengrass还会部署其依赖项的兼容版本。这意味着您必须满足组件及其所有依赖项的要求才能成功部署该组件。本节列出了此组件的已发布版本的依赖关系以及为每个依赖项定义组件版本的语义版本限制。您还可以在Amazon IoT Greengrass控制台中查看组件每个版本的依赖关系。在组件详细信息页面上，查找 “依赖关系” 列表。

2.9.0 – 2.9.4

下表列出了此组件 2.9.0 到 2.9.4 版本的依赖关系。

依赖关系	兼容版本	依赖关系类型
Greengrass 核	>=2.5.0	软性

2.8.0 – 2.8.1

下表列出了此组件版本 2.8.0 和 2.8.1 的依赖关系。

依赖关系	兼容版本	依赖关系类型
Greengrass 核	>=2.5.0	软性

2.7.0

下表列出了此组件版本 2.7.0 的依赖关系。

依赖关系	兼容版本	依赖关系类型
Greengrass 核	>=2.5.0	软性

2.6.0

下表列出了此组件版本 2.6.0 的依赖关系。

依赖关系	兼容版本	依赖关系类型
Greengrass 核	>=2.5.0	软性

2.5.0 – 2.5.6

下表列出了此组件版本 2.5.0 到 2.5.6 的依赖关系。

依赖关系	兼容版本	依赖关系类型
Greengrass 核	>=2.5.0	软性

2.4.0

下表列出了此组件版本 2.4.0 版。

依赖关系	兼容版本	依赖关系类型
Greengrass 核	>=2.0	软性

2.3.0

下表列出了此组件版本 2.3.0 版。

依赖关系	兼容版本	依赖关系类型
Greengrass 核	>=2.0	软性

2.2.0

下表列出了此组件版本 2.0 版。

依赖关系	兼容版本	依赖关系类型
Greengrass 核	>=2.0	软性

2.1.0

下表列出了此组件版本 2.1.0 版。

依赖关系	兼容版本	依赖关系类型
Greengrass 核	>=2.0	软性

2.0.x

下表列出了此组件版本 2.0.x 的依赖关系。

依赖关系	兼容版本	依赖关系类型
Greengrass 核	>=2.0.0	软性

注意

Greengrass nucleus 的最低兼容版本对应于 Greengrass CLI 组件的补丁版本。

有关组件依赖关系的更多信息，请参阅组件配方参考。

配置

此组件提供以下配置参数，您可以在部署组件时对其进行自定义。

2.5.x

AuthorizedPosixGroups

（可选）包含以逗号分隔的系统组逗号分隔列表。您授权这些系统组使用 Greengrass CLI 与Amazon IoT Greengrass核心软件进行交互。您可以指定群组名称或群组 ID。例如，group1,1002,group3授权三个系统组（group11002、和group3）使用 Greengrass CLI。

如果您未指定任何要授权的群组，则可以将 Greengrass CLI 作为根用户 (sudo) 或作为运行Amazon IoT Greengrass核心软件的系统用户使用。

AuthorizedWindowsGroups

（可选）包含以逗号分隔的系统组逗号分隔列表。您授权这些系统组使用 Greengrass CLI 与Amazon IoT Greengrass核心软件进行交互。您可以指定群组名称或群组 ID。例如，group1,1002,group3授权三个系统组（group11002、和group3）使用 Greengrass CLI。

如果您未指定任何群组进行授权，则可以以管理员或运行Amazon IoT Greengrass核心软件的系统用户身份使用 Greengrass CLI。

例 示例：配置合并更新

以下示例配置指定授权三个 POSIX 系统组（group11002、和group3）和两个 Windows 用户组（Device Operators和QA Engineers）使用 Greengrass CLI。

{
  "AuthorizedPosixGroups": "group1,1002,group3",
  "AuthorizedWindowsGroups": "Device Operators,QA Engineers"
}

2.4.x - 2.0.x

AuthorizedPosixGroups

（可选）包含以逗号分隔的系统组逗号分隔列表。您授权这些系统组使用 Greengrass CLI 与Amazon IoT Greengrass核心软件进行交互。您可以指定群组名称或群组 ID。例如，group1,1002,group3授权三个系统组（group11002、和group3）使用 Greengrass CLI。

如果您未指定任何要授权的群组，则可以将 Greengrass CLI 作为根用户 (sudo) 或作为运行Amazon IoT Greengrass核心软件的系统用户使用。

例 示例：配置合并更新

以下示例配置指定授权三个系统组（group11002、和group3）使用 Greengrass CLI。

{
  "AuthorizedPosixGroups": "group1,1002,group3"
}

本地日志文件

该组件使用与 Greengrass nucleus 组件相同的日志文件。

Linux

/greengrass/v2/logs/greengrass.log

Windows

C:\greengrass\v2\logs\greengrass.log

更改日志

下表说明组件每个版本的更改。