기계 번역으로 제공되는 번역입니다. 제공된 번역과 원본 영어의 내용이 상충하는 경우에는 영어 버전이 우선합니다.

# Amazon WorkSpaces 애플리케이션 이미지 생성 및 관리를 위한 Image Assistant CLI 작업
<a name="cli-operations-managing-creating-image-image-assistant"></a>

이 섹션에서는 WorkSpaces 애플리케이션 이미지를 생성하고 관리하는 데 사용할 수 있는 Image Assistant CLI 작업에 대해 설명합니다.

Windows 이미지 빌더에서 명령줄 인터페이스를 포함하는 실행 파일은 C:\$1Program Files\$1Amazon\$1Photon\$1ConsoleImageBuilder\$1Image-Assistant.exe에 있습니다. 사용자 편의를 위해 이 실행 파일이 Windows PATH 변수에 포함되어 있습니다. 그러므로 실행 파일의 절대 경로를 지정하지 않고 Image Assistant CLI 작업을 호출할 수 있습니다. 이들 작업을 호출하려면 **image-assistant.exe** 명령을 입력합니다.

Linux 이미지 빌더에서 이미지 어시스턴트 도구는 /usr/local/appstream/image-assistant/AppStreamImageAssistant에 있으며, 심볼릭 링크는 /bin/AppStreamImageAssistant에 있습니다.

## `help` 작업
<a name="help-operation-image-assistant-cli"></a>

모든 Image Assistant CLI 작업의 목록을 검색합니다. 목록의 각 작업의 경우, 설명 및 사용 구문이 제공됩니다. 특정 작업에 대한 도움말을 표시하려면 작업의 이름을 입력하고 **--help** 파라미터를 지정합니다. 예제:

```
add-application --help
```

**시놉시스**

```
help
```

**출력**

사용 가능한 작업의 목록을 각 기능 설명과 함께 표준 출력으로 출력합니다.

## `add-application` 작업
<a name="add-application-operation-image-assistant-cli"></a>

WorkSpaces 애플리케이션 사용자의 애플리케이션 목록에 애플리케이션을 추가합니다. 이 목록의 애플리케이션은 애플리케이션 카탈로그에 포함되어 있습니다. 사용자가 WorkSpaces 애플리케이션 스트리밍 세션에 로그인하면 애플리케이션 카탈로그가 표시됩니다.

**참고**  
애플리케이션 구성을 변경해야 하는 경우 애플리케이션을 제거하고 업데이트된 설정이 적용된 애플리케이션을 추가하세요.

**시놉시스**

```
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>]
```

**옵션**

**`--name`(문자열)**  
애플리케이션의 고유한 이름입니다. 최대 길이는 256자입니다. 최대 50개 애플리케이션을 추가할 수 있습니다. 공백 문자는 사용할 수 없습니다.

**`--absolute-app-path`(문자열)**  
애플리케이션에 대한 실행 파일, 배치 파일 또는 스크립트의 절대 경로입니다. 이 경로는 유효한 파일을 가리켜야 합니다.

**`--display-name`(문자열)**  
애플리케이션 카탈로그에서 애플리케이션에 표시할 이름입니다. 표시 이름을 지정하지 않으면 WorkSpaces 애플리케이션은 실행 파일 이름에서 파생된 이름을 생성합니다. 이 이름은 파일 확장명 없이 생성되며 공백 대신 밑줄이 들어갑니다. 최대 길이는 256자입니다.

**`--absolute-icon-path`(문자열)**  
애플리케이션 아이콘의 절대 경로입니다. 이 경로는 .jpg, .png 또는 .bmp 형식 중 하나인 유효한 아이콘 파일을 가리켜야 합니다. 최대 크기는 256px x 256px입니다. 경로를 지정하지 않으면 실행 파일에 대한 기본 아이콘이 사용됩니다(사용 가능한 경우). 실행 파일에 기본 아이콘을 사용할 수 없는 경우 기본 WorkSpaces 애플리케이션 아이콘이 사용됩니다.

**`--working-directory`(문자열)**  
애플리케이션이 시작될 때 애플리케이션의 초기 작업 디렉터리입니다.

**`--absolute-manifest-path`(문자열)**  
새로운 줄로 구분된 텍스트 파일의 경로입니다. 이 파일은 스트리밍을 위해 사용자에게 플릿 인스턴스를 제공하기 전에 최적화할 파일의 절대 경로를 지정합니다. 이 경로는 유효한 텍스트 파일을 가리켜야 합니다.

**메시지 출력**


| 종료 코드 | 표준 출력으로 출력된 메시지 | 설명 | 
| --- | --- | --- | 
| 0 |  \$1"status": 0, "message": "Success"\$1  |  애플리케이션이 성공적으로 추가되었습니다. | 
| 1 |  \$1"status": 1, "message": "Administrator privileges are required to perform this operation"\$1  |  작업을 완료하려면 관리자 권한이 필요합니다. | 
| 1 |  \$1"status": 1, "message": "Unable to add more than 50 apps to the catalog."\$1  |  WorkSpaces 애플리케이션 카탈로그에 추가할 수 있는 최대 애플리케이션 수가 50개이므로 애플리케이션을 추가할 수 없습니다. | 
| 1 |  \$1"status": 1, "message": "Name is not unique"\$1  |  해당 이름의 애플리케이션이 WorkSpaces 애플리케이션 카탈로그에 이미 있습니다. | 
| 1 |  \$1"status": 1, "message": "File not found (absolute-app-path)"\$1  |  absolute-app-path에 지정된 파일을 찾을 수 없습니다. | 
| 1 |  \$1"status": 1, "message": "Unsupported file extension"\$1  |  Absolute-app-path 파라미터는 .exe 및 .bat 파일 형식만 지원합니다. | 
| 1 |  \$1"status": 1, "message": "Directory not found (working-directory)" |  working-directory에 지정된 디렉터리를 찾을 수 없습니다. | 
| 1 |  \$1"status": 1, "message": "Optimization-manifest not found: <filename>"\$1  |  optimization-manifest에 지정된 파일을 찾을 수 없습니다. | 
| 1 |  \$1"status": 1, "message": "File not found: <filename>"\$1  |  최적화 매니페스트에 지정된 파일을 찾을 수 없습니다. | 
| 255 |  \$1"status": 255, "message": <error message>\$1  |  예상치 못한 오류가 발생했습니다. 요청을 다시 시도하십시오. 오류가 지속되면 AWS Support 에 문의하여 도움을 받으세요. 자세한 내용은 [AWS Support Center](https://console.aws.amazon.com/support/home#/)를 참조하세요. | 

## `remove-application` 작업
<a name="remove-application-operation-image-assistant-cli"></a>

WorkSpaces 애플리케이션 이미지의 애플리케이션 목록에서 애플리케이션을 제거합니다. 애플리케이션은 제거되거나 수정되지 않지만 사용자는 WorkSpaces 애플리케이션 카탈로그에서 애플리케이션을 시작할 수 없습니다.

**시놉시스**

```
remove-application
--name <value>
```

**옵션**

**`--name`(문자열)**  
제거할 애플리케이션의 고유한 식별자입니다.

**메시지 출력**


| 종료 코드 | 표준 출력으로 출력된 메시지 | 설명 | 
| --- | --- | --- | 
| 0 |  \$1"status": 0, "message": "Success"\$1  |  애플리케이션이 성공적으로 제거되었습니다. | 
| 1 |  \$1"status": 1, "message": "Administrator privileges are required to perform this operation"\$1  |  작업을 완료하려면 관리자 권한이 필요합니다. | 
| 1 |  \$1"status": 1, "message": "App not found"\$1  |  지정된 애플리케이션을 WorkSpaces 애플리케이션 애플리케이션 카탈로그에서 찾을 수 없습니다. | 
| 255 |  \$1"status": 255, "message": <error message>\$1  |  예상치 못한 오류가 발생했습니다. 요청을 다시 시도하십시오. 오류가 지속되면 AWS Support 에 문의하여 도움을 받으세요. 자세한 내용은 [AWS Support Center](https://console.aws.amazon.com/support/home#/)를 참조하세요. | 

## `list-applications` 작업
<a name="list-applications-operation-image-assistant-cli"></a>

애플리케이션 카탈로그에 지정된 모든 애플리케이션을 나열합니다.

**시놉시스**

```
list-applications
```

**메시지 출력**


| 종료 코드 | 표준 출력으로 출력된 메시지 | 설명 | 
| --- | --- | --- | 
| 0 |  \$1"status": 0, "message": "Success", "applications": [ \$1..app1.. \$1, \$1 ..app2.. \$1]\$1  |  WorkSpaces 애플리케이션 카탈로그의 애플리케이션 목록입니다. | 
| 255 |  \$1"status": 255, "message": <error message>\$1  |  예상치 못한 오류가 발생했습니다. 요청을 다시 시도하십시오. 오류가 지속되면 AWS Support 에 문의하여 도움을 받으세요. 자세한 내용은 [AWS Support Center](https://console.aws.amazon.com/support/home#/)를 참조하세요. | 

## `update-default-profile` 작업
<a name="update-default-profile-image-assistant-cli"></a>

지정된 Windows 사용자의 프로필을 Windows 기본 사용자 프로필로 복사합니다. 스트리밍하는 새로운 사용자가 지정된 프로필에 저장된 설정을 상속합니다.

**참고**  
Linux 이미지 어시스턴트 CLI 도구에서는 이 작업을 지원하지 않습니다.

**시놉시스**

```
update-default-profile
[--profile <value>]
```

**옵션**

**`--profile`(문자열)**  
Windows 기본 사용자 프로필로 Windows 프로필이 복사된 사용자의 이름입니다. 이름에는 다음 형식을 사용합니다.  
"<domain>\$1<username>"  
이미지 빌더가 Microsoft Active Directory 도메인에 가입되지 않았으면 도메인에 마침표(".")를 입력합니다. 사용자를 지정하지 않으면 WorkSpaces 애플리케이션 템플릿 사용자 계정이 사용됩니다.

**메시지 출력**


| 종료 코드 | 표준 출력으로 출력된 메시지 | 설명 | 
| --- | --- | --- | 
| 0 |  \$1"status": 0, "message": "Success"\$1  |  사용자 설정이 기본 Windows 프로필에 성공적으로 복사되었습니다. | 
| 1 |  \$1"status": 1, "message": "Administrator privileges are required to perform this operation"\$1  |  작업을 완료하려면 관리자 권한이 필요합니다. | 
| 1 |  \$1"status": 1, "message": "Unable to copy file or folder: <path>. <reason>"\$1  |  파일 또는 폴더가 없어 사용자 설정을 복사하지 못했습니다. | 
| 1 |  \$1"status": 1, "message": "Cannot copy a domain user when not joined to a domain""\$1  |  Microsoft Active Directory 도메인 사용자가 지정되었지만 이미지 빌더가 Active Directory 도메인에 가입되지 않았습니다. | 
| 255 |  \$1"status": 255, "message": <error message>\$1  |  예상치 못한 오류가 발생했습니다. 요청을 다시 시도하십시오. 오류가 지속되면 AWS Support 에 문의하여 도움을 받으세요. 자세한 내용은 [AWS Support Center](https://console.aws.amazon.com/support/home#/)를 참조하세요. | 

## `reset-user-profile` 작업
<a name="reset-user-profile-image-assistant-cli"></a>

지정된 사용자의 Windows 사용자 프로필을 삭제합니다.

**참고**  
Linux 이미지 어시스턴트 CLI 도구에서는 이 작업을 지원하지 않습니다.

**시놉시스**

```
reset-user-profile
[--profile <value>]
```

**옵션**

**`--profile`(문자열)**  
Windows 프로필이 삭제될 Windows 사용자의 이름입니다. 이름에는 다음 형식을 사용합니다.  
"<domain>\$1<username>"  
이미지 빌더가 Microsoft Active Directory 도메인에 가입되지 않았으면 도메인에 마침표(".")를 입력합니다.

**메시지 출력**


| 종료 코드 | 표준 출력으로 출력된 메시지 | 설명 | 
| --- | --- | --- | 
| 0 |  \$1"status": 0, "message": "Success"\$1  |  지정된 사용자 설정이 성공적으로 삭제되었습니다. | 
| 1 |  \$1"status": 1, "message": "Administrator privileges are required to perform this operation"\$1  |  작업을 완료하려면 관리자 권한이 필요합니다. | 
| 1 |  \$1"status": 1, "message": "Unable to copy file or folder: <path>. <reason>"\$1  |  파일 또는 폴더가 없어 사용자 설정을 재설정하지 못했습니다. | 
| 1 |  \$1"status": 1, "message": "Cannot copy a domain user when not joined to a domain""\$1  |  Microsoft Active Directory 도메인 사용자가 지정되었지만 이미지 빌더가 Active Directory 도메인에 가입되지 않았습니다. | 
| 255 |  \$1"status": 255, "message": <error message>\$1  |  예상치 못한 오류가 발생했습니다. 요청을 다시 시도하십시오. 오류가 지속되면 AWS Support 에 문의하여 도움을 받으세요. 자세한 내용은 [AWS Support Center](https://console.aws.amazon.com/support/home#/)를 참조하세요. | 

## `create-image` 작업
<a name="create-image-operation-image-assistant-cli"></a>

이미지 생성 워크플로를 시작하여 WorkSpaces 애플리케이션 플릿에 사용할 수 있는 WorkSpaces 애플리케이션 이미지를 생성합니다.

**시놉시스**

```
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]
```

**옵션**

**`--name`(문자열)**  
WorkSpaces 애플리케이션 이미지의 이름입니다. 이름은 Amazon Web Services 계정 및 AWS 리전 내에서 고유해야 합니다. 최대 길이는 100자입니다. 허용되는 문자는 다음과 같습니다.  
a\$1z, A\$1Z, 0\$19, 밑줄(\$1), 하이픈(-) 및 마침표(.)  
이미지 이름은 'aws', 'appstream', 'amazon’과 같은 접두사로 시작할 수 없습니다. 이러한 접두사는 AWS 용으로 예약되어 있습니다.

**`--description`(문자열)**  
이미지에 표시할 설명입니다. 최대 길이는 256자입니다.

**`--display-name`(문자열)**  
이미지에 표시할 이름입니다. 최대 길이는 256자입니다.

**`--enable-dynamic-app-catalog` \$1 `--no-enable-dynamic-app-catalog`**  
WorkSpaces 애플리케이션 동적 애플리케이션 프레임워크에 대한 지원을 활성화하거나 비활성화합니다. 두 파라미터 중 하나를 지정하지 않으면 동적 애플리케이션 프레임워크에 대한 지원이 활성화되지 않습니다.  
동적 애플리케이션 프레임워크는 동적 앱 공급자를 구축하는 데 사용할 수 있는 WorkSpaces 애플리케이션 스트리밍 인스턴스 내의 작업을 제공합니다. 동적 앱 공급자는 이들 작업을 사용해 사용자가 실시간으로 액세스하는 애플리케이션의 카탈로그를 수정할 수 있습니다. 자세한 내용은 [WorkSpaces 애플리케이션 동적 애플리케이션 프레임워크를 사용하여 동적 앱 공급자 구축](build-dynamic-app-provider.md) 단원을 참조하십시오.

**`--use-latest-agent-version` \$1 `--no-use-latest-agent-version`**  
이미지를 현재 설치된 WorkSpaces 애플리케이션 에이전트의 버전에 고정할지 아니면 항상 최신 에이전트 버전을 사용할지 지정합니다. 두 파라미터 중 하나를 지정하지 않으면 이미지가 현재 설치된 WorkSpaces 애플리케이션 에이전트 버전에 고정됩니다. 자세한 내용은 [WorkSpaces 애플리케이션 에이전트 버전 관리](base-images-agent.md) 단원을 참조하십시오.

**`--tags`(문자열)**  
이미지와 연결할 태그입니다. 태그는 키-값 쌍입니다. 다음 형식을 사용합니다.  
--tags "mykey" "myval" "mykey2" "myval2"  
태그에 대한 자세한 내용은 [Amazon WorkSpaces 애플리케이션 리소스에 태그 지정](tagging-basic.md) 섹션을 참조하세요.

**`--dry-run`(문자열)**  
이미지를 생성하지 않고 유효성 검사를 수행합니다. 이미지를 생성하기 전에 이 명령을 사용하여 이미지에 문제가 있는지 확인합니다.

**메시지 출력**


| 종료 코드 | 표준 출력으로 출력된 메시지 | 설명 | 
| --- | --- | --- | 
| 0 |  \$1"status": 0, "message": "Success"\$1  |  이미지를 생성하는 워크플로가 성공적으로 시작되었습니다. | 
| 1 |  \$1"status": 1, "message": "Administrator privileges are required to perform this operation"\$1  |  작업을 완료하려면 관리자 권한이 필요합니다. | 
| 1 |  \$1"status": 1, "message": "An image with the given name already exists"\$1  |  지정된 이름의 이미지가 Amazon Web Services 계정에 이미 있습니다. | 
| 1 |  \$1"status": 1, "message": "Invalid value (tags)"\$1  |  지정된 태그가 잘못되었습니다. | 
| 255 |  \$1"status": 255, "message": <error message>\$1  |  예상치 못한 오류가 발생했습니다. 요청을 다시 시도하십시오. 오류가 지속되면 AWS Support 에 문의하여 도움을 받으세요. 자세한 내용은 [AWS Support Center](https://console.aws.amazon.com/support/home#/)를 참조하세요. |