本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。
# 適用於映像建置器 Windows 映像的 Distributor 套件受管元件應用程式安裝
AWS Systems Manager Distributor 可協助您封裝軟體並將其發佈至 AWS Systems Manager 受管節點。您可以封裝和發佈自己的軟體，或使用 Distributor 尋找和發佈 AWS提供的代理程式軟體套件。如需 Systems Manager Distributor 的詳細資訊，請參閱*AWS Systems Manager 《 使用者指南*》中的 [AWS Systems Manager Distributor](https://docs.aws.amazon.com/systems-manager/latest/userguide/distributor.html)。
**Distributor 的受管元件**
下列 Image Builder 受管元件使用 AWS Systems Manager Distributor 在 Windows 執行個體上安裝應用程式套件。
+ `distributor-package-windows` 受管元件會使用 AWS Systems Manager Distributor 安裝您在 Windows 映像建置執行個體上指定的應用程式套件。若要在配方中包含此元件時設定參數，請參閱 [將 `distributor-package-windows`設定為獨立元件](#mgdcomponent-distributor-config-standalone)。
+ `aws-vss-components-windows` 元件會使用 AWS Systems Manager Distributor 在您的 Windows 映像建置執行個體上安裝`AwsVssComponents`套件。若要在配方中包含此元件時設定參數，請參閱 [將 `aws-vss-components-windows`設定為獨立元件](#mgdcomponent-vss-config-standalone)。
如需如何在映像建置器配方中使用受管元件的詳細資訊，請參閱 [建立新的映像配方版本](create-image-recipes.md) 以取得映像配方，或參閱 [建立新的容器配方版本](create-container-recipes.md) 以取得容器配方。如需`AwsVssComponents`套件的詳細資訊，請參閱《*Amazon EC2 使用者指南*》中的[建立 VSS 應用程式一致性快照](https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/application-consistent-snapshots.html)。
## 先決條件
在使用依賴 Systems Manager Distributor 來安裝應用程式套件的映像建置器元件之前，您必須確保符合下列先決條件。
+ 使用 Systems Manager Distributor 在執行個體上安裝應用程式套件的映像建置器元件需要許可才能呼叫 Systems Manager API。在映像建置器配方中使用元件之前，您必須建立授予許可的 IAM 政策和角色。若要設定許可，請參閱 [設定 Systems Manager Distributor 許可](#mgdcomponent-distributor-permissions)。
**注意**
Image Builder 目前不支援重新啟動執行個體的 Systems Manager Distributor 套件。例如，不允許 `AWSNVMe`、 `AWSPVDrivers`和 `AwsEnaNetworkDriver` Distributor 套件重新啟動執行個體，以此類推。
## 設定 Systems Manager Distributor 許可
元件`distributor-package-windows`和使用它的其他元件，例如 `aws-vss-components-windows`，需要建置執行個體的額外許可才能執行。建置執行個體必須能夠呼叫 Systems Manager API，以開始經銷商安裝並輪詢結果。
請遵循 中的這些程序 AWS 管理主控台 來建立自訂 IAM 政策和角色，以授予 Image Builder 元件從建置執行個體安裝 Systems Manager Distributor 套件的許可。
**步驟 1：建立政策**
建立經銷商許可的 IAM 政策。
1. 在 [https://console.aws.amazon.com/iam/](https://console.aws.amazon.com/iam/) 中開啟 IAM 主控台。
1. 在導覽窗格中，選擇 **Policies (政策)**，然後選擇 **Create policy (建立政策)**。
1. 在**建立政策**頁面上，選擇 **JSON** 索引標籤，然後使用下列 JSON 政策取代預設內容、視需要取代分割區、區域和帳戶 ID，或使用萬用字元。
------
#### [ JSON ]
****
```
{
"Version":"2012-10-17",
"Statement": [
{
"Sid": "AllowDistributorSendCommand",
"Effect": "Allow",
"Action": "ssm:SendCommand",
"Resource": [
"arn:aws:ssm:*::document/AWS-ConfigureAWSPackage",
"arn:aws:ec2:*:111122223333:instance/*"
]
},
{
"Sid": "AllowGetCommandInvocation",
"Effect": "Allow",
"Action": "ssm:GetCommandInvocation",
"Resource": "*"
}
]
}
```
------
1. 選擇 **Review policy (檢閱政策)**。
1. 在 **Name (名稱)** 中，輸入名稱來識別此政策，例如 `InvokeDistributor` 或另一個您喜好的名稱。
1. (選用) 對於 **Description (描述)**，輸入角色目的之描述。
1. 選擇 **Create policy** (建立政策)。
**步驟 2：建立角色**
為 Distributor 許可建立 IAM 角色。
1. 從 IAM 主控台導覽窗格中，選擇**角色**，然後選擇**建立角色**。
1. 在 **Select type of trusted entity** (選取可信任執行個體類型) 下，選擇 **AWS 服務**。
1. 緊接在 **Choose the service that will use this role (選擇將使用此角色的服務)** 下，選擇 **EC2**，然後選擇 **Next: Permissions (下一步：許可)**。
1. 在 **Select your use case (選取您的使用案例)** 下，選取 **EC2**，然後選取 **Next: Permissions (下一步：許可)**。
1. 在政策清單中，選取 **AmazonSSMManagedInstanceCore** 旁的核取方塊。(如果您需要縮減清單，請在搜尋方塊中輸入 `SSM`。)
1. 在此政策清單中，選擇 **EC2InstanceProfileForImageBuilder** 旁的方塊。(如果您需要縮減清單，請在搜尋方塊中輸入 `ImageBuilder`。)
1. 選擇 **Next: Tags (下一步：標籤)**。
1. （選用） 新增一或多個標籤索引鍵值對來組織、追蹤或控制此角色的存取，然後選擇**下一步：檢閱**。
1. 對於 **Role name (角色名稱)**，輸入角色的名稱，例如 `InvokeDistributor` 或另一個您喜好的名稱。
1. (選用) 對於 **Role description (角色描述)**，將預設文字以此角色目的描述取代。
1. 選擇 **Create role** (建立角色)。系統會讓您回到 **Roles (角色)** 頁面。
**步驟 3：將政策連接至角色**
設定經銷商許可的最後一步是將 IAM 政策連接至 IAM 角色。
1. 在 ****IAM 主控台的角色頁面中，選擇您剛建立的角色。角色的 **Summary (摘要)** 頁面隨即開啟。
1. 選擇 **Attach policies (連接政策)**。
1. 搜尋您在上一個程序中建立的政策，然後選取名稱旁的核取方塊。
1. 選擇**連接政策**。
針對包含使用 Systems Manager Distributor 之元件的任何映像，在映像建置器基礎設施組態資源中使用此角色。如需詳細資訊，請參閱[建立基礎架構組態](create-infra-config.md)。
## 將 `distributor-package-windows`設定為獨立元件
若要在配方中使用 `distributor-package-windows`元件，請設定下列參數來設定要安裝的套件。
**注意**
在配方中使用 `distributor-package-windows`元件之前，您必須確定[先決條件](#mgdcomponent-distributor-prereq)符合所有 。
+ **動作** （必要） – 指定是否要安裝或解除安裝套件。有效值包括 `Install` 與 `Uninstall`。值預設為 `Install`。
+ **PackageName** （必要） – 要安裝或解除安裝的 Distributor 套件名稱。如需有效套件名稱的清單，請參閱 [尋找經銷商套件](#mgdcomponent-distributor-find-pkg)。
+ **PackageVersion** （選用） – 要安裝的 Distributor 套件版本。PackageVersion 預設為建議的版本。
+ **AdditionalArguments** （選用） – JSON 字串，其中包含要提供給指令碼以安裝、解除安裝或更新套件的其他參數。如需詳細資訊，請參閱 **Systems Manager Command 文件外掛程式參考**頁面的 [aws：configurePackage](https://docs.aws.amazon.com/systems-manager/latest/userguide/documents-command-ssm-plugin-reference.html#aws-configurepackage) **Inputs** 區段中的 **additionalArguments**。
## 將 `aws-vss-components-windows`設定為獨立元件
當您在配方中使用 `aws-vss-components-windows`元件時，您可以選擇將 `PackageVersion` 參數設定為使用特定版本的`AwsVssComponents`套件。當您離開此參數時，元件會預設為使用建議的`AwsVssComponents`套件版本。
**注意**
在配方中使用 `aws-vss-components-windows`元件之前，您必須確定[先決條件](#mgdcomponent-distributor-prereq)符合所有 。
## 尋找經銷商套件
Amazon 和第三方提供您可以使用 Systems Manager Distributor 安裝的公有套件。
若要在 中檢視可用的套件 AWS 管理主控台，請登入 [AWS Systems Manager 主控台](https://console.aws.amazon.com/systems-manager/;)，然後從導覽窗格中選擇**經銷商**。**經銷商**頁面會顯示您可用的所有套件。如需使用 列出可用套件的詳細資訊 AWS CLI，請參閱*AWS Systems Manager 《 使用者指南*》中的[檢視套件 （命令列）](https://docs.aws.amazon.com/systems-manager/latest/userguide/distributor-view-packages.html)。
您也可以建立自己的私有 Systems Manager Distributor 套件。如需詳細資訊，請參閱*AWS Systems Manager 《 使用者指南*》中的[建立套件](https://docs.aws.amazon.com/systems-manager/latest/userguide/distributor-working-with-packages-create.html)。