當您為 CLI 部署準備 JSON 組態檔時,必須設定參數和值,來為 vCenter Server AppliancePlatform Services Controller 應用裝置的部署提供輸入資料。

JSON 部署檔案中組態參數的區段和子區段

用於 CLI 升級的 JSON 組態檔中的組態參數在區段和子區段中進行組織整理。

表 1. JSON 部署檔案中組態參數的區段和子區段
區段 子區段 說明
new.vcsa - 描述您要部署的應用裝置 esxi

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

包含描述目標 ESXi主機的組態參數。請參閱 new.vcsa區段 esxi 子區段中的組態參數
備註: 必須填寫 esxivc 子區段。
vc

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

包含描述來自 vCenter Server詳細目錄的目標ESXi 主機或 DRS 叢集的組態參數。請參閱 new.vcsa區段 vc 子區段中的組態參數

備註: 必須填寫 vcesxi 子區段。
appliance 包含描述應用裝置的組態參數。請參閱 new.vcsa區段 appliance 子區段中的組態參數
network 包含描述適用於應用裝置的網路設定的組態參數。請參閱 new.vcsa區段 network 子區段中的組態參數
os 包含描述適用於應用裝置的作業系統設定的組態參數。請參閱 new.vcsa區段 os 子區段中的組態參數
sso 包含描述適用於應用裝置的 vCenter Single Sign-On 設定的組態參數。請參閱 new.vcsa 區段 sso 子區段中的組態參數
ovftool.arguments 選用子區段,用於將任意引數和它們的值新增至安裝程式產生的 OVF 工具命令。
重要: vCenter Server Appliance 安裝程式未驗證 ovftool.arguments 子區段中的組態參數。如果您設定 OVF 工具無法識別的引數,則部署可能會失敗。
ceip- 描述加入 VMware 客戶經驗改進計劃 (CEIP) settings

僅包含用來加入或不加入 VMware 客戶經驗改進計劃 (CEIP) 的 ceip.enabled 組態參數。請參閱 ceip區段 settings 子區段中的組態參數

僅當您部署含內嵌式 Platform Services ControllervCenter Server Appliance 或部署 Platform Services Controller 應用裝置時需要。

備註: 如果設定為 true,則必須執行帶有 --acknowledge-ceip 引數的 CLI 部署命令。

如需有關 CEIP 的資訊,請參閱vCenter Server 和主機管理中的〈設定客戶體驗改進計劃〉一節。

重要:

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

若要設定包含反斜線 (\) 或引號 (") 字元的值,您必須在字元前面加上反斜線 (\) 字元。例如,"password":"my\"password" 可設定密碼 my”password;"image":"G:\\vcsa\\VMware-vCenter-Server-Appliance-6.5.0.XXXX-YYYYYYY_OVF10.ova" 可設定路徑 G:\vcsa\VMware-vCenter-Server-Appliance-6.5.0.XXXX-YYYYYYY_OVF10.ova

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

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 主機的 HTTPS 反向 Proxy 連接埠。

預設連接埠為 443。僅當目標 ESXi主機使用自訂 HTTPS 反向 Proxy 連接埠時使用。

表 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"
備註: 值不區分大小寫。
datastore string

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

備註:

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

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

port 整數

目標 vCenter Server 執行個體的 HTTPS 反向 Proxy 連接埠。

預設連接埠為 443。僅當目標 vCenter Server執行個體使用自訂 HTTPS 反向 Proxy 連接埠時使用。

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、10 GB 記憶體和 250 GB 儲存區的應用裝置。

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

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

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

    部署具有 2 個 CPU、10 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

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

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

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

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

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

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

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

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

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

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

    部署具有 2 個 CPU、10 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

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

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

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

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

    部署具有 24 個 CPU、48 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區段 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 時使用。僅當 mode參數設定為 dhcp 時移除。

網路首碼長度是子網路遮罩中設定的位元數。例如,如果子網路遮罩是 255.255.255.0,則二進位版本的首碼長度中包含 24 個位元,因此網路首碼長度為 24。

對於 IPv4 版本,值必須在 032 之間。

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

gateway string

預設閘道的 IP 位址。

對於 IPv6 版本,值可以為 default

ports string

(選擇性) vCenter Server Appliance 用於直接 HTTP 連線的連接埠號碼。依預設,連接埠 80 會將要求重新導向至 HTTPS 連接埠 443。您可以自訂 vCenter Server HTTP 和 HTTPS 連接埠。若要指定自訂 HTTP 和 HTTPS 連接埠號碼,請確保不會使用已由 vCenter Server 使用的連接埠或預設 HTTP 和 HTTPS 連接埠 80 和 443。

用於指定自訂連接埠的選項為:"rhttpproxy.ext.port1":"port_number" (用於 HTTP 連接埠) 和 "rhttpproxy.ext.port2:"port_number" (用於 HTTPS 連接埠)。

下列範例將連接埠 81 和 444 分別指定為 HTTP 和 HTTPS 連接埠:

ports: {"rhttpproxy.ext.port1":"81", "rhttpproxy.ext.port2":"444"}

如需有關 vCenter Server 使用的連接埠的詳細資訊,請參閱 vCenter Server 與 Platform Services Controller 所需的連接埠

備註: 從 vSphere 6.5 Update 2 開始支援 ports 參數。
system.name string

主要網路身分識別。

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

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

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

表 6. new.vcsa區段 os 子區段中的組態參數
名稱 類型 說明
password string

應用裝置作業系統的根使用者密碼。

密碼必須包含 8 至 20 個字元,至少一個大寫字元、一個小寫字元、一個數字,以及一個特殊字元,例如,貨幣符號 ($)、雜湊鍵 (#)、記號 (@)、句點 (.) 或驚歎號 (!)。所有字元必須僅包含不含空格的下部 ASCII 字元。

ntp.servers 字串或陣列

選擇性。用於時間同步化之一或多部 NTP 伺服器的主機名稱或 IP 位址。

若要設定多個 NTP 伺服器,請使用以逗點分隔的多個字串的清單或是以逗點分隔的做為單個字串的清單來提供路徑。例如,
["x.y.z.a", "x.y.z.b"]
"x.y.z.a, x.y.z.b"
ssh.enable Boolean 設定為 true,以便 SSH 管理員登入應用裝置。
備註: vCenter Server Appliance 高可用性需要對應用裝置的遠端 SSH 存取權。
time.tools-sync Boolean

選擇性。設定為 true,以便使用 VMware Tools 時間同步化部署應用裝置。VMware Tools 將應用裝置的時間與 ESxi 主機的時間同步。

如果已設定 NTP 伺服器進行時間同步化,也就是說如果已設定 ntp.servers 參數,則忽略此項。

表 7. new.vcsa 區段 sso 子區段中的組態參數
名稱 類型 說明
password string vCenter Single Sign-On 管理員使用者的密碼 administrator@your_domain_name
  • 如果要將含內嵌式 Platform Services ControllerPlatform Services Controller 應用裝置的 vCenter Server Appliance 部署為新 vCenter Single Sign-On 網域的第一個執行個體,則必須為 vCenter Single Sign-On 管理員使用者設定密碼。

    密碼必須包含 8 至 20 個字元,至少一個大寫字元、一個小寫字元、一個數字,以及一個特殊字元,例如,貨幣符號 ($)、雜湊鍵 (#)、記號 (@)、句點 (.) 或驚歎號 (!)。所有字元都必須為 ASCII 字元。

  • 如果要將 Platform Services Controller 應用裝置部署為現有 vCenter Single Sign-On 網域的複寫合作夥伴,則必須提供合作夥伴 Platform Services Controller 的 vCenter Single Sign-On 管理員使用者的密碼。
  • 如果要部署含外部 Platform Services ControllervCenter Server Appliance,則必須提供外部 Platform Services Controller 的 vCenter Single Sign-On 管理員使用者的密碼。
domain-name string vCenter Single Sign-On 網域名稱,例如 vsphere.local。
  • 如果要將含內嵌式 Platform Services ControllerPlatform Services Controller 應用裝置的 vCenter Server Appliance 部署為新 vCenter Single Sign-On 網域的第一個執行個體,則必須為新的 vCenter Single Sign-On 網域設定密碼。
  • 如果要將含外部 Platform Services ControllerPlatform Services Controller 應用裝置的 vCenter Server Appliance 部署為現有 vCenter Single Sign-On 網域的複寫合作夥伴,則必須提供現有 vCenter Single Sign-On 網域的名稱。
first-instance Boolean

僅當您部署 Platform Services Controller 應用裝置時需要。

預設值為 true

如果要在現有 vCenter Single Sign-On 網域中加入 Platform Services Controller 應用裝置,則設定為 false.

已加入的 Platform Services Controller 執行個體將複寫其基礎結構資料並啟用增強型連結模式。如需管理 Platform Services Controller 服務的相關資訊,請參閱Platform Services Controller 管理

platform.services.controller string

外部 Platform Services Controller 的系統名稱。

僅當您升級含外部 Platform Services ControllervCenter Server Appliance 時需要。

replication-partner-hostname string

合作夥伴 Platform Services Controller 的系統名稱。

僅當您將 Platform Services Controller 應用裝置部署為現有 vCenter Single Sign-On 網域的複寫合作夥伴時需要。

sso.port 整數

合作夥伴 Platform Services Controller 的 HTTPS 反向 Proxy 連接埠。

預設連接埠為 443。僅當合作夥伴 Platform Services Controller 使用自訂 HTTPS 反向 Proxy 連接埠時使用。

site-name string

vCenter Single Sign-On 站台名稱。

僅當您部署含內嵌式 Platform Services ControllervCenter Server Appliance 或部署 Platform Services Controller 應用裝置時需要。

備註: 設定內嵌式連結模式時,使用 Default-First-Site 做為第一個執行個體的站台名稱。

ceip區段中的組態參數

表 8. ceip區段 settings 子區段中的組態參數
名稱 類型 說明
ceip.enabled Boolean 設定為 true以加入此應用裝置的 CEIP。