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

# 설치 프로그램 인수
<a name="configure-installer"></a>

AWS IoT Greengrass 코어 소프트웨어에는 소프트웨어가 설정되고 Greengrass 코어 디바이스에서 실행될 필수 AWS 리소스가 프로비저닝되는 설치 프로그램이 포함되어 있습니다. 설치 프로그램에는 지정하여 설치를 구성할 수 있는 다음 인수가 포함되어 있습니다.

`-h`, `--help`  
(선택 사항) 설치 프로그램의 도움말 정보를 표시합니다.

`--version`  
(선택 사항) AWS IoT Greengrass 코어 소프트웨어의 버전을 표시합니다.

`-Droot`  
(선택 사항) AWS IoT Greengrass 코어 소프트웨어의 루트로 사용할 폴더의 경로입니다.  
이 인수를 통해 JVM 속성이 설정되므로 설치 프로그램을 실행할 때 `-jar` 앞에 지정해야 합니다. 예를 들어, `java -Droot="/greengrass/v2" -jar /path/to/Greengrass.jar`를 지정합니다.
기본값:  
+ Linux: `~/.greengrass`
+ Windows: `%USERPROFILE%/.greengrass`

`-ar`, `--aws-region`  
AWS IoT Greengrass 코어 소프트웨어에서 필수 AWS 리소스를 검색하거나 생성하는 데 사용되는 AWS 리전입니다.

`-p`, `--provision`  
(선택 사항) 이 디바이스를 AWS IoT 사물로 등록하고 코어 디바이스에 필요한 AWS 리소스를 프로비저닝할 수 있습니다. `true`를 지정하면 AWS IoT Greengrass 코어 소프트웨어에서는 AWS IoT 사물, AWS IoT 사물 그룹(선택 사항), IAM 역할 및 AWS IoT 역할 별칭이 프로비저닝됩니다.  
기본값: `false`

`-tn`, `--thing-name`  
(선택 사항) 이 코어 디바이스로 등록하는 AWS IoT 사물의 이름입니다. 이름 있는 정책이 AWS 계정에 없으면 AWS IoT Greengrass 코어 소프트웨어에서 생성됩니다.  
사물 이름에는 콜론(`:`) 문자를 포함할 수 없습니다.
이 인수를 적용하려면 `--provision true`를 지정해야 합니다.  
기본값: `GreengrassV2IotThing_` 및 무작위 UUID.

`-tgn`, `--thing-group-name`  
(선택 사항) 이 코어 디바이스의 AWS IoT 사물을 추가하는 AWS IoT 사물 그룹의 이름입니다. 배포의 대상이 이 사물 그룹이라면 이 코어 디바이스에서는 AWS IoT Greengrass에 연결될 때 해당 배포가 수신됩니다. 이 이름의 사물 그룹이 AWS 계정에 없으면 AWS IoT Greengrass 코어 소프트웨어에서 생성됩니다.  
사물 그룹 이름에는 콜론(`:`) 문자를 포함할 수 없습니다.
이 인수를 적용하려면 `--provision true`를 지정해야 합니다.

`-tpn`, `--thing-policy-name`  
이 기능은 [Greengrass nucleus 구성 요소](greengrass-nucleus-component.md) v2.4.0 이상에서 사용할 수 있습니다.  
(선택 사항) 이 코어 디바이스의 AWS IoT 사물 인증서에 연결할 AWS IoT 정책의 이름입니다. 이 이름의 AWS IoT 정책이 AWS 계정에 없으면 AWS IoT Greengrass 코어 소프트웨어에서 생성됩니다.  
AWS IoT Greengrass 코어 소프트웨어에서는 기본적으로 허용적 AWS IoT 정책이 생성됩니다. 이 정책의 범위를 좁히거나 사용 사례에 대한 권한을 제한하는 사용자 지정 정책을 생성할 수 있습니다. 자세한 내용은 [AWS IoT Greengrass V2 코어 디바이스에 대한 최소 AWS IoT 정책](device-auth.md#greengrass-core-minimal-iot-policy) 섹션을 참조하세요.  
이 인수를 적용하려면 `--provision true`를 지정해야 합니다.  
기본값: `GreengrassV2IoTThingPolicy`

`-trn`, `--tes-role-name`  
(선택 사항) 코어 디바이스에서 AWS 서비스와 상호 작용할 수 있도록 AWS 자격 증명을 획득하는 데 사용할 IAM 역할의 이름입니다. 이 이름의 역할이 AWS 계정에 없으면 AWS IoT Greengrass 코어 소프트웨어에서 `GreengrassV2TokenExchangeRoleAccess` 정책을 통해 생성됩니다. 이 역할에는 구성 요소 아티팩트를 호스팅하는 S3 버킷에 액세스할 권한이 없습니다. 따라서 구성 요소를 생성할 때 아티팩트의 S3 버킷과 객체에 권한을 추가해야 합니다. 자세한 내용은 [코어 디바이스가 AWS 서비스와 상호 작용할 수 있도록 권한 부여](device-service-role.md) 섹션을 참조하세요.  
이 인수를 적용하려면 `--provision true`를 지정해야 합니다.  
기본값: `GreengrassV2TokenExchangeRole`

`-tra`, `--tes-role-alias-name`  
(선택 사항) 이 코어 디바이스에 대한 AWS 자격 증명을 제공하는 IAM 역할을 지목하는 AWS IoT 역할 별칭의 이름입니다. 이 이름의 역할 별칭이 AWS 계정에 없으면 AWS IoT Greengrass 코어 소프트웨어에서 생성되며, 지정하는 IAM 역할이 지목됩니다.  
이 인수를 적용하려면 `--provision true`를 지정해야 합니다.  
기본값: `GreengrassV2TokenExchangeRoleAlias`

`-ss`, `--setup-system-service`  
(선택 사항) AWS IoT Greengrass 코어 소프트웨어를 이 디바이스가 부팅될 때 실행되는 시스템 서비스로 설정할 수 있습니다. 시스템 서비스 이름은 `greengrass`입니다. 자세한 내용은 [Greengrass nucleus를 시스템 서비스로 구성](configure-greengrass-core-v2.md#configure-system-service) 섹션을 참조하세요.  
Linux 운영 체제에서 이 인수를 사용하려면 디바이스에서 systemd init 시스템을 사용할 수 있어야 합니다.  
Windows 코어 디바이스에서는 AWS IoT Greengrass 코어 소프트웨어를 시스템 서비스로 설정해야 합니다.
기본값: `false`

`-u`, `--component-default-user`  
AWS IoT Greengrass 코어 소프트웨어에서 구성 요소 실행에 사용되는 사용자의 이름 또는 ID입니다. 예를 들어, **ggc\$1user**를 지정할 수 있습니다. Windows 운영 체제에서 설치 프로그램을 실행할 때 이 값이 필요합니다.  
Linux 운영 체제에서는 선택적으로 그룹을 지정할 수도 있습니다. 콜론으로 구분되는 사용자 및 그룹을 지정합니다. 예를 들어 **ggc\$1user:ggc\$1group**입니다.  

Linux 운영 체제에는 다음 추가 고려 사항이 적용됩니다.
+ 루트로 실행하는 경우 기본 구성 요소 사용자는 구성 파일에 정의되어 있는 사용자입니다. 구성 파일에서 사용자가 정의되지 않으면 이 기본값은 `ggc_user:ggc_group`으로 설정됩니다. `ggc_user` 또는 `ggc_group`이 없으면 소프트웨어에서 생성합니다.
+ 루트 사용자가 아닌 사용자로 실행하면 AWS IoT Greengrass 코어 소프트웨어에서는 해당 사용자가 구성 요소 실행에 사용됩니다.
+ 그룹을 지정하지 않으면 AWS IoT Greengrass 코어 소프트웨어에서는 시스템 사용자의 기본 그룹이 사용됩니다.
자세한 내용은 [구성 요소를 실행하는 사용자 구성](configure-greengrass-core-v2.md#configure-component-user) 섹션을 참조하세요.

`-d`, `--deploy-dev-tools`  
(선택 사항) [Greengrass CLI](greengrass-cli-component.md) 구성 요소를 다운로드하여 이 코어 디바이스에 배포할 수 있습니다. 이 도구를 사용하여 이 코어 디바이스에서 구성 요소를 개발하고 디버깅할 수 있습니다.  
 <a name="local-dev-tools-production-environment-warning"></a>이 구성 요소는 프로덕션 환경이 아닌 개발 환경에서만 사용하는 것이 좋습니다. 이 구성 요소는 일반적으로 프로덕션 환경에서는 필요하지 않은 정보와 작업에 대한 액세스를 제공합니다. 필요한 코어 디바이스에만 이 구성 요소를 배포하여 최소 권한 원칙을 따릅니다.
이 인수를 적용하려면 `--provision true`를 지정해야 합니다.  
기본값: `false`

`-init`, `--init-config`  
(선택 사항) AWS IoT Greengrass 코어 소프트웨어를 설치하는 데 사용할 구성 파일의 경로입니다. 예를 들어 이 옵션을 사용하여 특정 nucleus 구성으로 새 코어 디바이스를 설정할 수 있습니다.  
지정하는 구성 파일은 코어 디바이스의 기존 구성 파일과 병합됩니다. 여기에는 코어 디바이스의 구성 요소 및 구성 요소 구성이 포함됩니다. 구성 파일에는 변경하려는 구성만 나열되는 것이 좋습니다.

`-tp`, `--trusted-plugin`  
(선택 사항) 신뢰할 수 있는 플러그인으로 로드할 JAR 파일의 경로입니다. 이 옵션을 사용하여 예컨대 [플릿 프로비저닝](fleet-provisioning.md) 또는 [사용자 지정 프로비저닝](custom-provisioning.md)으로 설치하거나 프라이빗 키 및 인증서로 [하드웨어 보안 모듈](hardware-security.md)에 설치할 프로비저닝 플러그인 JAR 파일을 제공합니다.

`-s`, `--start`  
(선택 사항) 설치하고 선택적으로 리소스를 프로비저닝한 후 AWS IoT Greengrass 코어 소프트웨어를 시작할 수 있습니다.  
기본값: `true`