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

# 建立 AWS AppConfig 自由格式組態描述檔 （命令列）
<a name="appconfig-creating-free-form-configuration-and-profile-create-commandline"></a>

下列程序說明如何使用 AWS CLI （在 Linux 或 Windows 上） 或 AWS Tools for PowerShell 來建立 AWS AppConfig 自由格式組態描述檔。如果您願意，您可以使用 AWS CloudShell 執行下列命令。如需詳細資訊，請參閱《 AWS CloudShell使用者指南**》中的[什麼是AWS CloudShell ？](https://docs.aws.amazon.com//cloudshell/latest/userguide/welcome.html)。

**注意**  
對於託管組態存放區中 AWS AppConfig 託管的自由格式組態，您可以`hosted`為位置 URI 指定 。

**使用 建立組態設定檔 AWS CLI**

1. 開啟 AWS CLI。

1. 執行下列命令來建立自由格式組態描述檔。

------
#### [ Linux ]

   ```
   aws appconfig create-configuration-profile \
     --application-id {{APPLICATION_ID}} \
     --name {{NAME}} \
     --description {{CONFIGURATION_PROFILE_DESCRIPTION}} \
     --location-uri {{CONFIGURATION_URI}} or hosted \
     --retrieval-role-arn {{IAM_ROLE_ARN}} \
     --tags {{TAGS}} \
     --validators "Content={{SCHEMA_CONTENT or LAMBDA_FUNCTION_ARN}},Type=JSON_SCHEMA or LAMBDA"
   ```

------
#### [ Windows ]

   ```
   aws appconfig create-configuration-profile ^
     --application-id {{APPLICATION_ID}} ^
     --name {{NAME}} ^
     --description {{CONFIGURATION_PROFILE_DESCRIPTION}} ^
     --location-uri {{CONFIGURATION_URI}} or hosted  ^
     --retrieval-role-arn {{IAM_ROLE_ARN}} ^
     --tags {{TAGS}} ^
     --validators "Content={{SCHEMA_CONTENT or LAMBDA_FUNCTION_ARN}},Type=JSON_SCHEMA or LAMBDA"
   ```

------
#### [ PowerShell ]

   ```
   New-APPCConfigurationProfile `
     -Name {{NAME}} `
     -ApplicationId {{APPLICATION_ID}} `
     -Description {{CONFIGURATION_PROFILE_DESCRIPTION}} `
     -LocationUri {{CONFIGURATION_URI}} or hosted `
     -RetrievalRoleArn {{IAM_ROLE_ARN}} `
     -Tag {{TAGS}} `
     -Validators "Content={{SCHEMA_CONTENT or LAMBDA_FUNCTION_ARN}},Type=JSON_SCHEMA or LAMBDA"
   ```

------

**重要**  
記下以下重要資訊。  
如果您已為 建立組態設定檔 AWS CodePipeline，則必須在 CodePipeline 中建立管道，指定 AWS AppConfig 做為*部署提供者*。您不需要執行 [在 中部署功能旗標和組態資料 AWS AppConfig](deploying-feature-flags.md)。不過，您必須將用戶端設定為接收應用程式組態更新，如中所述[在沒有 AWS AppConfig 代理程式的情況下擷取組態資料](about-data-plane.md)。如需建立指定 AWS AppConfig 做為部署提供者的管道的相關資訊，請參閱*AWS CodePipeline 《 使用者指南*》中的[教學課程：建立使用 AWS AppConfig 做為部署提供者的管道](https://docs.aws.amazon.com/codepipeline/latest/userguide/tutorials-AppConfig.html)。
如果您在 AWS AppConfig 託管組態存放區中建立組態，您可以使用 [CreateHostedConfigurationVersion](https://docs.aws.amazon.com//appconfig/2019-10-09/APIReference/API_CreateHostedConfigurationVersion.html) API 操作來建立新的組態版本。若要檢視此 API 操作 AWS CLI 的詳細資訊和範例命令，請參閱《 *AWS CLI 命令參考*》中的 [create-hosted-configuration-version](https://docs.aws.amazon.com/cli/latest/reference/appconfig/create-hosted-configuration-version.html)。

繼續執行「[在 中部署功能旗標和組態資料 AWS AppConfig](deploying-feature-flags.md)」。