az stack-hci-vm

注意

此參考是 Azure CLI 的 stack-hci-vm 擴充功能的一部分（2.15.0 版或更高版本）。 擴充功能會在您第一次執行 az stack-hci-vm 命令時自動安裝。 深入了解擴充功能。

使用 stack-hci-vm 管理 virtualmachine。

命令

名稱	Description	類型	狀態
az stack-hci-vm create	建立 VM。	副檔名	GA
az stack-hci-vm delete	刪除 VM。	副檔名	GA
az stack-hci-vm disk	使用 stack-hci-vm 管理 virtualharddisk。	副檔名	GA
az stack-hci-vm disk attach	將磁碟連結至 VM。	副檔名	GA
az stack-hci-vm disk create	建立虛擬硬碟。	副檔名	GA
az stack-hci-vm disk delete	刪除虛擬硬碟。	副檔名	GA
az stack-hci-vm disk detach	從 VM 中斷連結磁碟。	副檔名	GA
az stack-hci-vm disk list	列出所有虛擬硬碟。	副檔名	GA
az stack-hci-vm disk show	取得虛擬硬碟的詳細數據。	副檔名	GA
az stack-hci-vm disk update	更新虛擬硬碟。	副檔名	GA
az stack-hci-vm image	使用 stack-hci-vm 管理映射。	副檔名	GA
az stack-hci-vm image create	建立資源庫映像。	副檔名	GA
az stack-hci-vm image delete	删除映像。	副檔名	GA
az stack-hci-vm image list	列出所有資源庫映像。	副檔名	GA
az stack-hci-vm image show	取得影像的詳細數據。	副檔名	GA
az stack-hci-vm image update	更新映像。	副檔名	GA
az stack-hci-vm list	列出所有 VM。	副檔名	GA
az stack-hci-vm network	使用 stack-hvi-vm 管理網路。	副檔名	GA
az stack-hci-vm network lnet	使用 stack-hci-vm 管理邏輯網路。	副檔名	GA
az stack-hci-vm network lnet create	建立邏輯網路。	副檔名	GA
az stack-hci-vm network lnet delete	刪除邏輯網路。	副檔名	GA
az stack-hci-vm network lnet list	列出所有邏輯網路。	副檔名	GA
az stack-hci-vm network lnet show	取得邏輯網路的詳細數據。	副檔名	GA
az stack-hci-vm network lnet update	更新邏輯網路。	副檔名	GA
az stack-hci-vm network nic	使用 stack-hci-vm 管理 networkinterface。	副檔名	GA
az stack-hci-vm network nic create	建立網路介面。	副檔名	GA
az stack-hci-vm network nic delete	刪除網路介面。	副檔名	GA
az stack-hci-vm network nic list	列出所有網路介面。	副檔名	GA
az stack-hci-vm network nic show	取得網路介面的詳細數據。	副檔名	GA
az stack-hci-vm network nic update	更新網路介面。	副檔名	GA
az stack-hci-vm network nsg	管理網路安全組 （NSG）。	副檔名	GA
az stack-hci-vm network nsg create	建立網路安全性群組。	副檔名	GA
az stack-hci-vm network nsg delete	刪除網路安全組。	副檔名	GA
az stack-hci-vm network nsg list	列出網路安全組。	副檔名	GA
az stack-hci-vm network nsg rule	管理網路安全組規則。	副檔名	GA
az stack-hci-vm network nsg rule create	建立網路安全組規則。	副檔名	GA
az stack-hci-vm network nsg rule delete	刪除網路安全組規則。	副檔名	GA
az stack-hci-vm network nsg rule list	列出網路安全組中的所有規則。	副檔名	GA
az stack-hci-vm network nsg rule show	取得網路安全組規則的詳細數據。	副檔名	GA
az stack-hci-vm network nsg rule update	更新網路安全組規則。	副檔名	GA
az stack-hci-vm network nsg show	取得網路安全組的相關信息。	副檔名	GA
az stack-hci-vm network nsg update	更新網路安全性群組。	副檔名	GA
az stack-hci-vm nic	使用 stack-hci-vm 管理虛擬機的 vNIC。	副檔名	GA
az stack-hci-vm nic add	將現有的 vNIC 新增至 VM。	副檔名	GA
az stack-hci-vm nic remove	從 VM 移除 vNIC。	副檔名	GA
az stack-hci-vm pause	暫停 VM。	副檔名	GA
az stack-hci-vm restart	重新啟動 VM。	副檔名	GA
az stack-hci-vm save	儲存 VM。	副檔名	GA
az stack-hci-vm show	取得 VM 的詳細數據。	副檔名	GA
az stack-hci-vm start	啟動已停止的 VM。	副檔名	GA
az stack-hci-vm stop	關閉 （停止） 執行中的 VM。	副檔名	GA
az stack-hci-vm storagepath	使用 stack-hci-vm 管理記憶體路徑。	副檔名	GA
az stack-hci-vm storagepath create	建立記憶體路徑。	副檔名	GA
az stack-hci-vm storagepath delete	刪除記憶體路徑。	副檔名	GA
az stack-hci-vm storagepath list	列出所有記憶體路徑。	副檔名	GA
az stack-hci-vm storagepath show	取得記憶體路徑的詳細數據。	副檔名	GA
az stack-hci-vm storagepath update	更新記憶體路徑。	副檔名	GA
az stack-hci-vm update	更新 VM。	副檔名	GA

az stack-hci-vm create

建立 VM。

az stack-hci-vm create --custom-location
                       --name
                       --resource-group
                       [--admin-password]
                       [--admin-username]
                       [--attach-data-disks]
                       [--authentication-type {all, password, ssh}]
                       [--computer-name]
                       [--enable-agent {false, true}]
                       [--enable-secure-boot {false, true}]
                       [--enable-vm-config-agent {false, true}]
                       [--enable-vtpm {false, true}]
                       [--image]
                       [--location]
                       [--nics]
                       [--os-disk-name]
                       [--os-type {linux, windows}]
                       [--polling-interval]
                       [--proxy-configuration]
                       [--security-type {ConfidentialVM, TrustedLaunch}]
                       [--size]
                       [--ssh-dest-key-path]
                       [--ssh-key-values]
                       [--storage-path-id]
                       [--tags]

範例

建立 Stack HCI VM

az stack-hci-vm create --resource-group "test-rg" --custom-location "/subscriptions/a95612cb-f1fa-4daa-a4fd-272844fa512c/resourceGroups/dogfoodarc/providers/Microsoft.ExtendedLocatio n/customLocations/dogfood-location" --location "West US2" --size "Default" --nics "test-nic" --computer-name "test-machine" --admin-username xxx --admin-password xxx --image "test-gallery-image" --storage-path-id "/subscriptions/a95612cb-f1fa-4daa-a4fd-272844fa512c/resourceGroups/dogfoodarc/providers/Microsoft.AzureStackHCI/storagecontainers/test-storagepath" --name "test-vm" --authentication-type all --enable-agent true --ssh-key-values @key-file

必要參數

--custom-location

擴充位置的標識碼。

--name

虛擬機的名稱。

--resource-group -g

資源群組的名稱。 您可以使用 az configure --defaults group=<name> 來設定預設群組。

選擇性參數

--admin-password

如果驗證類型為 「密碼」，則 VM 的密碼。

--admin-username

VM 的用戶名稱。

--attach-data-disks

將現有的數據磁碟連結至 VM。 可以使用受控磁碟的名稱或標識碼。

--authentication-type

要與 VM 搭配使用的驗證類型。 預設為 Windows 和 Linux 的 SSH 公鑰密碼。 “all” 同時啟用 ssh 和密碼驗證。

接受的值: all, password, ssh

--computer-name

計算機的名稱。

--enable-agent

指出虛擬機器代理程式是否應該佈建在虛擬機上。 未指定此屬性時，預設行為是將它設定為 true。 這可確保 VM 代理程式已安裝在 VM 上，以便稍後將擴充功能新增至 VM。

接受的值: false, true

--enable-secure-boot

啟用安全開機。

接受的值: false, true

--enable-vm-config-agent

指出虛擬機組態代理程式是否應在虛擬機上佈建。 未指定此屬性時，預設行為是將它設定為 true。

接受的值: false, true

--enable-vtpm

啟用 vtpm - 在 VM 的安全性設定中啟用 vTPM。 如果未提供旗標，預設值為 False。

使用量：--enable-vtpm=XX。

接受的值: false, true

預設值: False

--image

映射 - VM 應該用來布建的映射庫映像名稱。

--location -l

如果未指定location，則會使用資源群組的位置。

--nics

要連結至 VM 之現有 NIC 的名稱或識別碼。

--os-disk-name

Os 磁碟 - VM 應該用來布建的 vhd 名稱。

--os-type

安裝在自定義 VHD 上的 OS 類型。 指定 URN 或 URN 別名時請勿使用。

接受的值: linux, windows

--polling-interval

長時間執行作業的ARM輪詢間隔。

--proxy-configuration

ProxyConfiguration - 描述虛擬機的 Proxy 設定。

--security-type

指定虛擬機的安全性類型。

接受的值: ConfidentialVM, TrustedLaunch

--size

要建立的 VM 大小。

--ssh-dest-key-path

SSH 金鑰 VM 上的目的地檔案路徑。

--ssh-key-values

SSH 公鑰或公鑰檔案路徑的空間分隔清單。

--storage-path-id

指向 VM 組態檔儲存位置之記憶體路徑的 Azure 識別碼。

--tags

以空格分隔的標記：key[=value] [key[=value] ...]。使用 「清除現有的標記」。

全域參數

--debug

增加記錄詳細資訊，以顯示所有偵錯記錄。

--help -h

顯示此說明訊息並結束。

--only-show-errors

只顯示錯誤，隱藏警告。

--output -o

輸出格式。

接受的值: json, jsonc, none, table, tsv, yaml, yamlc

預設值: json

--query

JMESPath 查詢字串。 如需詳細資訊和範例，請參閱 http://jmespath.org/。

--subscription

訂用帳戶的名稱或識別碼。 您可以使用 az account set -s NAME_OR_ID 設定預設訂用帳戶。

--verbose

增加記錄詳細資訊。 使用 --debug 來取得完整偵錯記錄。

az stack-hci-vm delete

刪除 VM。

az stack-hci-vm delete [--ids]
                       [--name]
                       [--polling-interval]
                       [--resource-group]
                       [--subscription]
                       [--yes]

範例

DeleteVirtualMachine

az stack-hci-vm delete --resource-group "test-rg" --name "test-vm"

選擇性參數

--ids

一或多個資源識別碼 (以空格分隔)。 它應該是完整資源識別碼，其中包含「資源標識碼」引數的所有資訊。 您應該提供 --ids 或其他「資源識別碼」引數。

--name

虛擬機的名稱。

--polling-interval

長時間執行作業的ARM輪詢間隔。

--resource-group -g

資源群組的名稱。 您可以使用 az configure --defaults group=<name> 來設定預設群組。

--subscription

訂用帳戶的名稱或識別碼。 您可以使用 az account set -s NAME_OR_ID 設定預設訂用帳戶。

--yes -y

不提示確認。

預設值: False

全域參數

--debug

增加記錄詳細資訊，以顯示所有偵錯記錄。

--help -h

顯示此說明訊息並結束。

--only-show-errors

只顯示錯誤，隱藏警告。

--output -o

輸出格式。

接受的值: json, jsonc, none, table, tsv, yaml, yamlc

預設值: json

--query

JMESPath 查詢字串。 如需詳細資訊和範例，請參閱 http://jmespath.org/。

--subscription

訂用帳戶的名稱或識別碼。 您可以使用 az account set -s NAME_OR_ID 設定預設訂用帳戶。

--verbose

增加記錄詳細資訊。 使用 --debug 來取得完整偵錯記錄。

az stack-hci-vm list

列出所有 VM。

az stack-hci-vm list [--resource-group]

範例

ListVirtualMachineByResourceGroup

az stack-hci-vm list --resource-group "test-rg"

ListVirtualMachineBySubscription

az stack-hci-vm list

選擇性參數

--resource-group -g

資源群組的名稱。 您可以使用 az configure --defaults group=<name> 來設定預設群組。

全域參數

--debug

增加記錄詳細資訊，以顯示所有偵錯記錄。

--help -h

顯示此說明訊息並結束。

--only-show-errors

只顯示錯誤，隱藏警告。

--output -o

輸出格式。

接受的值: json, jsonc, none, table, tsv, yaml, yamlc

預設值: json

--query

JMESPath 查詢字串。 如需詳細資訊和範例，請參閱 http://jmespath.org/。

--subscription

訂用帳戶的名稱或識別碼。 您可以使用 az account set -s NAME_OR_ID 設定預設訂用帳戶。

--verbose

增加記錄詳細資訊。 使用 --debug 來取得完整偵錯記錄。

az stack-hci-vm pause

暫停 VM。

az stack-hci-vm pause [--ids]
                      [--name]
                      [--polling-interval]
                      [--resource-group]
                      [--subscription]

範例

PauseVirtualMachine

az stack-hci-vm pause --resource-group "test-rg" --name "test-vm"

選擇性參數

--ids

一或多個資源識別碼 (以空格分隔)。 它應該是完整資源識別碼，其中包含「資源標識碼」引數的所有資訊。 您應該提供 --ids 或其他「資源識別碼」引數。

--name

虛擬機的名稱。

--polling-interval

長時間執行作業的ARM輪詢間隔。

--resource-group -g

資源群組的名稱。 您可以使用 az configure --defaults group=<name> 來設定預設群組。

--subscription

訂用帳戶的名稱或識別碼。 您可以使用 az account set -s NAME_OR_ID 設定預設訂用帳戶。

全域參數

--debug

增加記錄詳細資訊，以顯示所有偵錯記錄。

--help -h

顯示此說明訊息並結束。

--only-show-errors

只顯示錯誤，隱藏警告。

--output -o

輸出格式。

接受的值: json, jsonc, none, table, tsv, yaml, yamlc

預設值: json

--query

JMESPath 查詢字串。 如需詳細資訊和範例，請參閱 http://jmespath.org/。

--subscription

訂用帳戶的名稱或識別碼。 您可以使用 az account set -s NAME_OR_ID 設定預設訂用帳戶。

--verbose

增加記錄詳細資訊。 使用 --debug 來取得完整偵錯記錄。

az stack-hci-vm restart

重新啟動 VM。

az stack-hci-vm restart [--ids]
                        [--name]
                        [--polling-interval]
                        [--resource-group]
                        [--subscription]

範例

RestartVirtualMachine

az stack-hci-vm restart --resource-group "test-rg" --name "test-vm"

選擇性參數

--ids

一或多個資源識別碼 (以空格分隔)。 它應該是完整資源識別碼，其中包含「資源標識碼」引數的所有資訊。 您應該提供 --ids 或其他「資源識別碼」引數。

--name

虛擬機的名稱。

--polling-interval

長時間執行作業的ARM輪詢間隔。

--resource-group -g

資源群組的名稱。 您可以使用 az configure --defaults group=<name> 來設定預設群組。

--subscription

訂用帳戶的名稱或識別碼。 您可以使用 az account set -s NAME_OR_ID 設定預設訂用帳戶。

全域參數

--debug

增加記錄詳細資訊，以顯示所有偵錯記錄。

--help -h

顯示此說明訊息並結束。

--only-show-errors

只顯示錯誤，隱藏警告。

--output -o

輸出格式。

接受的值: json, jsonc, none, table, tsv, yaml, yamlc

預設值: json

--query

JMESPath 查詢字串。 如需詳細資訊和範例，請參閱 http://jmespath.org/。

--subscription

訂用帳戶的名稱或識別碼。 您可以使用 az account set -s NAME_OR_ID 設定預設訂用帳戶。

--verbose

增加記錄詳細資訊。 使用 --debug 來取得完整偵錯記錄。

az stack-hci-vm save

儲存 VM。

az stack-hci-vm save [--ids]
                     [--name]
                     [--polling-interval]
                     [--resource-group]
                     [--subscription]

範例

SaveVirtualMachine

az stack-hci-vm save --resource-group "test-rg" --name "test-vm"

選擇性參數

--ids

一或多個資源識別碼 (以空格分隔)。 它應該是完整資源識別碼，其中包含「資源標識碼」引數的所有資訊。 您應該提供 --ids 或其他「資源識別碼」引數。

--name

虛擬機的名稱。

--polling-interval

長時間執行作業的ARM輪詢間隔。

--resource-group -g

資源群組的名稱。 您可以使用 az configure --defaults group=<name> 來設定預設群組。

--subscription

訂用帳戶的名稱或識別碼。 您可以使用 az account set -s NAME_OR_ID 設定預設訂用帳戶。

全域參數

--debug

增加記錄詳細資訊，以顯示所有偵錯記錄。

--help -h

顯示此說明訊息並結束。

--only-show-errors

只顯示錯誤，隱藏警告。

--output -o

輸出格式。

接受的值: json, jsonc, none, table, tsv, yaml, yamlc

預設值: json

--query

JMESPath 查詢字串。 如需詳細資訊和範例，請參閱 http://jmespath.org/。

--subscription

訂用帳戶的名稱或識別碼。 您可以使用 az account set -s NAME_OR_ID 設定預設訂用帳戶。

--verbose

增加記錄詳細資訊。 使用 --debug 來取得完整偵錯記錄。

az stack-hci-vm show

取得 VM 的詳細數據。

az stack-hci-vm show [--ids]
                     [--name]
                     [--resource-group]
                     [--subscription]

範例

GetVirtualMachine

az stack-hci-vm show --resource-group "test-rg" --name "test-vm"

選擇性參數

--ids

一或多個資源識別碼 (以空格分隔)。 它應該是完整資源識別碼，其中包含「資源標識碼」引數的所有資訊。 您應該提供 --ids 或其他「資源識別碼」引數。

--name

虛擬機的名稱。

--resource-group -g

資源群組的名稱。 您可以使用 az configure --defaults group=<name> 來設定預設群組。

--subscription

訂用帳戶的名稱或識別碼。 您可以使用 az account set -s NAME_OR_ID 設定預設訂用帳戶。

全域參數

--debug

增加記錄詳細資訊，以顯示所有偵錯記錄。

--help -h

顯示此說明訊息並結束。

--only-show-errors

只顯示錯誤，隱藏警告。

--output -o

輸出格式。

接受的值: json, jsonc, none, table, tsv, yaml, yamlc

預設值: json

--query

JMESPath 查詢字串。 如需詳細資訊和範例，請參閱 http://jmespath.org/。

--subscription

訂用帳戶的名稱或識別碼。 您可以使用 az account set -s NAME_OR_ID 設定預設訂用帳戶。

--verbose

增加記錄詳細資訊。 使用 --debug 來取得完整偵錯記錄。

az stack-hci-vm start

啟動已停止的 VM。

az stack-hci-vm start [--ids]
                      [--name]
                      [--polling-interval]
                      [--resource-group]
                      [--subscription]

範例

StartVirtualMachine

az stack-hci-vm start --resource-group "test-rg" --name "test-vm"

選擇性參數

--ids

一或多個資源識別碼 (以空格分隔)。 它應該是完整資源識別碼，其中包含「資源標識碼」引數的所有資訊。 您應該提供 --ids 或其他「資源識別碼」引數。

--name

虛擬機的名稱。

--polling-interval

長時間執行作業的ARM輪詢間隔。

--resource-group -g

資源群組的名稱。 您可以使用 az configure --defaults group=<name> 來設定預設群組。

--subscription

訂用帳戶的名稱或識別碼。 您可以使用 az account set -s NAME_OR_ID 設定預設訂用帳戶。

全域參數

--debug

增加記錄詳細資訊，以顯示所有偵錯記錄。

--help -h

顯示此說明訊息並結束。

--only-show-errors

只顯示錯誤，隱藏警告。

--output -o

輸出格式。

接受的值: json, jsonc, none, table, tsv, yaml, yamlc

預設值: json

--query

JMESPath 查詢字串。 如需詳細資訊和範例，請參閱 http://jmespath.org/。

--subscription

訂用帳戶的名稱或識別碼。 您可以使用 az account set -s NAME_OR_ID 設定預設訂用帳戶。

--verbose

增加記錄詳細資訊。 使用 --debug 來取得完整偵錯記錄。

az stack-hci-vm stop

關閉 （停止） 執行中的 VM。

az stack-hci-vm stop [--ids]
                     [--name]
                     [--polling-interval]
                     [--resource-group]
                     [--subscription]

範例

StopVirtualMachine

az stack-hci-vm stop --resource-group "test-rg" --name "test-vm"

選擇性參數

--ids

一或多個資源識別碼 (以空格分隔)。 它應該是完整資源識別碼，其中包含「資源標識碼」引數的所有資訊。 您應該提供 --ids 或其他「資源識別碼」引數。

--name

虛擬機的名稱。

--polling-interval

長時間執行作業的ARM輪詢間隔。

--resource-group -g

資源群組的名稱。 您可以使用 az configure --defaults group=<name> 來設定預設群組。

--subscription

訂用帳戶的名稱或識別碼。 您可以使用 az account set -s NAME_OR_ID 設定預設訂用帳戶。

全域參數

--debug

增加記錄詳細資訊，以顯示所有偵錯記錄。

--help -h

顯示此說明訊息並結束。

--only-show-errors

只顯示錯誤，隱藏警告。

--output -o

輸出格式。

接受的值: json, jsonc, none, table, tsv, yaml, yamlc

預設值: json

--query

JMESPath 查詢字串。 如需詳細資訊和範例，請參閱 http://jmespath.org/。

--subscription

訂用帳戶的名稱或識別碼。 您可以使用 az account set -s NAME_OR_ID 設定預設訂用帳戶。

--verbose

增加記錄詳細資訊。 使用 --debug 來取得完整偵錯記錄。

az stack-hci-vm update

更新 VM。

az stack-hci-vm update [--add]
                       [--computer-name]
                       [--enable-agent {false, true}]
                       [--enable-vm-config-agent {false, true}]
                       [--force-string]
                       [--ids]
                       [--memory-mb]
                       [--name]
                       [--nics]
                       [--polling-interval]
                       [--remove]
                       [--resource-group]
                       [--set]
                       [--subscription]
                       [--tags]
                       [--v-cpus-available]
                       [--vhds]

範例

UpdateVirtualMachine

az stack-hci-vm update --resource-group "test-rg" --tags additionalProperties="sample" --name "test-vm" --v-cpus-available XX --memory-mb XX

選擇性參數

--add

藉由指定路徑和索引鍵值組，將物件加入物件清單。 範例：--add property.listProperty <key=value, string or JSON string>。

預設值: []

--computer-name

更新 VM 的主機名。

--enable-agent

指出虛擬機更新期間是否應在虛擬機上佈建虛擬機代理程式。 這可確保 VM 代理程式已安裝在 VM 上，以便稍後將擴充功能新增至 VM。

接受的值: false, true

--enable-vm-config-agent

指出虛擬機設定代理程式是否應在虛擬機更新期間佈建在虛擬機上。

接受的值: false, true

--force-string

使用 'set' 或 'add' 時，請保留字串常值，而不是嘗試轉換成 JSON。

預設值: False

--ids

一或多個資源識別碼 (以空格分隔)。 它應該是完整資源識別碼，其中包含「資源標識碼」引數的所有資訊。 您應該提供 --ids 或其他「資源識別碼」引數。

--memory-mb

虛擬機的 RAM 以 mb 為單位。

--name

虛擬機的名稱。

--nics

vnic 名稱的清單。

--polling-interval

長時間執行作業的ARM輪詢間隔。

--remove

從清單中移除屬性或專案。 範例： --remove property.list <indexToRemove> 或 --remove propertyToRemove。

預設值: []

--resource-group -g

資源群組的名稱。 您可以使用 az configure --defaults group=<name> 來設定預設群組。

--set

指定要設定的屬性路徑和值，以更新物件。 範例：--set property1.property2=<value>。

預設值: []

--subscription

訂用帳戶的名稱或識別碼。 您可以使用 az account set -s NAME_OR_ID 設定預設訂用帳戶。

--tags

以空格分隔的標記：key[=value] [key[=value] ...]。使用 「清除現有的標記」。

--v-cpus-available

指定可用的 vCPU 數目。

--vhds

虛擬硬碟名稱的清單。

全域參數

--debug

增加記錄詳細資訊，以顯示所有偵錯記錄。

--help -h

顯示此說明訊息並結束。

--only-show-errors

只顯示錯誤，隱藏警告。

--output -o

輸出格式。

接受的值: json, jsonc, none, table, tsv, yaml, yamlc

預設值: json

--query

JMESPath 查詢字串。 如需詳細資訊和範例，請參閱 http://jmespath.org/。

--subscription

訂用帳戶的名稱或識別碼。 您可以使用 az account set -s NAME_OR_ID 設定預設訂用帳戶。

--verbose

增加記錄詳細資訊。 使用 --debug 來取得完整偵錯記錄。