本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。
# 管理 Windows VSS 型 EBS 快照的 VSS 元件套件
在建立 VSS 型 EBS 快照之前，請確定您的 Windows 執行個體已安裝最新版本的 VSS 元件套件。有幾種方式可以將 `AwsVssComponents` 套件安裝到現有執行個體上，如下所示：
+ (建議) [執行 AWSEC2-VssInstallAndSnapshot 命令文件 (建議採納)](create-vss-snapshots-ssm.md#create-with-AWSEC2-VssInstallAndSnapshot)。這會在每次執行時視需要自動安裝或更新。
+ [在 EC2 Windows 執行個體上手動安裝 VSS 元件](#install-vss-comps).
+ [更新 EC2 Windows 執行個體上的 VSS 元件套件](#update-vss-comps).
您也可以使用 EC2 Image Builder 建立 AMI，以使用 `aws-vss-components-windows` 受管元件安裝映像的 `AwsVssComponents` 套件。受管元件使用 AWS Systems Manager Distributor 來安裝套件。Image Builder 建立映像後，您從相關聯 AMI 啟動的每個執行個體都會安裝 VSS 套件。如需如何在安裝 VSS 套件的情況下建立 AMI 的詳細資訊，請參閱 *EC2 Image Builder 使用者指南*中的 [Windows 的 Distributor 套件受管元件](https://docs.aws.amazon.com/imagebuilder/latest/userguide/mgdcomponent-distributor-win.html)。
**Topics**
+ [手動安裝](#install-vss-comps)
+ [更新元件](#update-vss-comps)
## 在 EC2 Windows 執行個體上手動安裝 VSS 元件
您的 EC2 Windows 執行個體須已安裝 VSS 元件，您才能使用 Systems Manager 建立應用程式一致快照。如果您不執行 `AWSEC2-VssInstallAndSnapshot` 命令文件，以便在每次建立應用程式一致快照時自動安裝或更新套件，則必須手動安裝套件。
如果您打算使用以下其中一種方法，從 EC2 執行個體建立應用程式一致快照，也必須手動安裝。
+ 使用 建立 VSS 快照 AWS Backup
+ 使用 Amazon Data Lifecycle Manager 建立 VSS 快照
如果您需要執行手動安裝，我們建議您使用最新的 AWS VSS 元件套件來改善 EC2 Windows 執行個體上應用程式一致性快照的可靠性和效能。
**注意**
若要在建立應用程式一致快照時自動安裝或更新 `AwsVssComponents` 套件，建議您使用 Systems Manager 來執行 `AWSEC2-VssInstallAndSnapshot` 文件。如需詳細資訊，請參閱[執行 AWSEC2-VssInstallAndSnapshot 命令文件 (建議採納)](create-vss-snapshots-ssm.md#create-with-AWSEC2-VssInstallAndSnapshot)。
若要在 Amazon EC2 Windows 執行個體上安裝 VSS 元件，請依照適用您偏好之環境的步驟執行。
------
#### [ Console ]
**使用 SSM Distributor 安裝 VSS 元件**
1. 在 https：//[https://console.aws.amazon.com/systems-manager/](https://console.aws.amazon.com/systems-manager/) 開啟 AWS Systems Manager 主控台。
1. 在導覽窗格中，選擇 **執行命令**。
1. 選擇 **執行命令**。
1. 在 **Command document (命令文件)** 清單中，選擇 **AWS-ConfigureAWSPackage** 旁的按鈕。
1. 在 **Command parameters (命令參數)** 中，執行以下操作：
1. 驗證 **Action (動作)** 設為 **Install (安裝)**。
1. 對於**名稱**，輸入 `AwsVssComponents`。
1. 在**版本**中，輸入版本或將欄位留空，以便 Systems Manager 安裝最新版本。
1. 在 **Targets (目標)** 中，手動指定標籤或選取執行個體，以識別您要執行這項操作的執行個體。
**注意**
如果您選取手動選取執行個體，但您預期看到的執行個體並未出現在清單上，請參閱 [https://docs.aws.amazon.com/systems-manager/latest/userguide/troubleshooting-remote-commands.html#where-are-instances](https://docs.aws.amazon.com/systems-manager/latest/userguide/troubleshooting-remote-commands.html#where-are-instances) 使用者指南*中的AWS Systems Manager 我的執行個體在哪裡？*以取得故障診斷秘訣。
1. 對於 **Other parameters (其他參數)**：
+ (選用) 在 **Comment (註解)** 中，輸入此命令的相關資訊。
+ 在 **Timeout (seconds) (逾時 (秒))** 中，指定在命令執行全面失敗之前，系統要等候的秒數。
1. (選用) 在 **Rate control (速率控制)** 中：
+ 在 **Concurrency (並行)** 中，指定可同時執行命令的執行個體數目或百分比。
**注意**
如果您已透過選取 Amazon EC2 標籤來選取目標，而且不確定有多少執行個體會使用所選的標籤，請指定百分比來限制可同時執行文件的執行個體數目。
+ 在 **Error threshold (錯誤閾值)** 中，指定在特定數目或百分比之執行個體上的命令失敗之後，停止在其他執行個體上執行命令。例如，如果您指定三個錯誤，則 Systems Manager 會在收到第四個錯誤時停止傳送命令。仍在處理命令的執行個體也可能會傳送錯誤。
1. (選用) 在 **Output options (輸出選項)** 區段中，如果您想要將命令輸出儲存至檔案，請選取 **Enable writing to an S3 bucket (啟用寫入至 S3 儲存貯體)** 旁的按鈕。指定儲存貯體和 (選用) 字首 (資料夾) 名稱。
**注意**
授予能力以將資料寫入至 S3 儲存貯體的 S3 許可，會是指派給執行個體之執行個體描述檔的許可，而不是執行此工作之使用者的許可。如需詳細資訊，請參閱《AWS Systems Manager 使用者指南》**中的[設定 EC2 執行個體許可](https://docs.aws.amazon.com/systems-manager/latest/userguide/setup-instance-permissions.html#instance-profile-add-permissions)。
1. (選用) 指定 **SNS notifications (SNS 通知)** 的選項。
如需針對執行命令設定 Amazon SNS 通知的資訊，請參閱[針對 AWS Systems Manager設定 Amazon SNS 通知](https://docs.aws.amazon.com/systems-manager/latest/userguide/monitoring-sns-notifications.html)。
1. 選擇**執行**。
------
#### [ AWS CLI ]
透過以下程序，即可使用 `AwsVssComponents` 中的執行命令來下載 AWS CLI套件，並在執行個體上進行安裝。該套件安裝兩個元件：VSS 請求程式和 VSS 供應程式。系統會將這些元件複製到執行個體上的目錄，接著註冊供應程式 DLL，以將其做為 VSS 供應程式。
**若要安裝 VSS 套件**
執行下列命令，藉此下載並安裝 Systems Manager 所需的 VSS 元件。
```
aws ssm send-command \
--document-name "AWS-ConfigureAWSPackage" \
--instance-ids "i-1234567890abcdef0" \
--parameters '{"action":["Install"],"name":["AwsVssComponents"]}'
```
------
#### [ PowerShell ]
透過以下程序，即可使用 Tools for Windows PowerShell 中的執行命令來下載 `AwsVssComponents` 套件，並在執行個體上進行安裝。該套件安裝兩個元件：VSS 請求程式和 VSS 供應程式。系統會將這些元件複製到執行個體上的目錄，接著註冊供應程式 DLL，以將其做為 VSS 供應程式。
**若要安裝 VSS 套件**
執行下列命令，藉此下載並安裝 Systems Manager 所需的 VSS 元件。
```
Send-SSMCommand `
-DocumentName "AWS-ConfigureAWSPackage" `
-InstanceId "i-1234567890abcdef0" `
-Parameter @{'action'='Install';'name'='AwsVssComponents'}
```
------
### 驗證 AWS VSS 元件上的簽章
請使用下列程序驗證 `AwsVssComponents` 套件上的簽章。
1. 連接至 Windows 執行個體。如需詳細資訊，請參閱[使用 RDP 連線至您的 Windows 執行個體](connecting_to_windows_instance.md)。
1. 導覽至 C:\$1Program Files\$1Amazon\$1AwsVssComponents。
1. 開啟 `ec2-vss-agent.exe` 的內容選單 (按一下右鍵)，然後選擇**屬性**。
1. 導覽至**數位簽章**索引標籤，並確認簽署者的名稱是否為 Amazon Web Services Inc.
1. 使用上述步驟驗證 `Ec2VssInstaller` 和 `Ec2VssProvider.dll` 上的簽章。
## 更新 EC2 Windows 執行個體上的 VSS 元件套件
建議維持將 VSS 元件更新為最新的建議版本。在新版 `AwsVssComponents` 套件發行時，您可以透過多種不同方式更新元件。
**更新方法**
+ 您可以在發行新版本的 AWS VSS 元件[在 EC2 Windows 執行個體上手動安裝 VSS 元件](#install-vss-comps)時重複中所述的步驟。
+ 您可以將 Systems Manager State Manager 關聯設定為在 `AwsVssComponents` 套件可用時自動下載並安裝全新或更新後的 VSS 元件。
+ 您可以在使用 Systems Manager 執行 `AWSEC2-VssInstallAndSnapshot` 文件時，隨時在建立應用程式一致快照時自動安裝或更新 `AwsVssComponents` 套件。
**注意**
建議您使用 Systems Manager 執行 `AwsVssComponents` 命令文件，其會在建立應用程式一致快照時，自動安裝或更新 `AWSEC2-VssInstallAndSnapshot` 套件。如需詳細資訊，請參閱[執行 AWSEC2-VssInstallAndSnapshot 命令文件 (建議採納)](create-vss-snapshots-ssm.md#create-with-AWSEC2-VssInstallAndSnapshot)。
若要建立 Systems Manager State Manager 關聯，請依照適用於您偏好之環境的步驟執行。
------
#### [ Console ]
當您建立 Systems Manager State Manager 關聯時，有兩種更新 `AwsVssComponents` 套件的選項，如下所示：
**解除安裝並重新安裝**
此方法會下載並安裝套件，無需額外的先決條件。
**就地更新**
這會執行套件的就地更新，並具有下列先決條件：
+ 在執行個體上安裝的 SSM Agent 版本必須是版本 `3.3.808.0` 或更新版本。如需詳細資訊，請參閱《AWS Systems Manager 使用者指南》**中的[在適用於 Windows Server 的 EC2 執行個體上使用 SSM Agent](https://docs.aws.amazon.com/systems-manager/latest/userguide/ssm-agent-windows.html)。
+ 如果已指定，則 `AwsVssComponents` 套件版本必須是版本 `2.5.0` 或更新版本。早期版本不支援就地更新。
如果執行個體不符合這些先決條件，就地更新將會失敗。請改用**解除安裝並重新安裝**選項。
**若要建立 State Manager 關聯**
1. 在 https：//[https://console.aws.amazon.com/systems-manager/](https://console.aws.amazon.com/systems-manager/) 開啟 AWS Systems Manager 主控台。
1. 在導覽窗格中，選擇 **State Manager (狀態管理員)**。
或者，如果 Systems Manager 首頁先開啟，請開啟導覽窗格，然後選擇 **State Manager**。
1. 選擇 **Create association (建立關聯)**。
1. 在 **Name** (名稱) 欄位中，輸入描述性名稱。
1. 在**文件**清單中，選擇 **AWS-ConfigureAWSPackage**。
1. 在 **Parameters** (參數) 區段中，從 **Action** (動作) 清單中選擇 **Install** (安裝)。
1. 針對**安裝類型**，選擇**解除安裝並重新安裝**或**就地更新**。
1. 在 **Name (名稱)** 欄位中，輸入 `AwsVssComponents`。可將 **Version** (版本) 和 **Additional Arguments** (其他引數) 保留為空白。
1. 在 **Targets** (目標) 區段中，選擇一個選項。
**注意**
如果您選擇使用標籤將執行個體設為目標，且指定映射到 Linux 執行個體的標籤，則關聯會在 Windows 執行個體上執行成功，但在 Linux 執行個體上執行失敗。關聯的整體狀態會顯示為 **Failed (失敗)**。
1. 在 **Specify schedule (指定排程)** 區段中，選擇一個選項。
1. 在 **Advanced options (進階選項)** 區段中，針對 **Compliance severity (合規嚴重性)**，選擇關聯的嚴重性等級。如需詳細資訊，請參閱[了解關聯合規性](https://docs.aws.amazon.com/systems-manager/latest/userguide/compliance-about.html)。針對**變更行事曆**，請選取預先設定的變更行事曆。如需詳細資訊，請參閱 [AWS Systems Manager 變更行事曆](https://docs.aws.amazon.com/systems-manager/latest/userguide/systems-manager-change-calendar.html)。
1. 針對**比率控制**，請執行下列操作：
+ 在**並行**中，指定可同時執行命令的受管節點數目或百分比。
+ 在 **Error threshold** (錯誤閾值) 中，指定在特定數目或百分比之節點上的命令失敗之後，停止在其他受管節點上執行命令。
1. (選用) 針對**輸出選項**，若要將命令輸出儲存至檔案，請選取**啟用將輸出寫入 S3**。在方塊中輸入儲存貯體和字首 (資料夾) 名稱。
1. 選擇 **Create association** (建立關聯)，接著選擇 **Close** (關閉)。系統會嘗試在執行個體上建立關聯，並立即套用狀態。
**注意**
如果 Windows Server 的 EC2 執行個體顯示**失敗**狀態，請確認 SSM 代理程式正在執行個體上執行，並確認執行個體已設定 Systems Manager 的 AWS Identity and Access Management (IAM) 角色。如需詳細資訊，請參閱[設定 AWS Systems Manager](https://docs.aws.amazon.com/systems-manager/latest/userguide/systems-manager-setting-up-ec2.html)。
------
#### [ AWS CLI ]
使用 [create-association](https://docs.aws.amazon.com/cli/latest/reference/ssm/create-association.html) 命令，以依照排程更新 Distributor 套件，而無需讓相關聯的應用程式離線。只會取代套件中的新檔案或更新檔案。
**若要建立 State Manager 關聯**
執行下列命令以建立關聯。`--name` 值 (文件名稱) 一律為 `AWS-ConfigureAWSPackage`。以下命令會使用索引鍵 `InstanceIds` 來指定目標執行個體。
```
aws ssm create-association \
--name "AWS-ConfigureAWSPackage" \
--parameters action=Install,installationType="Uninstall and reinstall",name=AwsVssComponents \
--targets Key=InstanceIds,Values=i-1234567890abcdef0,i-000011112222abcde
```
------
#### [ PowerShell ]
**若要建立 State Manager 關聯**
使用 [New-SSMAssociation](https://docs.aws.amazon.com/powershell/latest/reference/items/New-SSMAssociation.html) cmdlet。
```
New-SSMAssociation `
-Name "AWS-ConfigureAWSPackage" `
-Parameter @{
"action" = "Install"
"installationType" = "Uninstall and reinstall"
"name" = "AwsVssComponents"
} `
-Target @{
"Key" = "InstanceIds"
"Values" = @("i-1234567890abcdef0", "i-000011112222abcde")
}
```
------