本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。
使用 Systems Manager 命令文件來建立VSS以 為基礎的快照
您可以使用 AWS Systems Manager 命令文件來建立VSS以 為基礎的快照。下列內容會介紹可用的命令文件，以及文件用來建立快照的執行期參數。
在您使用任何 Systems Manager 命令文件之前，請確保您已符合所有 建立 Windows VSS 型 EBS 快照的先決條件。
Systems Manager VSS快照文件的參數
除非另有說明，否則建立VSS快照的 Systems Manager 文件都使用下列參數：
- AmiName （字串，選用）
-
如果 CreateAmi選項設定為 True，請指定AMI備份建立的 名稱。
- description (字串，選用)
-
指定此程序所建立之快照或映像的描述。
- CollectDiagnosticLogs （字串，選用）
-
若要在快照和AMI建立步驟期間收集更多資訊，請將此參數設定為「True」。此參數的預設值為 "False"。合併的診斷日誌會儲存為執行個體上下列位置的.zip格式封存檔：
C:\ProgramData\Amazon\AwsVss\Logs\timestamp.zip
- CopyOnly （字串，選用）
-
如果您除了 之外使用原生SQL伺服器備份 AWS VSS，執行僅限複製備份可防止 AWS VSS中斷原生差異備份鏈。若要執行僅限複製備份操作，請將此參數設定為 True。
此參數的預設值為 False，這會導致 AWS VSS 執行完整的備份操作。
- CreateAmi （字串，選用）
-
若要建立VSS以 為基礎的 Amazon Machine Image （AMI） 來備份執行個體，請將此參數設定為 True。此參數的預設值為 False，這會改為使用EBS快照備份執行個體。
如需AMI從執行個體建立 的詳細資訊，請參閱 建立 Amazon EBS 後端單AMI。
- executionTimeout （字串，選用）
-
指定在執行個體上執行快照建立程序或從AMI執行個體建立 的秒數上限。增加此逾時可讓命令等待更長的時間VSS，以開始凍結並完整標記其建立的資源。此逾時僅適用於快照或AMI建立步驟。安裝或更新 AwsVssComponents 套件的初始步驟不包含在逾時中。
- ExcludeBootVolume （字串，選用）
-
若您建立快照，此設定會從備份程序中排除開機磁碟區。若要從快照中排除開機磁碟區，請將 ExcludeBootVolume設定為 True，將 CreateAmi設定為 False。
如果您AMI為備份建立 ，此參數應設定為 False。此參數的預設值為 False。
- NoWriters （字串，選用）
-
若要從快照程序排除應用程式VSS寫入器，請將此參數設定為 True。排除應用程式VSS寫入器可協助您解決與第三方VSS備份元件的衝突。此參數的預設值為 False。
如果 SaveVssMetadata是 True，則此參數必須設定為 False。
- SaveVssMetadata （字串，選用）
-
若要在每個快照期間儲存VSS中繼資料檔案，請將此參數設定為 True。預設值為 False。VSS 中繼資料檔案有助於提供備份操作中包含哪些元件或寫入器的洞見，以及每個元件的相關檔案。
中繼資料檔案的名稱中具有相關聯的快照集 ID。您可以在執行個體的下列位置找到它們：
C:\ProgramData\Amazon\AwsVss\VssMetadata\
- tags (字串，選用)
-
建議您標記快照和映像，以協助您尋找和管理資源，例如從快照清單中還原磁碟區。系統會新增 Name金鑰，其中包含空白值，您可以在其中指定要套用至輸出快照或映像的名稱。
如果您想要指定其他標籤，請分開中間有分號的標籤。例如：Key=Environment,Value=Test;Key=User,Value=TestUser1。
根據預設，系統會為 VSS 型快照和映像新增下列預留標籤。
-
裝置 – 對於VSS以 為基礎的快照，這是快照擷取之EBS磁碟區的裝置名稱。
-
AppConsistent – 此標籤表示成功建立 VSS 型快照或 AMI。
-
AwsVssConfig – 這會識別快照AMIs，以及VSS已啟用時建立的快照。標籤包含 AwsVssComponents版本和快照集 ID 等中繼資訊。
- VssVersion （字串，選用）
-
在使用 AWSEC2-VssInstallAndSnapshot 文件的情況下，您可以指定 VssVersion 參數以在執行個體上安裝特定版本的 AwsVssComponents 套件。將此參數保留空白，以安裝建議的預設版本。
如果已安裝指定版本的 AwsVssComponents 套件，則指令碼會略過安裝步驟，並繼續進行備份步驟。如需 AwsVssComponents 套件版本和操作支援的清單，請參閱AWS VSS 解決方案版本歷史記錄。
執行 Systems Manager VSS快照命令文件
您可以使用 AWS Systems Manager 命令文件建立VSS以 為基礎的EBS快照，如下所示。
當您使用 AWS Systems Manager 執行AWSEC2-VssInstallAndSnapshot文件時，指令碼會執行下列步驟。
-
該指令碼會先在執行個體上安裝或更新 AwsVssComponents 套件，具體取決於是否已安裝執行個體。
-
指令碼會在完成第一個步驟後，建立應用程式一致快照。
若要執行 AWSEC2-VssInstallAndSnapshot 文件，請依照適用於您偏好之環境的步驟執行。
- Console
-
從主控台建立VSS型EBS快照
在 開啟 AWS Systems Manager 主控台https://console.aws.amazon.com/systems-manager/。
-
從導覽窗格中選取執行命令。這會顯示您帳戶中目前正在執行的命令清單 (若適用)。
-
選擇 執行命令。這會開啟您具有存取權限的命令文件清單。
-
從命令文件清單中選取 AWSEC2-VssInstallAndSnapshot。若要簡化結果，可輸入全部或部分文件名稱。您也可以依擁有者、平台類型或標籤進行篩選。
在您選取命令文件時，系統會將詳細資訊填入清單下方。
-
從文件版本清單中選取 Default version at runtime。
-
設定 命令參數，以定義AWSEC2-VssInstallAndSnapshot如何安裝AwsVssComponents套件並使用VSS快照或 備份AMI。如需參數詳細資訊，請參閱 Systems Manager VSS快照文件的參數。
-
針對目標選取，手動指定標籤或選取執行個體，以識別要執行這項操作的執行個體。
如果您手動選取執行個體，但預期看到的執行個體並未出現在清單中，請參閱我的執行個體在哪裡？，以取得疑難排解秘訣。
-
如需定義 Systems Manager Run Command 行為的其他參數 (例如速率控制)，請依照從主控台執行命令中的說明輸入值。
-
選擇執行。
如果成功，命令會將新的EBS快照填入快照清單。您可以透過搜尋您指定的標籤，或搜尋 ，在快照清單中找到這些EBS快照AppConsistent。如果命令執行失敗，請檢視 Systems Manager 命令輸出的詳細資訊，以了解執行失敗的原因。如果命令成功完成，但特定磁碟區備份失敗，您可以在EBS磁碟區清單中疑難排解失敗。
- AWS CLI
-
您可以在 中執行下列命令 AWS CLI ，以建立VSS以EBS快照為基礎的快照，並取得快照建立的狀態。
建立VSS型EBS快照
執行下列命令以建立 VSS 型EBS快照。若要建立快照，您必須使用 --instance-ids 參數來識別執行個體。如需您可以查看之其他參數的詳細資訊，請參閱 Systems Manager VSS快照文件的參數。
aws ssm send-command \
--document-name "AWSEC2-VssInstallAndSnapshot" \
--instance-ids "i-01234567890abcdef" \
--parameters '{"ExcludeBootVolume":["False"],"description":["Description"],"tags":["Key=key_name,Value=tag_value"],"VssVersion":[""]}'
如果成功，命令文件會將新的EBS快照填入快照清單。您可以透過搜尋您指定的標籤，或搜尋 ，在快照清單中找到這些EBS快照AppConsistent。如果命令執行失敗，請檢視命令輸出的詳細資訊，以了解執行失敗的原因。
取得命令狀態
若要取得快照目前的狀態，請使用從 send-command 傳回的命令 ID 執行下列命令。
aws ssm get-command-invocation
--instance-ids "i-01234567890abcdef" \
--command-id "a1b2c3d4-5678-90ab-cdef-EXAMPLE11111" \
--plugin-name "CreateVssSnapshot"
- PowerShell
-
使用 執行下列命令 AWS Tools for Windows PowerShell ，以建立VSS以 為基礎的EBS快照，並取得建立輸出的目前執行期狀態。指定前面清單中描述的參數，以修改快照處理程序的行為。
使用 Tools for Windows 建立VSS型EBS快照 PowerShell
執行下列命令以建立VSS以 為基礎的EBS快照或 AMIs。
Send-SSMCommand -DocumentName "AWSEC2-VssInstallAndSnapshot" -InstanceId "i-01234567890abcdef" -Parameter @{'ExcludeBootVolume'='False';'description'='a_description'
;'tags'='Key=key_name,Value=tag_value';'VssVersion'=''}
取得命令狀態
若要取得快照目前的狀態，請使用從 Send-SSMCommand 傳回的命令 ID 執行下列命令。
Get-SSMCommandInvocationDetail -InstanceId "i-01234567890abcdef" -CommandId "a1b2c3d4-5678-90ab-cdef-EXAMPLE11111" -PluginName "CreateVssSnapshot"
如果成功，命令會將新的EBS快照填入快照清單。您可以透過搜尋您指定的標籤，或搜尋 ，在快照清單中找到這些EBS快照AppConsistent。如果命令執行失敗，請檢視命令輸出的詳細資訊，以了解執行失敗的原因。
若要執行 AWSEC2-CreateVssSnapshot 文件，請依照適用於您偏好之環境的步驟執行。
- Console
-
從主控台建立VSS型EBS快照
在 開啟 AWS Systems Manager 主控台https://console.aws.amazon.com/systems-manager/。
-
從導覽窗格中選取執行命令。這會顯示您帳戶中目前正在執行的命令清單 (若適用)。
-
選擇 執行命令。這會開啟您具有存取權限的命令文件清單。
-
從命令文件清單中選取 AWSEC2-CreateVssSnapshot。若要簡化結果，可輸入全部或部分文件名稱。您也可以依擁有者、平台類型或標籤進行篩選。
在您選取命令文件時，系統會將詳細資訊填入清單下方。
-
從文件版本清單中選取 Default version at runtime。
-
設定 命令參數，以定義AWSEC2-CreateVssSnapshot如何使用VSS快照或 備份AMI。如需參數詳細資訊，請參閱 Systems Manager VSS快照文件的參數。
-
針對目標選取，手動指定標籤或選取執行個體，以識別要執行這項操作的執行個體。
如果您手動選取執行個體，但預期看到的執行個體並未出現在清單中，請參閱我的執行個體在哪裡？，以取得疑難排解秘訣。
-
如需定義 Systems Manager Run Command 行為的其他參數 (例如速率控制)，請依照從主控台執行命令中的說明輸入值。
-
選擇執行。
如果成功，命令會將新的EBS快照填入快照清單。您可以透過搜尋您指定的標籤，或搜尋 ，在快照清單中找到這些EBS快照AppConsistent。如果命令執行失敗，請檢視 Systems Manager 命令輸出的詳細資訊，以了解執行失敗的原因。如果命令成功完成，但特定磁碟區備份失敗，您可以在EBS磁碟區清單中疑難排解失敗。
- AWS CLI
-
您可以在 中執行下列命令 AWS CLI ，以建立VSS以 為基礎的EBS快照。
建立VSS型EBS快照
執行下列命令以建立 VSS 型EBS快照。若要建立快照，您必須使用 --instance-ids 參數來識別執行個體。如需您可以查看之其他參數的詳細資訊，請參閱 Systems Manager VSS快照文件的參數。
aws ssm send-command \
--document-name "AWSEC2-CreateVssSnapshot" \
--instance-ids "i-01234567890abcdef" \
--parameters '{"ExcludeBootVolume":["False"],"description":["Description"],"tags":["Key=key_name,Value=tag_value"]}'
如果成功，命令文件會將新的EBS快照填入快照清單。您可以透過搜尋您指定的標籤，或搜尋 ，在快照清單中找到這些EBS快照AppConsistent。如果命令執行失敗，請檢視命令輸出的詳細資訊，以了解執行失敗的原因。
- PowerShell
-
使用 執行下列命令 AWS Tools for Windows PowerShell ，以建立VSS以 為基礎的EBS快照。
使用 Tools for Windows 建立VSS型EBS快照 PowerShell
執行下列命令以建立 VSS 型EBS快照。若要建立快照，您必須使用 InstanceId 參數來識別執行個體。您可以指定多個執行個體，藉此為其建立快照。如需您可以查看之其他參數的詳細資訊，請參閱 Systems Manager VSS快照文件的參數。
Send-SSMCommand -DocumentName AWSEC2-CreateVssSnapshot -InstanceId "i-01234567890abcdef" -Parameter @{'ExcludeBootVolume'='False';'description'='a_description'
;'tags'='Key=key_name,Value=tag_value'}
如果成功，命令會將新的EBS快照填入快照清單。您可以透過搜尋您指定的標籤，或搜尋 ，在快照清單中找到這些EBS快照AppConsistent。如果命令執行失敗，請檢視命令輸出的詳細資訊，以了解執行失敗的原因。如果命令成功完成，但特定的磁碟區備份失敗，您可以在EBS快照清單中對失敗進行故障診斷。
您可以使用上一節所述的任何命令列程序來建立 VSS 型快照。命令文件 (AWSEC2-VssInstallAndSnapshot 或 AWSEC2-CreateVssSnapshot) 必須在叢集中的主節點上執行。次要節點上的文件將會失敗，因為其無法存取共用磁碟。如果您的主要和次要變更是動態變更，您可以在多個節點上執行 AWS Systems Manager Run Command 文件，並預期該命令將在主要節點上成功，並在次要節點上失敗。
若要自動備份，您可以建立使用 AWSEC2-VssInstallAndSnapshot 文件的 AWS Systems Manager 維護時段任務。如需詳細資訊，請參閱《AWS Systems Manager 使用者指南》中的 使用維護時段 Windows (主控台)。
