本文属于机器翻译版本。若本译文内容与英语原文存在差异，则一律以英文原文为准。
用于创建和管理您的 Amazon AppStream 2.0 图像的图像助手CLI操作
本节介绍可用于创建和管理 AppStream 2.0 图像的图像助手CLI操作。
在 Windows 映像生成器上，包含命令行界面的可执行文件位于：C:\Program Files\ Amazon\ Photon\ConsoleImageBuilder\ Image-Assistant.exe。为方便起见，此可执行文件包含在 Windows PATH 变量中。这样，您无需指定可执行文件的绝对路径即可调用 Image Assistant CLI 操作。要调用这些操作，请键入 image-assistant.exe 命令。
在 Linux 映像生成器上，图像助手工具位于 /usr/local/appstream/image-assistant/，符号链接位于 /b AppStreamImageAssistant in/。AppStreamImageAssistant
help 操作
检索所有图像助手CLI操作的列表。列表中的每个操作均提供了描述和使用语法。要显示特定操作的帮助，请键入操作的名称并指定 -help 参数。例如：
add-application --help
摘要
help
输出
将可用操作的列表及其功能描述打印到标准输出中。
add-application 操作
将该应用程序添加到 AppStream 2.0 用户的应用程序列表中。此列表中的应用程序包含在应用程序目录中。当用户登录 AppStream 2.0 直播会话时，应用程序目录会显示给他们。
注意
如果您需要更改应用程序配置，请移除该应用程序并添加具有更新设置的应用程序。
摘要
add-application --name <value> --absolute-app-path <value> [--display-name <value>] [--absolute-icon-path <value>] [--working-directory <value>] [--launch-parameters <""-escaped value>] [--absolute-manifest-path <value>]
Options
--name（字符串）-
应用程序的唯一名称。最大长度为 256 个字符。最多可以添加 50 个应用程序。不能使用空格字符。
--absolute-app-path（字符串）-
应用程序的可执行文件、批处理文件或脚本的绝对路径。该路径必须指向有效文件。
--display-name（字符串）-
应用程序目录中为应用程序显示的名称。如果未指定显示名称，则 AppStream 2.0 会创建一个派生自可执行文件名的名称。创建的名称没有文件扩展名，并使用下划线代替空格。最大长度为 256 个字符。
--absolute-icon-path（字符串）-
应用程序图标的绝对路径。该路径必须指向以下任一类型的有效的图标文件：.jpg、.png 或 .bmp。最大尺寸为：256 像素 x 256 像素。如果未指定路径，则使用可执行文件的默认图标（如果有）。如果可执行文件没有默认图标，则使用默认的 AppStream 2.0 应用程序图标。
--working-directory（字符串）-
启动应用程序时应用程序的初始工作目录。
--absolute-manifest-path（字符串）-
新的行分隔文本文件的路径。该文件指定了在将实例集实例提供给用户进行流式传输之前要优化的文件的绝对路径。该路径必须指向有效的文本文件。
消息输出
| 退出代码 | 打印到标准输出的消息 | 描述 |
|---|---|---|
| 0 | {"status": 0, "message": "Success"} | 该应用程序已成功添加。 |
| 1 | {"status": 1, "message": "Administrator privileges are required to perform this operation"} | 必须有管理员权限才能完成操作。 |
| 1 | {"status": 1, "message": "Unable to add more than 50 apps to the catalog."} | 无法添加该应用程序，因为可以添加到 AppStream 2.0 应用程序目录的最大应用程序数为 50。 |
| 1 | {"status": 1, "message": "Name is not unique"} | AppStream 2.0 应用程序目录中已存在同名的应用程序。 |
| 1 | {“状态”：1，“消息”：“找不到文件 (absolute-app-path)”} | 找不到为 absolute-app-path 指定的文件。 |
| 1 | {"status": 1, "message": "Unsupported file extension"} | Absolute-app-path 参数仅支持以下文件类型：.exe 和 .bat。 |
| 1 | {"status": 1, "message": "Directory not found (working-directory)" | 找不到为 working-directory 指定的目录。 |
| 1 | {"status": 1, "message": "Optimization-manifest not found: <filename>"} | 找不到为 optimization-manifest 指定的文件。 |
| 1 | {"status": 1, "message": "File not found: <filename>"} | 找不到优化清单中指定的文件。 |
| 255 | {"status": 255, "message": <error message>} | 出现意外错误。请重试该请求。如果错误仍然存在，请联系 AWS Support 寻求帮助。有关更多信息，请参阅 AWS Support 中心 |
remove-application 操作
从 AppStream 2.0 映像的应用程序列表中移除应用程序。该应用程序未被卸载或修改，但用户将无法从 AppStream 2.0 应用程序目录中启动它。
摘要
remove-application --name <value>
Options
--name（字符串）-
要删除的应用程序的唯一标识符。
消息输出
| 退出代码 | 打印到标准输出的消息 | 描述 |
|---|---|---|
| 0 | {"status": 0, "message": "Success"} | 该应用程序已成功删除。 |
| 1 | {"status": 1, "message": "Administrator privileges are required to perform this operation"} | 必须有管理员权限才能完成操作。 |
| 1 | {"status": 1, "message": "App not found"} | 在 AppStream 2.0 应用程序目录中找不到指定的应用程序。 |
| 255 | {"status": 255, "message": <error message>} | 出现意外错误。请重试该请求。如果错误仍然存在，请联系 AWS Support 寻求帮助。有关更多信息，请参阅 AWS Support 中心 |
list-applications 操作
列出应用程序目录中指定的所有应用程序。
摘要
list-applications
消息输出
| 退出代码 | 打印到标准输出的消息 | 描述 |
|---|---|---|
| 0 | {"status": 0, "message": "Success", "applications": [ {..app1.. }, { ..app2.. }]} | AppStream 2.0 应用程序目录中的应用程序列表。 |
| 255 | {"status": 255, "message": <error message>} | 出现意外错误。请重试该请求。如果错误仍然存在，请联系 AWS Support 寻求帮助。有关更多信息，请参阅 AWS Support 中心 |
update-default-profile 操作
将指定的 Windows 用户的配置文件复制到 Windows 默认用户配置文件。进行流式传输的新用户将继承存储在指定配置文件中的设置。
注意
Linux 图像助手CLI工具不支持此操作。
摘要
update-default-profile [--profile <value>]
Options
--profile（字符串）-
Windows 配置文件将被复制到 Windows 默认用户配置文件的用户的名称。名称应使用以下格式：
"<domain>\<username>"
如果映像生成器未加入 Microsoft Active Directory 域，请为该域输入句点“.”。如果您未指定用户，则使用 AppStream 2.0 模板用户帐户。
消息输出
| 退出代码 | 打印到标准输出的消息 | 描述 |
|---|---|---|
| 0 | {"status": 0, "message": "Success"} | 用户设置已成功复制到默认 Windows 配置文件。 |
| 1 | {"status": 1, "message": "Administrator privileges are required to perform this operation"} | 必须有管理员权限才能完成操作。 |
| 1 | {"status": 1, "message": "Unable to copy file or folder: <path>. <reason>"} | 无法复制用户设置，因为文件或文件夹不可用。 |
| 1 | {"status": 1, "message": "Cannot copy a domain user when not joined to a domain""} | 指定了 Microsoft Active Directory 域用户，但映像生成器未加入 Active Directory 域。 |
| 255 | {"status": 255, "message": <error message>} | 出现意外错误。请重试该请求。如果错误仍然存在，请联系 AWS Support 寻求帮助。有关更多信息，请参阅 AWS Support 中心 |
reset-user-profile 操作
删除指定用户的 Windows 用户配置文件。
注意
Linux 图像助手CLI工具不支持此操作。
摘要
reset-user-profile [--profile <value>]
Options
--profile（字符串）-
Windows 配置文件将被删除的 Windows 用户的名称。名称应使用以下格式：
"<domain>\<username>"
如果映像生成器未加入 Microsoft Active Directory 域，请为该域输入句点“.”。
消息输出
| 退出代码 | 打印到标准输出的消息 | 描述 |
|---|---|---|
| 0 | {"status": 0, "message": "Success"} | 已成功删除指定的用户设置。 |
| 1 | {"status": 1, "message": "Administrator privileges are required to perform this operation"} | 必须有管理员权限才能完成操作。 |
| 1 | {"status": 1, "message": "Unable to copy file or folder: <path>. <reason>"} | 无法重置用户设置，因为文件或文件夹不可用。 |
| 1 | {"status": 1, "message": "Cannot copy a domain user when not joined to a domain""} | 指定了 Microsoft Active Directory 域用户，但映像生成器未加入 Active Directory 域。 |
| 255 | {"status": 255, "message": <error message>} | 出现意外错误。请重试该请求。如果错误仍然存在，请联系 AWS Support 寻求帮助。有关更多信息，请参阅 AWS Support 中心 |
create-image 操作
启动图像创建工作流程，生成可用于 AppStream 2.0 舰队的 AppStream 2.0 图像。
摘要
create-image --name <value> [--description <value>] [--display-name <value>] [--enable-dynamic-app-catalog] | [--no-enable-dynamic-app-catalog] [--use-latest-agent-version] | [--no-use-latest-agent-version] [--tags <value>] [--dry-run]
Options
--name（字符串）-
AppStream 2.0 图像的名称。该名称在亚马逊 Web Services 账户和 AWS 地区内必须是唯一的。最大长度为 100 个字符。允许使用的字符包括：
a-z、A-Z、0-9、下划线（-）、连字符（-）和句点（.）
映像名称不能以以下任何前缀开头：'aws'、'appstream' 和 'amazon'。这些前缀是为 AWS 预留的。
--description（字符串）-
要为映像显示的描述。最大长度为 256 个字符。
--display-name（字符串）-
要为映像显示的名称。最大长度为 256 个字符。
--enable-dynamic-app-catalog|--no-enable-dynamic-app-catalog-
启用或禁用对 AppStream 2.0 动态应用程序框架的支持。如果您未指定任一参数，则系统不会启用对动态应用程序框架的支持。
动态应用程序框架在 AppStream 2.0 流媒体实例中提供操作，您可以使用这些操作来构建动态应用程序提供商。动态应用程序提供程序可以使用这些操作修改您的用户可以实时访问的应用程序目录。有关更多信息，请参阅 使用 AppStream 2.0 动态应用程序框架构建动态应用程序提供程序。
--use-latest-agent-version|--no-use-latest-agent-version-
指定是将映像固定到当前安装的 AppStream 2.0 代理版本，还是始终使用最新的代理版本。如果您未指定任何一个参数，则图像将固定到当前安装的 AppStream 2.0 代理版本。有关更多信息，请参阅 管理 AppStream 2.0 代理版本。
--tags（字符串）-
要与映像关联的标签。标签是键值对。采用以下格式：
--tags "mykey" "myval" "mykey2" "myval2"
有关标签的更多信息，请参阅 为你的亚马逊 AppStream 2.0 资源添加标签。
--dry-run（字符串）-
在不创建映像的情况下执行验证。在创建映像之前，请使用此命令确定映像是否存在任何问题。
消息输出
| 退出代码 | 打印到标准输出的消息 | 描述 |
|---|---|---|
| 0 | {"status": 0, "message": "Success"} | 创建映像的工作流已成功启动。 |
| 1 | {"status": 1, "message": "Administrator privileges are required to perform this operation"} | 必须有管理员权限才能完成操作。 |
| 1 | {"status": 1, "message": "An image with the given name already exists"} | Amazon Web Services 账户中已存在具有指定名称的映像。 |
| 1 | {"status": 1, "message": "Invalid value (tags)"} | 指定的标签无效。 |
| 255 | {"status": 255, "message": <error message>} | 出现意外错误。请重试该请求。如果错误仍然存在，请联系 AWS Support 寻求帮助。有关更多信息，请参阅 AWS Support 中心 |
