本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。

# 安裝程式引數
<a name="configure-installer"></a>

 AWS IoT Greengrass 核心軟體包含 安裝程式，可設定軟體並佈建 Greengrass 核心裝置執行所需的 AWS 資源。安裝程式包含下列引數，您可以指定這些引數來設定安裝：

`-h`, `--help`  
（選用） 顯示安裝程式的說明資訊。

`--version`  
（選用） 顯示 AWS IoT Greengrass 核心軟體版本。

`-Droot`  
（選用） 要用作 AWS IoT Greengrass Core 軟體根資料夾的路徑。  
此引數會設定 JVM 屬性，因此您必須在執行安裝程式`-jar`之前指定它。例如，指定 `java -Droot="/greengrass/v2" -jar /path/to/Greengrass.jar`。
預設：  
+ Linux：`~/.greengrass`
+ Windows：`%USERPROFILE%/.greengrass`

`-ar`, `--aws-region`  
Core AWS IoT Greengrass 軟體用來擷取或建立其必要 AWS 資源 AWS 區域 的 。

`-p`, `--provision`  
（選用） 您可以將此裝置註冊為 AWS IoT 物件， AWS 並佈建核心裝置所需的資源。如果您指定 `true`， AWS IoT Greengrass Core 軟體會佈建 AWS IoT 物件、 （選用） AWS IoT 物件群組、IAM 角色和 AWS IoT 角色別名。  
預設：`false`

`-tn`, `--thing-name`  
（選用） 您註冊為此核心裝置的 AWS IoT 物件名稱。如果名稱為 的物件不存在於您的 中 AWS 帳戶，則 AWS IoT Greengrass Core 軟體會建立它。  
物件名稱不能包含冒號 (`:`) 字元。
您必須指定 `--provision true`才能套用此引數。  
預設：`GreengrassV2IotThing_`加上隨機 UUID。

`-tgn`, `--thing-group-name`  
（選用） 您新增此核心裝置 AWS IoT AWS IoT 物件的物件群組名稱。如果部署以此物件群組為目標，則此核心裝置會在連線到 時接收該部署 AWS IoT Greengrass。如果您的 中不存在具有此名稱的物件群組 AWS 帳戶，則 AWS IoT Greengrass Core 軟體會建立它。  
物件群組名稱不能包含冒號 (`:`) 字元。
您必須指定 `--provision true`才能套用此引數。

`-tpn`, `--thing-policy-name`  
此功能適用於 [Greengrass 核元件](greengrass-nucleus-component.md)的 v2.4.0 和更新版本。  
（選用） 要連接到此核心裝置 AWS IoT 物件憑證 AWS IoT 的政策名稱。如果您的 中不存在具有此名稱 AWS IoT 的政策 AWS 帳戶，則 AWS IoT Greengrass Core 軟體會建立該政策。  
 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 憑證的 IAM 角色名稱，讓核心裝置與服務互動 AWS 。如果您的 中不存在具有此名稱的角色 AWS 帳戶，則 AWS IoT Greengrass Core 軟體會使用 `GreengrassV2TokenExchangeRoleAccess`政策建立該角色。此角色無法存取您託管元件成品的 S3 儲存貯體。因此，您必須在建立元件時，將許可新增至成品的 S3 儲存貯體和物件。如需詳細資訊，請參閱[授權核心裝置與 AWS 服務互動](device-service-role.md)。  
您必須指定 `--provision true`才能套用此引數。  
預設：`GreengrassV2TokenExchangeRole`

`-tra`, `--tes-role-alias-name`  
（選用） 指向提供此核心裝置 AWS 登入資料的 IAM 角色 AWS IoT 之角色別名的名稱。如果您的 中不存在具有此名稱的角色別名 AWS 帳戶，則 AWS IoT Greengrass Core 軟體會建立該別名，並將其指向您指定的 IAM 角色。  
您必須指定 `--provision true`才能套用此引數。  
預設：`GreengrassV2TokenExchangeRoleAlias`

`-ss`, `--setup-system-service`  
（選用） 您可以將 AWS IoT Greengrass Core 軟體設定為在此裝置開機時執行的系統服務。系統服務名稱為 `greengrass`。如需詳細資訊，請參閱[將 Greengrass 核設定為系統服務](configure-greengrass-core-v2.md#configure-system-service)。  
在 Linux 作業系統上，此引數要求 系統化初始化系統可在裝置上使用。  
在 Windows 核心裝置上，您必須將 AWS IoT Greengrass Core 軟體設定為系統服務。
預設：`false`

`-u`, `--component-default-user`  
Core AWS IoT Greengrass 軟體用來執行元件的使用者名稱或 ID。例如，您可以指定 **ggc\$1user**。當您在 Windows 作業系統上執行安裝程式時，需要此值。  
在 Linux 作業系統上，您也可以選擇性地指定 群組。指定以冒號分隔的使用者和群組。例如：**ggc\$1user:ggc\$1group**。  

下列其他考量事項適用於 Linux 作業系統：
+ 如果您以根身分執行，預設元件使用者即為組態檔案中定義的使用者。如果組態檔案未定義使用者，則預設為 `ggc_user:ggc_group`。如果 `ggc_user`或 `ggc_group` 不存在，軟體會建立它們。
+ 如果您以非根使用者身分執行 ，則 AWS IoT Greengrass Core 軟體會使用該使用者來執行元件。
+ 如果您未指定群組， AWS IoT Greengrass 則 Core 軟體會使用系統使用者的主要群組。
如需詳細資訊，請參閱[設定執行元件的使用者](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 Core 軟體的組態檔案路徑。您可以使用此選項來設定具有特定核組態的新核心裝置，例如。  
您指定的組態檔案會與核心裝置上的現有組態檔案合併。這包括核心裝置上的元件和元件組態。我們建議組態檔案只列出您嘗試變更的組態。

`-tp`, `--trusted-plugin`  
（選用） 要載入為信任外掛程式的 JAR 檔案路徑。使用此選項提供佈建外掛程式 JAR 檔案，例如使用[機群佈建](fleet-provisioning.md)或[自訂佈建](custom-provisioning.md)安裝 ，或使用私有金鑰和憑證在[硬體安全模組](hardware-security.md)中安裝 。

`-s`, `--start`  
（選用） 您可以在 AWS IoT Greengrass 核心軟體安裝後啟動，並選擇性地佈建資源。  
預設：`true`