Amazon AppStream 2.0 이미지 생성 및 관리를 위한 Image Assistant CLI 작업 - Amazon AppStream 2.0
help 작업add-application 작업remove-application 작업list-applications 작업update-default-profile 작업reset-user-profile 작업create-image 작업

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

Amazon AppStream 2.0 이미지 생성 및 관리를 위한 Image Assistant CLI 작업

이 섹션에서는 AppStream 2.0 이미지를 생성하고 관리하는 데 사용할 수 있는 Image Assistant 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/에 위치AppStreamImageAssistant하며 기호 링크는 /bin/에 있습니다AppStreamImageAssistant.

help 작업

모든 Image Assistant 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>]

옵션

--name(문자열)

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

--absolute-app-path(문자열)

애플리케이션에 대한 실행 파일, 배치 파일 또는 스크립트의 절대 경로입니다. 이 경로는 유효한 파일을 가리켜야 합니다.

--display-name(문자열)

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

--absolute-icon-path(문자열)

애플리케이션 아이콘의 절대 경로입니다. 이 경로는 .jpg, .png 또는 .bmp 형식 중 하나인 유효한 아이콘 파일을 가리켜야 합니다. 최대 크기는 256px x 256px입니다. 경로를 지정하지 않으면 실행 파일에 대한 기본 아이콘이 사용됩니다(사용 가능한 경우). 실행 파일에 기본 아이콘을 사용할 수 없는 경우 기본 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 Center를 참조하세요.

remove-application 작업

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

시놉시스

remove-application
--name <value>

옵션

--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 Center를 참조하세요.

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 Center를 참조하세요.

update-default-profile 작업

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

참고

이 작업은 Linux 이미지 어시스턴트 CLI 도구에서 지원되지 않습니다.

시놉시스

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

옵션

--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 Center를 참조하세요.

reset-user-profile 작업

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

참고

이 작업은 Linux 이미지 어시스턴트 CLI 도구에서 지원되지 않습니다.

시놉시스

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

옵션

--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 Center를 참조하세요.

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]

옵션

--name(문자열)

AppStream 2.0 이미지의 이름입니다. 이름은 Amazon 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"

태그에 대한 자세한 내용은 Amazon 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 Center를 참조하세요.