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

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

重要事項︰

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

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

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

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

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

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

區段

子區段

說明

new.vcsa - 描述要移轉到的目標應用裝置

esxi

僅當您要在 ESXi 主機上直接部署應用裝置時才使用。

包含描述目標 ESXi 主機的組態參數。

備註︰

必須填寫 esxivc 子區段。

vc

僅當您要在 vCenter Server 執行個體的詳細目錄上部署應用裝置時才使用。

包含描述來自 vCenter Server 詳細目錄的目標 ESXi 主機或 DRS 叢集的組態參數。

備註︰

必須填寫 vcesxi 子區段。

appliance

包含描述應用裝置的組態參數。

os

包含描述適用於應用裝置的作業系統設定的組態參數。

ovftool.arguments

選用子區段,用於將任意引數和它們的值新增至安裝程式產生的 OVF 工具命令。

重要事項︰

vCenter Server Appliance 安裝程式未驗證 ovftool.arguments 子區段中的組態參數。如果您設定 OVF 工具無法識別的引數,則部署可能會失敗。

temporary.network

包含描述用於將資料從來源移轉至新目標應用裝置的臨時網路的組態參數。

user-options

僅在來源為 vCenter Server 執行個體時使用。包含可讓您控制特定元件移轉程序各方面的組態參數。

source.vc - 描述來源 vCenter Server、vCenter Single Sign-On 或 Platform Services Controller

vc.win

包含描述 vCenter Server、vCenter Single Sign-On 或 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 Single Sign-On 的 vCenter Server AppliancePlatform Services Controller 應用裝置時需要。

備註︰

如果設定為 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。

表格 3. new.vcsa 區段 vc 子區段中的組態參數

名稱

類型

說明

hostname

string

您要在其上部署應用裝置的目標 vCenter Server 執行個體的 IP 位址或 FQDN。

username

string

目標 vCenter Server 執行個體上的 vCenter Single Sign-On 管理員使用者名稱,例如,administrator@vsphere.local。

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"

備註︰

值不區分大小寫。

datastore

string

您要儲存所有虛擬機器組態檔和應用裝置的虛擬磁碟之資料存放區的名稱。

備註︰

資料存放區必須可從目標 ESXi 主機或 DRS 叢集進行存取。

資料存放區必須有至少 15 GB 的可用空間。

port

整數

vCenter Server 的連接埠號碼。預設連接埠為 443。

target

字串或陣列

您要在其上部署應用裝置的目標 ESXi 主機或 DRS 叢集。

重要事項︰

您必須提供在 vCenter Server 詳細目錄中顯示的名稱。例如,如果目標 ESXi 主機的名稱是 vCenter Server 詳細目錄中的 IP 位址,則您無法提供 FQDN。

如果目標 ESXi 主機或 DRS 叢集位於資料夾或資料夾結構中,則值必須是以逗點分隔的多個字串的清單,或是以逗點分隔的作為單個字串的清單。例如,

["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"

備註︰

值不區分大小寫。

vm.folder

string

選擇性。用來向其中新增應用裝置的虛擬機器資料夾的名稱。

表格 4. new.vcsa 區段 appliance 子區段中的組態參數

名稱

類型

說明

thin.disk.mode

Boolean

設定為 true 以部署含精簡虛擬磁碟的應用裝置。

deployment.option

string

應用裝置的大小。

  • 如果您要為具有預設儲存大小的最多 10 台主機和 100 台虛擬機器部署含內嵌式 Platform Services ControllervCenter Server Appliance,則設定為 tiny

    部署具有 2 個 CPU、8 GB 記憶體和 250 GB 儲存區的應用裝置。

  • 如果您要為具有大型儲存大小的最多 10 台主機和 100 台虛擬機器部署含內嵌式 Platform Services ControllervCenter Server Appliance,則設定為 tiny-lstorage

    部署具有 2 個 CPU、8 GB 記憶體和 775 GB 儲存區的應用裝置。

  • 如果您要為具有超大型儲存大小的最多 10 台主機和 100 台虛擬機器部署含內嵌式 Platform Services ControllervCenter Server Appliance,則設定為 tiny-xlstorage

    部署具有 2 個 CPU、8 GB 記憶體和 1650 GB 儲存區的應用裝置。

  • 如果您要為具有預設儲存大小的最多 100 台主機和 1,000 台虛擬機器部署含內嵌式 Platform Services ControllervCenter Server Appliance,則設定為 small

    部署具有 4 個 CPU、16 GB 記憶體和 290 GB 儲存區的應用裝置。

  • 如果您要為具有大型儲存大小的最多 100 台主機和 1,000 台虛擬機器部署含內嵌式 Platform Services ControllervCenter Server Appliance,則設定為 small-lstorage

    部署具有 4 個 CPU、16 GB 記憶體和 820 GB 儲存區的應用裝置。

  • 如果您要為具有超大型儲存大小的最多 100 台主機和 1,000 台虛擬機器部署含內嵌式 Platform Services ControllervCenter Server Appliance,則設定為 small-xlstorage

    部署具有 4 個 CPU、16 GB 記憶體和 1700 GB 儲存區的應用裝置。

  • 如果您要為具有預設儲存大小的最多 400 台主機和 4,000 台虛擬機器部署含內嵌式 Platform Services ControllervCenter Server Appliance,則設定為 medium

    部署具有 8 個 CPU、24 GB 記憶體和 425 GB 儲存區的應用裝置。

  • 如果您要為具有大型儲存大小的最多 400 台主機和 4,000 台虛擬機器部署含內嵌式 Platform Services ControllervCenter Server Appliance,則設定為 medium-lstorage

    部署具有 8 個 CPU、24 GB 記憶體和 925 GB 儲存區的應用裝置。

  • 如果您要為具有超大型儲存大小的最多 400 台主機和 4,000 台虛擬機器部署含內嵌式 Platform Services ControllervCenter Server Appliance,則設定為 medium-xlstorage

    部署具有 8 個 CPU、24 GB 記憶體和 1805 GB 儲存區的應用裝置。

  • 如果您要為具有預設儲存大小的最多 1,000 台主機和 10,000 台虛擬機器部署含內嵌式 Platform Services ControllervCenter Server Appliance,則設定為 large

    部署具有 16 個 CPU、32 GB 記憶體和 640 GB 儲存區的應用裝置。

  • 如果您要為具有大型儲存大小的最多 1,000 台主機和 10,000 台虛擬機器部署含內嵌式 Platform Services ControllervCenter Server Appliance,則設定為 large-lstorage

    部署具有 16 個 CPU、32 GB 記憶體和 990 GB 儲存區的應用裝置。

  • 如果您要為具有超大型儲存大小的最多 1,000 台主機和 10,000 台虛擬機器部署含內嵌式 Platform Services ControllervCenter Server Appliance,則設定為 large-xlstorage

    部署具有 16 個 CPU、32 GB 記憶體和 1870 GB 儲存區的應用裝置。

  • 如果您要為具有預設儲存大小的最多 2,000 台主機和 35,000 台虛擬機器部署含內嵌式 Platform Services ControllervCenter Server Appliance,則設定為 xlarge

    部署具有 48 個 CPU、24 GB 記憶體和 980 GB 儲存區的應用裝置。

  • 如果您要為具有大型儲存大小的最多 2,000 台主機和 35,000 台虛擬機器部署含內嵌式 Platform Services ControllervCenter Server Appliance,則設定為 xlarge-lstorage

    部署具有 48 個 CPU、24 GB 記憶體和 1030 GB 儲存區的應用裝置。

  • 如果您要為具有超大型儲存大小的最多 2,000 台主機和 35,000 台虛擬機器部署含內嵌式 Platform Services ControllervCenter Server Appliance,則設定為 xlarge-xlstorage

    部署具有 48 個 CPU、24 GB 記憶體和 1910 GB 儲存區的應用裝置。

  • 如果您要為具有預設儲存大小的最多 10 台主機和 100 台虛擬機器部署含外部 Platform Services ControllervCenter Server Appliance,則設定為 management-tiny

    部署具有 2 個 CPU、8 GB 記憶體和 250 GB 儲存區的應用裝置。

  • 如果您要為具有大型儲存大小的最多 10 台主機和 100 台虛擬機器部署含外部 Platform Services ControllervCenter Server Appliance,則設定為 management-tiny-lstorage

    部署具有 2 個 CPU、8 GB 記憶體和 775 GB 儲存區的應用裝置。

  • 如果您要為具有超大型儲存大小的最多 10 台主機和 100 台虛擬機器部署含外部 Platform Services ControllervCenter Server Appliance,則設定為 management-tiny-xlstorage

    部署具有 2 個 CPU、8 GB 記憶體和 1650 GB 儲存區的應用裝置。

  • 如果您要為具有預設儲存大小的最多 100 台主機和 1,000 台虛擬機器部署含外部 Platform Services ControllervCenter Server Appliance,則設定為 management-small

    部署具有 4 個 CPU、16 GB 記憶體和 290 GB 儲存區的應用裝置。

  • 如果您要為具有大型儲存大小的最多 100 台主機和 1,000 台虛擬機器部署含外部 Platform Services ControllervCenter Server Appliance,則設定為 management-small-lstorage

    部署具有 4 個 CPU、16 GB 記憶體和 820 GB 儲存區的應用裝置。

  • 如果您要為具有超大型儲存大小的最多 100 台主機和 1,000 台虛擬機器部署含外部 Platform Services ControllervCenter Server Appliance,則設定為 management-small-xlstorage

    部署具有 4 個 CPU、16 GB 記憶體和 1700 GB 儲存區的應用裝置。

  • 如果您要為具有預設儲存大小的最多 400 台主機和 4,000 台虛擬機器部署含外部 Platform Services ControllervCenter Server Appliance,則設定為 management-medium

    部署具有 8 個 CPU、24 GB 記憶體和 425 GB 儲存區的應用裝置。

  • 如果您要為具有大型儲存大小的最多 400 台主機和 4,000 台虛擬機器部署含外部 Platform Services ControllervCenter Server Appliance,則設定為 management-medium-lstorage

    部署具有 8 個 CPU、24 GB 記憶體和 925 GB 儲存區的應用裝置。

  • 如果您要為具有超大型儲存大小的最多 400 台主機和 4,000 台虛擬機器部署含外部 Platform Services ControllervCenter Server Appliance,則設定為 management-medium-xlstorage

    部署具有 8 個 CPU、24 GB 記憶體和 1805 GB 儲存區的應用裝置。

  • 如果您要為具有預設儲存大小的最多 1,000 台主機和 10,000 台虛擬機器部署含外部 Platform Services ControllervCenter Server Appliance,則設定為 management-large

    部署具有 16 個 CPU、32 GB 記憶體和 640 GB 儲存區的應用裝置。

  • 如果您要為具有大型儲存大小的最多 1,000 台主機和 10,000 台虛擬機器部署含外部 Platform Services ControllervCenter Server Appliance,則設定為 management-large-lstorage

    部署具有 16 個 CPU、32 GB 記憶體和 990 GB 儲存區的應用裝置。

  • 如果您要為具有超大型儲存大小的最多 1,000 台主機和 10,000 台虛擬機器部署含外部 Platform Services ControllervCenter Server Appliance,則設定為 management-large-xlstorage

    部署具有 16 個 CPU、32 GB 記憶體和 1870 GB 儲存區的應用裝置。

  • 如果您要為具有預設儲存大小的最多 2,000 台主機和 35,000 台虛擬機器部署含外部 Platform Services ControllervCenter Server Appliance,則設定為 management-xlarge

    部署具有 48 個 CPU、24 GB 記憶體和 980 GB 儲存區的應用裝置。

  • 如果您要為具有大型儲存大小的最多 2,000 台主機和 35,000 台虛擬機器部署含外部 Platform Services ControllervCenter Server Appliance,則設定為 management-xlarge-lstorage

    部署具有 48 個 CPU、24 GB 記憶體和 1030 GB 儲存區的應用裝置。

  • 如果您要為具有超大型儲存大小的最多 2,000 台主機和 35,000 台虛擬機器部署含外部 Platform Services ControllervCenter Server Appliance,則設定為 management-xlarge-xlstorage

    部署具有 48 個 CPU、24 GB 記憶體和 1910 GB 儲存區的應用裝置。

  • 如果您想要部署 Platform Services Controller 應用裝置,則設定為 infrastructure

    部署具有 2 個 CPU、4 GB 記憶體和 60 GB 儲存區的應用裝置。

image

string

選擇性。vCenter Server Appliance 安裝套件的本機檔案路徑或 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 版本。

設定為 ipv4ipv6

mode

string

應用裝置網路的 IP 指派。

設定為 staticdhcp

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 版本,值必須在 032 之間。

對於 IPv6 版本,值必須在 0128 之間。

gateway

string

預設閘道的 IP 位址。

對於 IPv6 版本,值可以為 default

system.name

string

主要網路身分識別。

可以是 IP 位址或 FQDN,最好是 FQDN。

您無法在部署後變更此參數的值。

FQDN 和以點分隔的十進位數必須符合 RFC 1123 準則。

表格 7. new.vcsa 區段 user-options 子區段中的組態參數

名稱

類型

說明

vcdb.migrateSet

string

設定資料移轉選項。可用選項為 coreallcore_events_tasks。設定為 core 可移轉核心詳細目錄及組態資料。設定為 all 可移轉所有 vCenter Server 效能及歷史資料,例如統計資料、事件、警示和工作。不移轉所有資料會減少整體停機時間。

Migration Assistant 自動引動需求

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

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

表格 8. source.vc 區段 vc.win 子區段中的組態參數

名稱

類型

說明

hostname

string

要移轉的 vCenter Server、vCenter Single Sign-On 或 Platform Services Controller 的來源 Windows 安裝的主機名稱或 IP 位址。

username

string

具有要移轉的 vCenter Server、vCenter Single Sign-On 或 Platform Services Controller 執行個體之管理權限的 vCenter Single Sign-On 使用者名稱。

password

string

要移轉的 vCenter Server、vCenter Single Sign-On 或 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 指紋。

表格 9. 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 帳戶執行時,才需要此選項。如果留白或遺漏,系統會提示您在範本驗證期間於命令主控台輸入密碼。

表格 10. 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 Manager Windows 機器的管理員使用者密碼。如果留白或遺漏,系統會提示您在範本驗證期間於命令主控台輸入密碼。

migration.port

string

Migration Assistant 主控台中顯示的 Migration Assistant 連接埠號碼。預設連接埠為 9123。

export.dir

string

用於匯出來源組態和資料的目錄。

ceip 區段中的組態參數

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

名稱

類型

說明

ceip.enabled

Boolean

設定為 true 以加入此應用裝置的 CEIP。