移轉組態參數

使用 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 移轉範本中的組態參數會以區段及子區段的形式進行組織整理。

表 1. 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區段中的組態參數

表 2. 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 移轉命令的語法。

表 3. 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) 資料夾的名稱。

表 4. 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 工具執行個體。

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

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

表 6. 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。

表 7. 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 ServerAppliance 傳輸資料。

表 8. 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區段中的組態參數

表 9. 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 指紋。

表 10. 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 帳戶執行時，才需要此選項。如果省略，則在範本驗證期間，系統會提示您於命令主控台輸入。

表 11. 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區段中的組態參數

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

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