對 vCenter Server 安裝進行從 Windows 到應用裝置的 CLI 移轉

您可以使用 CLI 安裝程式將 vCenter Server 或 Platform Services Controller 從 Windows 自動移轉至應用裝置。

安裝程式 ISO 檔案包含 JSON 檔案的範例範本，而 JSON 檔案包含將 vCenter Server 或 Platform Services Controller 執行個體從 Windows 移轉至應用裝置所需的最低組態參數。範例範本位於 vcsa-cli-installer/templates/migrate 目錄。

備註： 在移轉使用外部 Platform Services Controller 的 vCenter Server 部署之前，必須先將外部 Platform Services Controller 聚合至內嵌式 Platform Services Controller，然後再執行移轉。請參閱知識庫文章 知識庫 68137。

將 vCenter Server 安裝從 Windows 移轉至應用裝置的 CLI 工作：

1. 下載並掛接 vCenter Server 安裝程式。
2. 在來源 Windows 機器上下載並執行 VMware Migration Assistant。
3. 準備 JSON 組態檔以進行 CLI 移轉。
4. 請在執行移轉前執行預先檢查。
5. 執行將 vCenter Server從 Windows 至應用裝置的 CLI 移轉。

您可以使用不同的 JSON 檔案多次執行 CLI 安裝程式，從而執行多個 CLI 移轉，也可以批次模式同時執行 CLI 移轉。

重要： 您登入要從中執行 CLI 安裝程式的機器所使用的使用者名稱、 vCenter Server Appliance 安裝程式的路徑、JSON 組態檔的路徑，以及 JSON 組態檔中的字串值 (包括密碼)，都必須僅包含 ASCII 字元。不支援延伸的 ASCII 和非 ASCII 字元。

準備 JSON 組態檔以進行 CLI 移轉

使用 CLI 將來源 vCenter Server 安裝移轉至目標 vCenter Server Appliance 時，您必須針對新應用裝置準備含有組態值的 JSON 範本。

您可以透過設定安裝程式 ISO 檔案可用範本中的組態參數值，來將 vCenter Server或 Platform Services Controller 執行個體從 Windows 移轉至vCenter Server Appliance。範本中不包含的組態參數會設為預設值。您可以在範本中新增組態參數，以針對移轉規格設定其值。

vcsa-cli-installer/templates/migrate 目錄包含透過 CLI 將 vCenter Server 6.7 移轉至應用裝置的移轉範本範例。

如需組態參數及其說明的完整清單，請導覽至作業系統安裝程式子目錄，然後執行 vcsa-deploy migrate --template-help 命令。

重要： 您登入要從中執行 CLI 安裝程式的機器所使用的使用者名稱、 vCenter Server Appliance 安裝程式的路徑、JSON 組態檔的路徑，以及 JSON 組態檔中的字串值 (包括密碼)，都必須僅包含 ASCII 字元。不支援延伸的 ASCII 和非 ASCII 字元。

若要執行批次移轉，請將定義部署的 JSON 範本放置在單一目錄中。叫用時，CLI 安裝程式會使用 JSON 範本中所定義的拓撲將現有部署移轉至新 vCenter Server 版本。

必要條件

確認您的環境滿足移轉要求。請參閱 將 vCenter Server 部署移轉至 vCenter Server Appliance 部署的系統需求。

準備環境以進行移轉。請參閱準備移轉。

程序

1. 開啟位於 vcsa-cli-installer/templates 目錄中的 migrate 子資料夾。
2. 將移轉範本從 migrate 子資料夾複製到您的工作區。對於 vCenter Server6.7，請使用 migrate/winvc6.7/ 資料夾。
3. 在文字編輯器中開啟您使用案例的範本檔案。
   為確保 JSON 組態檔的語法正確，請使用 JSON 編輯器。
4. 填寫必要組態參數的值，並選擇性地輸入其他參數及其值。
   重要： 若要設定包含反斜線 (\) 或引號 (") 字元的值，您必須在字元前面加上反斜線 (\) 字元。例如 "password":"my\"password" 可設定密碼 my"password； "image":"C:\\vmware\\vcsa" 可設定路徑 C:\vmware\vcsa。

   布林值必須只包含小寫字元。可以是 true 或 false。例如，"ssh_enable":false

5. 以 UTF-8 格式儲存並關閉檔案。

結果

您的檔案已可用於移轉。

下一步

您可以視需要針對特定環境建立和儲存大量範本。範本就緒後，請先執行預先檢查，然後再將其用於執行移轉。請參閱在執行至 vCenter Server Appliance的 CLI 移轉之前執行預先檢查。

適用於 Windows 的 vCenter ServerCLI 移轉的 JSON 範本

vCenter Server安裝程式包含 JSON 範本，這些範本位於 vcsa-cli-installer/templates 目錄中。在 migrate 子資料夾中，您可以找到包含所有移轉類型之最低組態參數的 JSON 範本。

表 1. 移轉 vCenter Server安裝程式中包含的 JSON 範本

位置	範本	說明
vcsa-cli-installer\templates\migrate\vcsa\winvc6.7	embedded_win_vc_to_embedded_vCSA_on_ESXi.json	包含在具有內嵌式 Platform Services Controller的 Windows 上將 vCenter Server 6.7 移轉至 ESXi 主機上 vCenter Server Appliance 8.0 所需的最低組態參數。
	embedded_win_vc_to_embedded_vCSA_on_VC.json	包含在具有內嵌式 Platform Services Controller的 Windows 上將 vCenter Server 6.7 移轉至 vCenter Server 執行個體上 vCenter Server Appliance 8.0 所需的最低組態參數。
	win_vc_to_vCSA_on_ESXi.json	包含在具有外部 Platform Services Controller的 Windows 上將 vCenter Server 6.7 移轉至 ESXi 主機上 vCenter Server Appliance 8.0 所需的最低組態參數。
	win_vc_to_vCSA_on_VC.json.json	包含在具有外部 Platform Services Controller的 Windows 上將 vCenter Server 6.7 移轉至 vCenter Server 執行個體上 vCenter Server Appliance 8.0 所需的最低組態參數。

關於使用 CLI 移轉含外部 Platform Services Controller 的適用於 Windows 的 vCenter Server

移轉使用外部 Platform Services Controller 的 vCenter Server for Windows 時，會將其轉換為 vCenter Server 執行個體，並將這些服務內嵌於應用裝置中。基於此原因，您必須在 JSON 移轉範本中指定複寫合作夥伴參數。

移轉使用外部 Platform Services Controller 的 vCenter Server for Windows 時，您必須在 JSON 移轉範本中指定複寫合作夥伴參數。這些參數會指出移轉是否適用於下列其中一個 vCenter Server 和 Platform Services Controller 移轉案例。

• SSO 網域內的單一 vCenter Server 和單一 Platform Services Controller 執行個體。
• SSO 網域內的第一個 vCenter Server 和 Platform Services Controller 執行個體包含多個 vCenter Server。
• 複寫 SSO 網域內的 vCenter Server 和 Platform Services Controller 執行個體，您必須將這些執行個體指向做為複寫合作夥伴的現有 vCenter Server 7.0 執行個體。

重要： 在移轉使用外部 Platform Services Controller 的 vCenter Server 部署之前，必須先將外部 Platform Services Controller 聚合至內嵌式 Platform Services Controller，然後再執行移轉。如需詳細資訊，請參閱 移除 Platform Services Controller。

使用外部 Platform Services Controller 的部署通常稱為 MxN 部署，其中 M 代表 vCenter Server，而 N 代表外部 Platform Services Controller。代表網域中 vCenter Server 和 Platform Services Controller 的多個執行個體時，這會以 MnxNn 表示，其中 n 為執行個體數目。例如，M2xN2 指出相同網域中有兩個 vCenter Server 執行個體和兩個 Platform Services Controller 執行個體。移轉此類部署時，請先將一個執行個體移轉至 8.0 版，然後將第二個執行個體移轉至 8.0，並指定兩個執行個體中的第一個執行個體做為複寫合作夥伴。

JSON 移轉範本中的複寫參數位於範本的 sso 區段中，並且為 first_instance 和 replication_partner_hostname。

參數名稱	說明
first_instance	first_instance 參數會將 vCenter Server 識別為 vCenter Server SSO 網域中的第一個執行個體，或識別為複寫合作夥伴。 如果它是第一個 vCenter Server 執行個體，請將 first_instance 設定為 true。針對相同 SSO 網域中的其他 vCenter Server 執行個體，請將 first_instance 設定為 false。
replication_partner_hostname *	如果將 first_instance 設定為 false，則必須指定已移轉至 8.0 版且其外部 PSC 已聚合至 vCenter Server Appliance 的 vCenter Server 的 FQDN 或 IP 位址。

當您使用 CLI 對使用外部 Platform Services Controller 的單一 vCenter Server for Windows 執行個體執行移轉時，程序如下所示：

1. 在 ESXi 上移轉時使用 win_vc_to_vCSA_on_ESXi.json 範本，或在 vCenter Server 部署上移轉時使用 win_vc_to_vCSA_on_VC.json 範本，藉此移轉您的拓撲中的 vCenter Server。

2. 針對包含單一 vCenter Server 和 Platform Services Controller ( M1xN1 部署) 的部署拓撲，編輯範本的 sso 區段，以將 first_instance 參數設定為 true，然後移除 replication_partner_hostname 參數。

   "sso": {
   "__comments": [ This is the first instance (M1) vCenter Server management node, with "first_instance" set to "true" and "replication_partner_hostname" removed.
   ],
   "first_instance": true
   }

3. 在 JSON 範本中指定其餘的組態參數，然後使用 CLI 將 vCenter Server 移轉至 8.0 版。請參閱執行將 vCenter Server從 Windows 至應用裝置的 CLI 移轉。
4. 成功移轉 vCenter Server 後，解除委任 Platform Services Controller。請參閱解除委任 Platform Services Controller。
   重要： 僅在移轉和聚合拓撲中的所有 vCenter Server 執行個體之後，才解除委任 Platform Services Controller 執行個體。

針對包含兩個或更多 vCenter Server 和 Platform Services Controller 執行個體 ( M2xN2 部署) 的部署，先將 M1 vCenter Server 執行個體移轉至 8.0 版，然後再移轉第二個，即複寫 vCenter Server 執行個體。

1. 在 ESXi 上移轉時使用 win_vc_to_vCSA_on_ESXi.json 範本，或在 vCenter Server 部署上移轉時使用 win_vc_to_vCSA_on_VC.json 範本，藉此移轉您的拓撲中的 vCenter Server。

2. 針對第一個 vCenter Server 執行個體 ( M1)，編輯範本的 sso 區段，以將 first_instance 參數設定為 true，然後移除 replication_partner_hostname 參數。

   "sso": {
   "__comments": [ This is the first instance (M1) vCenter Server management node, with "first_instance" set to "true" and "replication_partner_hostname" removed.
   ],
   "first_instance": true
   }

3. 針對其餘的 vCenter Server 執行個體 ( M2)，編輯範本的 sso 區段，以將 first_instance 參數設定為 false，然後提供要將第二個節點複寫到的 vCenter Server 執行個體的 FQDN 或 IP 位址。複寫合作夥伴是您移轉至 8.0 版的第一個 vCenter Server 執行個體 ( M1)，它已與其 Platform Services Controller 執行個體聚合在一起。

   "sso": {
   "__comments": [ This is the second instance (M2) vCenter Server management node, with "first_instance" set to "false" and "replication_partner_hostname" set to the hostname of the replication partner.],
   "first_instance": false,
   "replication_partner_hostname": "FQDN_or_IP_address"

4. 在 JSON 範本中指定其餘的組態參數，然後使用 CLI 將 vCenter Server 移轉至 8.0 版。請參閱執行將 vCenter Server從 Windows 至應用裝置的 CLI 移轉。
5. 成功移轉拓撲中的所有 vCenter Server 執行個體後，解除委任 Platform Services Controller 執行個體。請參閱解除委任 Platform Services Controller。
   重要： 僅在移轉和聚合拓撲中的所有 vCenter Server 執行個體之後，才解除委任 Platform Services Controller 執行個體。

移轉組態參數

使用 CLI 安裝程式將 vCenter Server安裝移轉至應用裝置時，您必須針對移轉規格提供參數與值。

下表列出用於為來源 vCenter Server提供輸入資料的組態參數。

重要： vCenter ServerAppliance 安裝程式路徑、JSON 組態檔路徑及 JSON 組態檔中的字串值 (包括密碼) 僅可包含 ASCII 字元。不支援延伸的 ASCII 和非 ASCII 字元。

若要設定包含反斜線 (\) 或引號 (") 字元的值，您必須在字元前面加上反斜線 (\) 字元。例如 "password":"my\"password"可設定密碼 my"password；"image":"C:\\vmware\\vcsa" 可設定路徑 C:\vmware\vcsa。

布林值必須僅包含小寫字元。可以是 true或false。例如，"ssh_enable":false。

JSON 移轉範本中的組態參數區段及子區段

JSON 移轉範本中的組態參數會以區段及子區段的形式進行組織整理。

表 2. JSON 移轉範本中的組態參數區段及子區段

區段	子區段	說明
new_vcsa- 描述要移轉至的目標應用裝置	esxi	僅當您要在 ESXi主機上直接部署應用裝置時才使用。 包含描述目標 ESXi主機的組態參數。 備註： 必須填寫 esxi或 vc 子區段。
	vc	僅當您要在 vCenter Server執行個體的詳細目錄上部署應用裝置時才使用。 包含描述來自 vCenter Server詳細目錄的目標 ESXi 主機或 DRS 叢集的組態參數。 備註： 必須填寫 vc或 esxi 子區段。
	appliance	包含描述應用裝置的組態參數。
	os	包含描述適用於應用裝置的作業系統設定的組態參數。
	ovftool_arguments	選用子區段，用於將任意引數和它們的值新增至安裝程式產生的 OVF 工具命令。 重要： vCenter ServerAppliance 安裝程式未驗證 ovftool_arguments 子區段中的組態參數。如果您設定 OVF 工具無法識別的引數，則部署可能會失敗。
	temporary_network	包含描述用於將資料從來源移轉至新目標應用裝置的臨時網路的組態參數。
	user-options	僅在來源為 vCenter Server 執行個體時使用。包含可讓您控制特定元件移轉程序各方面的組態參數。
source_vc- 描述來源 vCenter Server、vCenter Single Sign-On 或 Platform Services Controller	vc_win	包含描述 vCenter Server或 Platform Services Controller 的來源 Windows 安裝的組態參數
	run_migration_assistant	僅在來源 Windows 安裝做為虛擬機器執行，並且您想要自動執行 Migration Assistant 引動時使用。對於在實體機器上執行的來源 Windows 安裝，或者您在來源 Windows 機器上手動執行 Migration Assistant 時，請複製來源機器上 Migration Assistant 主控台輸出的指紋值並貼至 vc_win子區段中的 migration_ssl_thumbprint 索引鍵，然後移除 run_migration_assistant 區段。
ceip- 描述加入 VMware 客戶經驗改進計劃 (CEIP)	settings	僅包含用來加入或不加入 VMware 客戶經驗改進計劃 (CEIP) 的 ceip_enabled組態參數。 僅當您部署 vCenter Server應用裝置時需要。 備註： 如果設定為 true，則必須執行帶有 --acknowledge-ceip 引數的 CLI 部署命令。 如需有關 CEIP 的資訊，請參閱vCenter Server 和主機管理中的〈設定客戶體驗改進計劃〉一節。

new_vcsa區段中的組態參數

表 3. new_vcsa區段 esxi 子區段中的組態參數

名稱	類型	說明
hostname	string	您要在其上部署應用裝置的目標 ESXi主機的 IP 位址或 FQDN。
username	string	在目標 ESXi主機上具有管理權限的使用者名稱，例如 root。
password	string	在目標 ESXi主機上具有管理權限的使用者的密碼。
deployment_network	string	要連線應用裝置的網路名稱。 備註： 該網路必須可從目標 ESXi主機進行存取。 如果目標 ESXi主機只有一個網路，則忽略。
datastore	string	您要儲存所有虛擬機器組態檔和應用裝置的虛擬磁碟之資料存放區的名稱。 備註： 該資料存放區必須可從 ESXi主機進行存取。 該資料存放區必須有足夠的可用空間。
port	整數	ESXi主機的連接埠號碼。預設連接埠為 443。
ssl_certificate_verification	string	CLI 會驗證伺服器的安全性憑證是否由憑證授權機構 (CA) 簽署，並建立安全連線。如果是自我簽署憑證，除非您指定下列 SSL 憑證組態選項之一，否則 CLI 會停止升級。 指定安全雜湊演算法 1 (SHA-1) 憑證指紋。憑證指紋是唯一識別憑證的十六進位字串。指紋是使用指紋演算法從憑證內容進行計算的。 "thumbprint": "憑證 SHA-1 指紋" 將 verification_mode設為 NONE。 "verification_mode": "NONE" 如果使用自我簽署的憑證連線至伺服器，且無法指定 SHA-1 憑證指紋或將驗證模式設定為 NONE，CLI 會顯示伺服器的自我簽署憑證的指紋，並提示您接受或拒絕此憑證指紋。 您也可以使用 vcsa-deploy upgrade命令參數--no-ssl-certificate-validation 指定 CLI 忽略自我簽署的憑證。請參閱CLI 移轉命令的語法。

表 4. new_vcsa區段 vc 子區段中的組態參數

名稱	類型	說明
hostname	string	您要在其上部署應用裝置的目標 vCenter Server執行個體的 IP 位址或 FQDN。
username	string	目標 vCenter Server執行個體上的 vCenter Single Sign-On 管理員使用者名稱，例如，[email protected]。
password	string	目標 vCenter Server執行個體上的 vCenter Single Sign-On 管理員使用者的密碼。
deployment_network	string	要連線應用裝置的網路名稱。 備註： 該網路必須可從您要在其上部署應用裝置的目標 ESXi主機或 DRS 叢集進行存取。 如果目標 ESXi主機或 DRS 叢集只有一個網路，則忽略。
datacenter	字串或陣列	包含您要在其上部署應用裝置的目標 ESXi主機或 DRS 叢集的 vCenter Server 資料中心。 如果資料中心位於資料夾或資料夾結構中，則值必須是以逗點分隔的多個字串的清單，或是以逗點分隔的作為單個字串的清單。例如， ["parent_folder", "child_folder", "datacenter_name"] 或 "parent_folder, child_folder, datacenter_name" 如果資料中心中沒有資料夾路徑，則僅使用資料中心名稱。例如， ["datacenter_name"] 或 "datacenter_name" 備註： 值不區分大小寫。
datastore	string	您要儲存所有虛擬機器組態檔和應用裝置的虛擬磁碟之資料存放區的名稱。 備註： 資料存放區必須可從目標 ESXi主機或 DRS 叢集進行存取。 資料存放區必須有至少 25 GB 的可用空間。
port	整數	vCenter Server的連接埠號碼。預設連接埠為 443。
target	字串或陣列	您要在其上部署新應用裝置的目標叢集、ESXi主機或資源集區。這是使用datacenter參數指定的目標。此路徑必須以叢集名稱、ESXi 主機名稱或資源集區名稱結尾。 重要： 您必須提供在 vCenter Server詳細目錄中顯示的名稱。例如，如果目標 ESXi主機的名稱是 vCenter Server 詳細目錄中的 IP 位址，則您無法提供 FQDN。 備註： 所有值都區分大小寫。 如果要將已部署的應用裝置列在資料中心階層內的其他位置，請使用本節稍後所述的 vm_folder參數。 如果目標叢集、 ESXi主機或資源集區位於資料夾或資料夾結構中，則值必須是以逗點分隔的多個字串的清單，或是以逗點分隔的做為單個字串的清單。例如， ["parent_folder", "child_folder", "esxi-host.domain.com"] 或 "parent_folder, child_folder, esxi-host.domain.com" 如果目標 ESXi主機是叢集的一部分，請使用以逗點分隔的多個字串的清單或以逗點分隔的作為單個字串的清單來提供路徑。例如， ["cluster_name", "esxi-host.domain.com"] 或 "cluster_name, esxi-host.domain.com" 如果您要部署到資源集區，請在資源集區名稱前加上標籤Resources。例如： ["cluster_name", "Resources", "resource_pool_name"] 備註： 預先檢查僅驗證資源集區的記憶體。
vm_folder	string	選擇性。用來向其中新增應用裝置的虛擬機器 (VM) 資料夾的名稱。

表 5. new_vcsa區段 appliance 子區段中的組態參數

名稱	類型	說明
thin_disk_mode	Boolean	設定為 true以部署含精簡虛擬磁碟的應用裝置。
deployment_option	string	應用裝置的大小。 如果您要為具有預設儲存區大小的最多 10 台主機和 100 台虛擬機器部署 vCenter ServerAppliance，則設定為 tiny。 部署具有 2 個 CPU、10 GB 記憶體和 300 GB 儲存區的應用裝置。 如果您要為具有大型儲存區大小的最多 10 台主機和 100 台虛擬機器部署 vCenter ServerAppliance，則設定為 tiny-lstorage。 部署具有 2 個 CPU、10 GB 記憶體和 825 GB 儲存區的應用裝置。 如果您要為具有超大型儲存區大小的最多 10 台主機和 100 台虛擬機器部署 vCenter ServerAppliance，則設定為 tiny-xlstorage。 部署具有 2 個 CPU、10 GB 記憶體和 1700 GB 儲存區的應用裝置。 如果您要為具有預設儲存區大小的最多 100 台主機和 1,000 台虛擬機器部署 vCenter ServerAppliance，則設定為 small。 部署具有 4 個 CPU、16 GB 記憶體和 340 GB 儲存區的應用裝置。 如果您要為具有大型儲存區大小的最多 100 台主機和 1,000 台虛擬機器部署 vCenter ServerAppliance，則設定為 small-lstorage。 部署具有 4 個 CPU、16 GB 記憶體和 870 GB 儲存區的應用裝置。 如果您要為具有超大型儲存區大小的最多 100 台主機和 1,000 台虛擬機器部署 vCenter ServerAppliance，則設定為 small-xlstorage。 部署具有 4 個 CPU、16 GB 記憶體和 1750 GB 儲存區的應用裝置。 如果您要為具有預設儲存區大小的最多 400 台主機和 4,000 台虛擬機器部署 vCenter ServerAppliance，則設定為 medium。 部署具有 8 個 CPU、24 GB 記憶體和 525 GB 儲存區的應用裝置。 如果您要為具有大型儲存區大小的最多 400 台主機和 4,000 台虛擬機器部署 vCenter ServerAppliance，則設定為 medium-lstorage。 部署具有 8 個 CPU、24 GB 記憶體和 1025 GB 儲存區的應用裝置。 如果您要為具有超大型儲存區大小的最多 400 台主機和 4,000 台虛擬機器部署 vCenter ServerAppliance，則設定為 medium-xlstorage。 部署具有 8 個 CPU、24 GB 記憶體和 1905 GB 儲存區的應用裝置。 如果您要為具有預設儲存區大小的最多 1,000 台主機和 10,000 台虛擬機器部署 vCenter ServerAppliance，則設定為 large。 部署具有 16 個 CPU、32 GB 記憶體和 740 GB 儲存區的應用裝置。 如果您要為具有大型儲存區大小的最多 1,000 台主機和 10,000 台虛擬機器部署 vCenter ServerAppliance，則設定為 large-lstorage。 部署具有 16 個 CPU、32 GB 記憶體和 1090 GB 儲存區的應用裝置。 如果您要為具有超大型儲存區大小的最多 1,000 台主機和 10,000 台虛擬機器部署 vCenter ServerAppliance，則設定為 large-xlstorage。 部署具有 16 個 CPU、32 GB 記憶體和 1970 GB 儲存區的應用裝置。 如果您要為具有預設儲存區大小的最多 2,000 台主機和 35,000 台虛擬機器部署 vCenter ServerAppliance，則設定為 xlarge。 部署具有 24 個 CPU、48 GB 記憶體和 1180 GB 儲存區的應用裝置。 如果您要為具有大型儲存區大小的最多 2,000 台主機和 35,000 台虛擬機器部署 vCenter ServerAppliance，則設定為 xlarge-lstorage。 部署具有 24 個 CPU、48 GB 記憶體和 1230 GB 儲存區的應用裝置。 如果您要為具有超大型儲存區大小的最多 2,000 台主機和 35,000 台虛擬機器部署 vCenter ServerAppliance，則設定為 xlarge-xlstorage。 部署具有 24 個 CPU、48 GB 記憶體和 2110 GB 儲存區的應用裝置。
image	string	選擇性。vCenter ServerAppliance 安裝套件的本機檔案路徑或 URL。 依預設，安裝程式會使用包含在 vcsa 資料夾的 ISO 檔案中的安裝套件。
name	string	應用裝置的虛擬機器名稱。 除了百分號 (%)、反斜線 (\) 或正斜線 (/) 之外，必須只包含 ASCII 字元，並且長度不得超過 80 個字元。
ovftool_path	string	選擇性。OVF 工具可執行檔的本機檔案路徑。 依預設，安裝程式會使用包含在 vcsa/ovftool 資料夾的 ISO 檔案中的 OVF 工具執行個體。

表 6. new_vcsa區段 os 子區段中的組態參數

名稱	類型	說明
password	string	應用裝置作業系統的根使用者密碼。 密碼必須包含 8 至 20 個字元，至少一個大寫字元、一個小寫字元、一個數字，以及一個特殊字元，例如，貨幣符號 ($)、雜湊鍵 (#)、記號 (@)、句點 (.) 或驚歎號 (!)。所有字元必須僅包含不含空格的下部 ASCII 字元。
ssh_enable	Boolean	設定為 true，以便 SSH 管理員登入應用裝置。

表 7. new_vcsa區段 temporary_network 子區段中的組態參數

名稱	類型	說明
ip_family	string	應用裝置網路的 IP 版本。 設定為 ipv4或 ipv6。
mode	string	應用裝置網路的 IP 指派。 設定為 static或 dhcp。
ip	string	應用裝置的 IP 位址。 僅當您使用靜態指派，也就是將 mode參數設定為 static 時需要。 您必須設定與網路 IP 版本，也就是與 ip_family參數的值對應的 IPv4 或 IPv6 位址。 IPv4 位址必須符合 RFC 790 準則。 IPv6 位址必須符合 RFC 2373 準則。
dns_servers	字串或陣列	一或多個 DNS 伺服器的 IP 位址。 若要設定多個 DNS 伺服器，請使用以逗點分隔的多個字串的清單或是以逗點分隔的作為單個字串的清單來提供路徑。例如， ["x.y.z.a", "x.y.z.b"] 或 "x.y.z.a, x.y.z.b" 僅當您使用靜態指派，也就是將 mode參數設定為 static 時需要。
prefix	string	網路首碼長度。 僅當您使用指派，也就是將 mode參數設定為 static 時需要。 對於 IPv4 版本，值必須在 0和 32 之間。 對於 IPv6 版本，值必須在 0和 128 之間。
gateway	string	預設閘道的　IP 位址。 對於 IPv6 版本，值可以為 default。

表 8. new_vcsa區段 user_options 子區段中的組態參數

名稱	類型	說明
vcdb_migrateSet	string	選取要從舊應用裝置移轉至新應用裝置的資料類型。資料會從來源vCenter Server複製到目標伺服器。資料的原始來源保持不變。 如果您只要傳輸組態資料，則設定為core。這可提供最快的資料移轉，使系統停機時間保持最短。 如果您要立即傳輸組態和歷史資料 (事件和工作)，則設定為core_events_tasks。直到來源 vCenter Serverfor Windows 的所有資料均已移轉，vCenter Server 才會啟動。 如果您要立即傳輸組態、歷史和效能度量資料，則設定為all。直到來源 vCenter Serverfor Windows 的所有資料均已移轉，vCenter Server 才會啟動。此選項可傳輸最大數量的資料，且所需停機時間比其他資料移轉選項更長。 如果您要在升級完成後在背景中傳輸歷史資料 (事件和工作)，則設定為transfer_events_tasks_after_upgrade。在此期間，vCenter Server效能可能不是最佳的。 如果您要在升級完成後在背景中傳輸歷史資料和效能度量資料，則設定為transfer_stats_events_tasks_after_upgrade。在此期間，vCenter Server效能可能不是最佳的。 備註： 為了盡量減少移轉時間以及新 vCenter ServerAppliance 所需的儲存區數量，請使用 core 值。 如需有關可從現有 vCenter Server傳輸至新升級的 vCenter Server 的資料類型的詳細資訊，請參閱從現有 vCenter Server Appliance 傳輸資料。

表 9. new_vcsa區段 sso 子區段中的組態參數

名稱	類型	說明
first_instance	string	如果這是您的 vCenter ServerSSO 網域中的第一個聚合移轉作業，或者您不想為此節點設定複寫合作夥伴，請將 first_instance 設定為 true。 如果您想要為此節點設定複寫合作夥伴，請將 first_instance設定為 false，並提供 replication_partner_hostname 的值做為先前聚合節點 (目前位於內嵌式 vCenter Server 拓撲中) 的 FQDN。 如需有關指定 first_instance和 replication_partner_hostname 參數的詳細資訊，請參閱關於使用 CLI 移轉含外部 Platform Services Controller 的適用於 Windows 的 vCenter Server。
replication_partner_hostname	string	複寫合作夥伴的主機名稱。如果是 first_instance則移除

Migration Assistant 自動引動需求

您可以使用run_migration_assistant子區段自動執行 Migration Assistant 引動。僅當來源 Windows 安裝做為虛擬機器執行時，自動引動才會運作。

在 os_username或 vum_os_username 參數中指定的使用者帳戶需要將權限提升至管理員。例如：

• 內建 Windows 管理員帳戶。
• 使用者名稱不是 Administrator (本機 Windows 管理員群組成員) 的使用者帳戶。
• 使用者名稱為 Administrator (本機 Windows 管理員群組成員) 的網域管理員帳戶。
• 使用者名稱識別碼必須採用格式 your_domain_name\\user_ID 或 user_ID@your_domain_name。

限制： Migration Assistant 自動引動無法在需要提升至管理員權限的 Windows 帳戶中運作。請改為在來源 Windows 機器上手動執行 Migration Assistant。複製來源機器上的 Migration Assistant 主控台輸出的指紋值並貼至 vc_win子區段中的 migration_ssl_thumbprint 金鑰，然後移除 run_migration_assistant 區段。

source_vc區段中的組態參數

表 10. source_vc區段 vc_win 子區段中的組態參數

名稱	類型	說明
hostname	string	要移轉的 vCenter Server或 Platform Services Controller 的來源 Windows 安裝的主機名稱或 IP 位址。
username	string	具有要移轉的 vCenter Server、vCenter Single Sign-On 或 Platform Services Controller 執行個體之管理權限的 vCenter Single Sign-On 使用者名稱。
password	string	要移轉的 vCenter Server或 Platform Services Controller 執行個體的密碼。
migration_port	string	Migration Assistant 主控台中顯示的 Migration Assistant 連接埠號碼。預設連接埠為 9123。
active_directory_domain	string	來源 vCenter Server執行個體加入的 Active Directory 網域的名稱。
active_directory_username	string	來源 vCenter Server執行個體加入的 Active Directory 網域的管理員使用者名稱。
active_directory_password	string	來源 vCenter Server執行個體加入的 Active Directory 網域的管理員密碼。 備註： 安裝程式會驗證輸入的認證，但不會檢查將目標機器新增至 Active Directory 網域所需的權限。確認使用者認證具有將機器新增至 Active Directory 網域所需的所有權限。
migration_ssl_thumbprint	string	Migration Assistant 的 SSL 指紋。

表 11. source_vc區段 run_migration_assistant 子區段中的組態參數

名稱	類型	說明
esxi_hostname	string	來源 vCenter Server、vCenter Single Sign-On 或 Platform Services Controller 執行個體所在 ESXi 的 FQDN 或 IP 位址。
esxi_username	string	ESXi主機上具有管理權限之使用者的使用者名稱。
esxi_password	string	ESXi主機使用者的密碼。如果省略，則在範本驗證期間，系統會提示您於命令主控台輸入密碼。
esxi_port	string	ESXi主機的連接埠號碼。預設連接埠為 443。
os_username	string	來源 Windows 機器的管理員使用者名稱。
os_password	string	來源 Windows 機器的管理員使用者密碼。如果省略，則在範本驗證期間，系統會提示您於命令主控台輸入。
migration_ip	string	要移轉的網路介面卡的 IP 位址。
migration_port	string	Migration Assistant 主控台中顯示的 Migration Assistant 連接埠號碼。預設連接埠為 9123。
export_dir	string	用於匯出來源組態和資料的目錄。
sa_password	string	網路vCenter Server服務帳戶使用者密碼的 IP 位址。僅當vCenter Server服務使用非 LocalSystem 帳戶執行時，才需要此選項。如果省略，則在範本驗證期間，系統會提示您於命令主控台輸入。

表 12. source_vum區段 run_migration_assistant 子區段中的組態參數

名稱	類型	說明
esxi_hostname	string	來源 vCenter Server、vCenter Single Sign-On 或 Platform Services Controller 執行個體所在 ESXi 的 FQDN 或 IP 位址。
esxi_username	string	ESXi主機上具有管理權限之使用者的使用者名稱。
esxi_password	string	ESXi主機使用者的密碼。如果省略，則在範本驗證期間，系統會提示您於命令主控台輸入密碼。
esxi_port	string	ESXi主機的連接埠號碼。預設連接埠為 443。
vum_hostname	string	來源 Update Manager執行個體所在 ESXi 的 FQDN 或 IP 位址。
vum_os_username	string	來源 Windows 機器的管理員使用者名稱。
vum_os_password	string	來源Update ManagerWindows 機器的管理員使用者密碼。如果省略，則在範本驗證期間，系統會提示您於命令主控台輸入。
migration_port	string	Migration Assistant 主控台中顯示的 Migration Assistant 連接埠號碼。預設連接埠為 9123。
export_dir	string	用於匯出來源組態和資料的目錄。

ceip區段中的組態參數

表 13. ceip區段 settings 子區段中的組態參數

名稱	類型	說明
ceip_enabled	Boolean	設定為 true以加入此應用裝置的 CEIP。

在執行至 vCenter Server Appliance的 CLI 移轉之前執行預先檢查

在移轉 vCenter Server部署之前，您可以先執行預先檢查以確認符合移轉需求並解決任何問題。

在將 vCenter Server部署移轉至應用裝置之前，您可以先執行預先檢查以瞭解磁碟空間需求、估計的升級時間，以及向vCenter Server Appliance 登錄的延伸。在規劃升級時，執行升級前作業為選擇性步驟，但我們強烈建議您執行。

必要條件

準備 JSON 組態檔以進行 CLI 移轉使用範例範本和組態參數。

程序

1. 在不部署應用裝置的情況下，輸入以下命令以驗證範本：vcsa-deploy migrate --verify-template-only path_to_json_file。
2. 執行使用 --precheck-only選項的 CLI Migrate。
   您可以藉由磁碟空間需求和估計的移轉時間來調整移轉計劃。如果收到錯誤，您可以先進行疑難排解以解決問題，然後再執行實際的移轉。
3. 解決任何錯誤後，再次使用 --verify-template-only選項執行 CLI Migrate 命令，直到解決所有錯誤為止。

結果

您現在已準備妥當，可進行無錯誤的 CLI 移轉程序。

下一步

執行將 vCenter Server從 Windows 至應用裝置的 CLI 移轉。

執行將 vCenter Server從 Windows 至應用裝置的 CLI 移轉

您可以將 vCenter Server從您的 vSphere 網路中的機器移轉至應用裝置。

必要條件

• 請參閱移轉 vCenter Server 的必要條件
• 為預防起見，建立您想要移轉的部署的快照，以免在移轉程序進行時失敗。
• 從 VMware 網站將安裝程式 ISO 檔案下載至您的 vSphere 網路中的機器。安裝程式 ISO 檔案名稱為 VMware-VCSA-all-8.0.0-yyyyyy.iso，其中 yyyyyy 為組建編號。請參閱下載並掛接 vCenter Server 安裝程式。
• 準備 JSON 組態檔以進行 CLI 移轉。
• 在執行至 vCenter Server Appliance的 CLI 移轉之前執行預先檢查以識別問題並精簡您的移轉計劃。
• 檢閱執行移轉的選用引數。請參閱CLI 移轉命令的語法。

程序

1. 導覽至您作業系統的軟體 CLI 安裝程式目錄。
   • 如果您正在從含 Windows 作業系統的機器部署應用裝置，則導覽至 vcsa-cli-installer\win32 目錄。
   • 如果您正在從含 Linux 作業系統的機器部署應用裝置，則導覽至 vcsa-cli-installer/lin64 目錄。
   • 如果您正在從含 Mac 作業系統的機器部署應用裝置，則導覽至 vcsa-cli-installer/mac 目錄。
2. 選取 CLI 安裝程式：vcsa-deploy.exe。
3. 執行移轉命令。

   vcsa-deploy migrate --accept-eula optional_arguments path_to_the_json_file

   optional_arguments 變數是以空格分隔的選用引數 (用來設定其他組態) 的清單。
   例如，您可以設定記錄的位置以及安裝程式產生的其他輸出檔案。

   vcsa-deploy migrate --accept-eula --log-dir=path_to_the_location path_to_the_json_file

結果

移轉範本已部署。您可以確認您的 vCenter Server 升級或移轉成功。

CLI 移轉命令的語法

您可以使用一或多個命令引數設定移轉命令的執行參數。

您可將以空格分隔的引數清單新增至 CLI 升級命令。

vcsa-deploy migrate list_of_arguments path_to_the_json_file

所需的 template引數提供描述vCenter Server Appliance 部署程序的 JSON 檔案路徑。您可以將多個 JASON 檔案放置在一個目錄中，並且 CLI 將以批次模式移轉所有部署。如需有關執行同時移轉的詳細資訊，請參閱準備 JSON 組態檔以進行 CLI 移轉。

重要： 字串值 (包括密碼) 必須僅包含 ASCII 字元。不支援延伸的 ASCII 和非 ASCII 字元。

若要設定包含反斜線 (\) 或引號 (") 字元的值，您必須在字元前面加上反斜線 (\) 字元。例如 "password":"my\"password"可設定密碼 my"password；"image":"C:\\vmware\\vcsa" 可設定路徑 C:\vmware\vcsa。

布林值必須僅包含小寫字元。可以是 true或false。例如，"ssh.enable":false。

選用引數	說明
--accept-eula	接受使用者授權合約。 執行部署命令時需要。
-h, --help	顯示命令的說明訊息。
--template-help	顯示 JSON 部署檔案中組態參數的說明訊息。您可以使用 vcsa-deploy [subcommand] --help取得子命令特定的引數清單。
-v, --verbose	將偵錯資訊新增至主控台輸出中。
-t, --terse	隱藏主控台輸出。僅顯示警告和錯誤訊息。
--log-dir、LOG_DIR	指定記錄檔以及安裝程式產生的其他輸出檔案的位置。
--skip-ovftool-verification	執行組態參數的基本驗證並部署 vCenter Server Appliance，但不會驗證 JSON 範本之ovftool_arguments子區段中的 OVF 工具參數。如果您設定 OVF 工具無法識別的引數，則部署可能會失敗。
--no-ssl-certificate-verification	禁止 ESXi 連線的 SSL 驗證。 CLI 會驗證伺服器的安全性憑證是否由憑證授權機構 (CA) 簽署，並建立安全連線。如果是自我簽署的憑證，CLI 會停止升級，除非您使用 --no-ssl-certificate-validation命令參數指定 CLI 忽略自我簽署的憑證。 如果使用自我簽署的憑證連線至伺服器，且無法指定 CLI 接受它，CLI 將會顯示伺服器的自我簽署的憑證指紋，並提示您接受或拒絕該憑證。 您也可以使用 JSON 範本中的ssl_certificate_verification組態參數指定 CLI 忽略自我簽署的憑證。請參閱升級 vCenter Server Appliance 的 CLI 升級組態參數。 重要： 避免使用此選項，由於目標主機未驗證身分識別，會導致升級期間或升級後發生問題。
--operation-id	可讓您提供識別碼以追蹤多個 vCenter Server 執行個體的並行安裝、移轉或升級。如果未提供作業識別碼，CLI 會產生通用唯一識別碼 (UUID) 供您用來識別不同的 vCenter Server 執行個體及其安裝或升級狀態。
--verify-template-only	執行基本範本驗證，而無需安裝升級執行器、執行預先檢查以及升級或移轉 vCenter ServerAppliance。
--precheck-only	在來源 vCenter Server 虛擬機器上安裝 Migration Assistant，然後在不執行移轉的情況下執行一整套預先檢查。
--acknowledge-ceip	確認參與 VMware 客戶經驗改進計劃 (CEIP)。如果升級範本中的 ceip.enabled 設定為 true，則需要此引數。

結束代碼	說明
0	已成功執行命令
1	執行階段錯誤
2	驗證錯誤
3	範本錯誤