az networkcloud virtualmachine
注意
此參考是 Azure CLI networkcloud 擴充功能的一部分(2.67.0 版或更高版本)。 擴充功能會在您第一次執行 az networkcloud virtualmachine 命令時自動安裝。 深入了解擴充功能。
管理虛擬機。
命令
az networkcloud virtualmachine create
建立新的虛擬機,或更新現有虛擬機的屬性。
az networkcloud virtualmachine create --admin-username
--cloud-services-network-attachment
--cpu-cores
--extended-location
--memory-size
--name
--resource-group
--storage-profile
--vm-image
[--boot-method {BIOS, UEFI}]
[--ce-location]
[--generate-ssh-keys {0, 1, f, false, n, no, t, true, y, yes}]
[--if-match]
[--if-none-match]
[--location]
[--na]
[--nd]
[--no-wait {0, 1, f, false, n, no, t, true, y, yes}]
[--ph]
[--ssh-dest-key-path]
[--ssh-key-values]
[--tags]
[--ud]
[--vm-device-model {T1, T2, T3}]
[--vm-image-repository-credentials]
範例
建立虛擬機器
az networkcloud virtualmachine create --resource-group "resourceGroupName" --name "virtualMachineName" --extended-location name="/subscriptions/subscriptionId/resourceGroups/resourceGroupName/providers/Microsoft.ExtendedLocation/customLocations/clusterExtendedLocationName" type="CustomLocation" --location "location" --admin-username "admin" --boot-method "UEFI" --cloud-services-network-attachment attached-network-id="/subscriptions/subscriptionId/resourceGroups/resourceGroupName/providers/Microsoft.NetworkCloud/CloudServicesNetworks/cloudServicesNetworkName" --cpu-cores 2 --memory-size 8 --network-attachments "[{attachedNetworkId:'/subscriptions/subscriptionId/resourceGroups/resourceGroupName/providers/Microsoft.NetworkCloud/l3Networks/l3NetworkName',defaultGateway:'True',ipAllocationMethod:'Dynamic',ipv4Address:'198.51.100.1',ipv6Address:'2001:0db8:0000:0000:0000:0000:0000:0000',networkAttachmentName:'networkAttachmentName'}]" --network-data "bmV0d29ya0RhdGVTYW1wbGU=" --placement-hints "[{hintType:'Affinity',resourceId:'/subscriptions/subscriptionId/resourceGroups/resourceGroupName/providers/Microsoft.NetworkCloud/racks/rackName',schedulingExecution:'Hard,scope:''}]" --ssh-key-values "ssh-rsa AAtsE3njSONzDYRIZv/WLjVuMfrUSByHp+jfaaOLHTIIB4fJvo6dQUZxE20w2iDHV3tEkmnTo84eba97VMueQD6OzJPEyWZMRpz8UYWOd0IXeRqiFu1lawNblZhwNT= admin@vm" --storage-profile disk-size=120 create-option="Ephemeral" delete-option="Delete" --tags key1="myvalues1" --tags key2="myvalues2" --user-data "dXNlckRhdGVTYW1wbGU=" --vm-device-model "T2" --vm-image "myacr.azurecr.io/ubuntu-pw:20.04" --vm-image-repository-credentials password="password" registry-url="myacr.azurecr.io" username="username"
必要參數
將 SSH 公鑰新增至授權金鑰的系統管理員名稱。
提供虛擬機平臺層級服務的雲端服務網路。 支援速記語法、json-file 和 yaml-file。 請嘗試 “??” 以顯示更多。
虛擬機中的 CPU 核心數目。
與資源相關聯的叢集擴充位置。 支援速記語法、json-file 和 yaml-file。 請嘗試 “??” 以顯示更多。
以 gibibytes 為單位的虛擬機記憶體大小。
虛擬機器的名稱。
資源群組的名稱。 您可以使用 az configure --defaults group=<name>
來設定預設群組。
記憶體配置檔,指定與虛擬機相關磁碟的大小和其他參數。 支援速記語法、json-file 和 yaml-file。 請嘗試 “??” 以顯示更多。
目前布建至 OS 磁碟的虛擬機映射,使用用來提取映射的完整 URL 和標記表示法。
選擇性參數
選取虛擬機的開機方法。
用來建立 VM 控制台資源的擴充位置。 支援速記語法、json-file 和 yaml-file。 請嘗試 “??” 以顯示更多。
如果遺失,請產生 SSH 公開和私鑰檔案。 密鑰會儲存在 '~/.ssh' 底下。
轉換的ETag。 請省略此值以一律覆寫目前的資源。 指定最後看到的 ETag 值,以防止意外覆寫並行變更。
設定為 『*』 以允許建立新的記錄集,但為了避免更新現有的資源。 其他值會導致伺服器發生錯誤,因為它們不受支援。
未指定資源所在的地理位置,將會使用資源群組的位置。
虛擬機的網路附件清單。 支援速記語法、json-file 和 yaml-file。 請嘗試 “??” 以顯示更多。
Base64 編碼的 cloud-init 網路數據。
請勿等候長時間執行的作業完成。
虛擬機的排程提示。 支援速記語法、json-file 和 yaml-file。 請嘗試 “??” 以顯示更多。
ssh 公鑰的空間分隔路徑清單。 您可以提供檔案路徑或目錄。 如果提供目錄,將會嘗試載入找到的所有公鑰(.pub)。 支援速記語法、json-file 和 yaml-file。 請嘗試 “??” 以顯示更多。
以空格分隔的 SSH 公鑰清單。 支援速記語法、json-file 和 yaml-file。 請嘗試 “??” 以顯示更多。
資源標籤。 支援速記語法、json-file 和 yaml-file。 請嘗試 “??” 以顯示更多。
Base64 編碼的 cloud-init 用戶數據。
要使用的裝置型號類型。
用來登入可存取指定映像之映像存放庫的認證。 支援速記語法、json-file 和 yaml-file。 請嘗試 “??” 以顯示更多。
全域參數
增加記錄詳細資訊,以顯示所有偵錯記錄。
顯示此說明訊息並結束。
只顯示錯誤,隱藏警告。
輸出格式。
JMESPath 查詢字串。 如需詳細資訊和範例,請參閱 http://jmespath.org/。
訂用帳戶的名稱或識別碼。 您可以使用 az account set -s NAME_OR_ID
設定預設訂用帳戶。
增加記錄詳細資訊。 使用 --debug 來取得完整偵錯記錄。
az networkcloud virtualmachine delete
刪除提供的虛擬機。
az networkcloud virtualmachine delete [--ids]
[--if-match]
[--if-none-match]
[--name]
[--no-wait {0, 1, f, false, n, no, t, true, y, yes}]
[--resource-group]
[--subscription]
[--yes]
範例
刪除虛擬機
az networkcloud virtualmachine delete --resource-group "resourceGroupName" --name "virtualMachineName"
選擇性參數
一或多個資源識別碼 (以空格分隔)。 它應該是完整資源識別碼,其中包含「資源標識碼」引數的所有資訊。 您應該提供 --ids 或其他「資源識別碼」引數。
轉換的ETag。 請省略此值以一律覆寫目前的資源。 指定最後看到的 ETag 值,以防止意外覆寫並行變更。
設定為 『*』 以允許建立新的記錄集,但為了避免更新現有的資源。 其他值會導致伺服器發生錯誤,因為它們不受支援。
虛擬機器的名稱。
請勿等候長時間執行的作業完成。
資源群組的名稱。 您可以使用 az configure --defaults group=<name>
來設定預設群組。
訂用帳戶的名稱或識別碼。 您可以使用 az account set -s NAME_OR_ID
設定預設訂用帳戶。
不提示確認。
全域參數
增加記錄詳細資訊,以顯示所有偵錯記錄。
顯示此說明訊息並結束。
只顯示錯誤,隱藏警告。
輸出格式。
JMESPath 查詢字串。 如需詳細資訊和範例,請參閱 http://jmespath.org/。
訂用帳戶的名稱或識別碼。 您可以使用 az account set -s NAME_OR_ID
設定預設訂用帳戶。
增加記錄詳細資訊。 使用 --debug 來取得完整偵錯記錄。
az networkcloud virtualmachine list
列出所提供資源群組或訂用帳戶中的虛擬機。
az networkcloud virtualmachine list [--max-items]
[--next-token]
[--resource-group]
範例
列出資源群組的虛擬機
az networkcloud virtualmachine list --resource-group "resourceGroupName"
列出訂用帳戶的虛擬機
az networkcloud virtualmachine list
選擇性參數
命令輸出中要傳回的項目總數。 如果可用的專案總數超過指定的值,則會在命令的輸出中提供令牌。 若要繼續分頁,請在後續命令的自變數中 --next-token
提供令牌值。
標記,指定要開始分頁的位置。 這是先前截斷回應中的令牌值。
資源群組的名稱。 您可以使用 az configure --defaults group=<name>
來設定預設群組。
全域參數
增加記錄詳細資訊,以顯示所有偵錯記錄。
顯示此說明訊息並結束。
只顯示錯誤,隱藏警告。
輸出格式。
JMESPath 查詢字串。 如需詳細資訊和範例,請參閱 http://jmespath.org/。
訂用帳戶的名稱或識別碼。 您可以使用 az account set -s NAME_OR_ID
設定預設訂用帳戶。
增加記錄詳細資訊。 使用 --debug 來取得完整偵錯記錄。
az networkcloud virtualmachine power-off
關閉提供的虛擬機電源。
az networkcloud virtualmachine power-off [--ids]
[--name]
[--no-wait {0, 1, f, false, n, no, t, true, y, yes}]
[--resource-group]
[--skip-shutdown {False, True}]
[--subscription]
範例
關閉虛擬機電源
az networkcloud virtualmachine power-off --resource-group "resourceGroupName" --name "virtualMachineName" --skip-shutdown "True"
選擇性參數
一或多個資源識別碼 (以空格分隔)。 它應該是完整資源識別碼,其中包含「資源標識碼」引數的所有資訊。 您應該提供 --ids 或其他「資源識別碼」引數。
虛擬機器的名稱。
請勿等候長時間執行的作業完成。
資源群組的名稱。 您可以使用 az configure --defaults group=<name>
來設定預設群組。
是否要立即略過正常 OS 關機和關閉虛擬機電源的指標。
訂用帳戶的名稱或識別碼。 您可以使用 az account set -s NAME_OR_ID
設定預設訂用帳戶。
全域參數
增加記錄詳細資訊,以顯示所有偵錯記錄。
顯示此說明訊息並結束。
只顯示錯誤,隱藏警告。
輸出格式。
JMESPath 查詢字串。 如需詳細資訊和範例,請參閱 http://jmespath.org/。
訂用帳戶的名稱或識別碼。 您可以使用 az account set -s NAME_OR_ID
設定預設訂用帳戶。
增加記錄詳細資訊。 使用 --debug 來取得完整偵錯記錄。
az networkcloud virtualmachine reimage
重新建立所提供虛擬機的映像。
az networkcloud virtualmachine reimage [--ids]
[--name]
[--no-wait {0, 1, f, false, n, no, t, true, y, yes}]
[--resource-group]
[--subscription]
範例
重新映像虛擬機
az networkcloud virtualmachine reimage --resource-group "resourceGroupName" --name "virtualMachineName"
選擇性參數
一或多個資源識別碼 (以空格分隔)。 它應該是完整資源識別碼,其中包含「資源標識碼」引數的所有資訊。 您應該提供 --ids 或其他「資源識別碼」引數。
虛擬機器的名稱。
請勿等候長時間執行的作業完成。
資源群組的名稱。 您可以使用 az configure --defaults group=<name>
來設定預設群組。
訂用帳戶的名稱或識別碼。 您可以使用 az account set -s NAME_OR_ID
設定預設訂用帳戶。
全域參數
增加記錄詳細資訊,以顯示所有偵錯記錄。
顯示此說明訊息並結束。
只顯示錯誤,隱藏警告。
輸出格式。
JMESPath 查詢字串。 如需詳細資訊和範例,請參閱 http://jmespath.org/。
訂用帳戶的名稱或識別碼。 您可以使用 az account set -s NAME_OR_ID
設定預設訂用帳戶。
增加記錄詳細資訊。 使用 --debug 來取得完整偵錯記錄。
az networkcloud virtualmachine restart
重新啟動提供的虛擬機。
az networkcloud virtualmachine restart [--ids]
[--name]
[--no-wait {0, 1, f, false, n, no, t, true, y, yes}]
[--resource-group]
[--subscription]
範例
重新啟動虛擬機器
az networkcloud virtualmachine restart --resource-group "resourceGroupName" --name "virtualMachineName"
選擇性參數
一或多個資源識別碼 (以空格分隔)。 它應該是完整資源識別碼,其中包含「資源標識碼」引數的所有資訊。 您應該提供 --ids 或其他「資源識別碼」引數。
虛擬機器的名稱。
請勿等候長時間執行的作業完成。
資源群組的名稱。 您可以使用 az configure --defaults group=<name>
來設定預設群組。
訂用帳戶的名稱或識別碼。 您可以使用 az account set -s NAME_OR_ID
設定預設訂用帳戶。
全域參數
增加記錄詳細資訊,以顯示所有偵錯記錄。
顯示此說明訊息並結束。
只顯示錯誤,隱藏警告。
輸出格式。
JMESPath 查詢字串。 如需詳細資訊和範例,請參閱 http://jmespath.org/。
訂用帳戶的名稱或識別碼。 您可以使用 az account set -s NAME_OR_ID
設定預設訂用帳戶。
增加記錄詳細資訊。 使用 --debug 來取得完整偵錯記錄。
az networkcloud virtualmachine show
取得所提供虛擬機的屬性。
az networkcloud virtualmachine show [--ids]
[--name]
[--resource-group]
[--subscription]
範例
取得虛擬機器
az networkcloud virtualmachine show --resource-group "resourceGroupName" --name "virtualMachineName"
選擇性參數
一或多個資源識別碼 (以空格分隔)。 它應該是完整資源識別碼,其中包含「資源標識碼」引數的所有資訊。 您應該提供 --ids 或其他「資源識別碼」引數。
虛擬機器的名稱。
資源群組的名稱。 您可以使用 az configure --defaults group=<name>
來設定預設群組。
訂用帳戶的名稱或識別碼。 您可以使用 az account set -s NAME_OR_ID
設定預設訂用帳戶。
全域參數
增加記錄詳細資訊,以顯示所有偵錯記錄。
顯示此說明訊息並結束。
只顯示錯誤,隱藏警告。
輸出格式。
JMESPath 查詢字串。 如需詳細資訊和範例,請參閱 http://jmespath.org/。
訂用帳戶的名稱或識別碼。 您可以使用 az account set -s NAME_OR_ID
設定預設訂用帳戶。
增加記錄詳細資訊。 使用 --debug 來取得完整偵錯記錄。
az networkcloud virtualmachine start
啟動提供的虛擬機。
az networkcloud virtualmachine start [--ids]
[--name]
[--no-wait {0, 1, f, false, n, no, t, true, y, yes}]
[--resource-group]
[--subscription]
範例
啟動虛擬機器
az networkcloud virtualmachine start --resource-group "resourceGroupName" --name "virtualMachineName"
選擇性參數
一或多個資源識別碼 (以空格分隔)。 它應該是完整資源識別碼,其中包含「資源標識碼」引數的所有資訊。 您應該提供 --ids 或其他「資源識別碼」引數。
虛擬機器的名稱。
請勿等候長時間執行的作業完成。
資源群組的名稱。 您可以使用 az configure --defaults group=<name>
來設定預設群組。
訂用帳戶的名稱或識別碼。 您可以使用 az account set -s NAME_OR_ID
設定預設訂用帳戶。
全域參數
增加記錄詳細資訊,以顯示所有偵錯記錄。
顯示此說明訊息並結束。
只顯示錯誤,隱藏警告。
輸出格式。
JMESPath 查詢字串。 如需詳細資訊和範例,請參閱 http://jmespath.org/。
訂用帳戶的名稱或識別碼。 您可以使用 az account set -s NAME_OR_ID
設定預設訂用帳戶。
增加記錄詳細資訊。 使用 --debug 來取得完整偵錯記錄。
az networkcloud virtualmachine update
更新所提供虛擬機的屬性,或更新與虛擬機相關聯的標記。 屬性和標籤更新可以獨立完成。
az networkcloud virtualmachine update [--ids]
[--if-match]
[--if-none-match]
[--name]
[--no-wait {0, 1, f, false, n, no, t, true, y, yes}]
[--resource-group]
[--subscription]
[--tags]
[--vm-image-repository-credentials]
範例
修補虛擬機
az networkcloud virtualmachine update --resource-group "resourceGroupName" --name "virtualMachineName" --vm-image-repository-credentials password="password" registry-url="myacr.azurecr.io" username="myuser" --tags key1="myvalue1" key2="myvalue2"
選擇性參數
一或多個資源識別碼 (以空格分隔)。 它應該是完整資源識別碼,其中包含「資源標識碼」引數的所有資訊。 您應該提供 --ids 或其他「資源識別碼」引數。
轉換的ETag。 請省略此值以一律覆寫目前的資源。 指定最後看到的 ETag 值,以防止意外覆寫並行變更。
設定為 『*』 以允許建立新的記錄集,但為了避免更新現有的資源。 其他值會導致伺服器發生錯誤,因為它們不受支援。
虛擬機器的名稱。
請勿等候長時間執行的作業完成。
資源群組的名稱。 您可以使用 az configure --defaults group=<name>
來設定預設群組。
訂用帳戶的名稱或識別碼。 您可以使用 az account set -s NAME_OR_ID
設定預設訂用帳戶。
將取代現有資源的 Azure 資源標籤。 支援速記語法、json-file 和 yaml-file。 請嘗試 “??” 以顯示更多。
用來登入可存取指定映像之映像存放庫的認證。 支援速記語法、json-file 和 yaml-file。 請嘗試 “??” 以顯示更多。
全域參數
增加記錄詳細資訊,以顯示所有偵錯記錄。
顯示此說明訊息並結束。
只顯示錯誤,隱藏警告。
輸出格式。
JMESPath 查詢字串。 如需詳細資訊和範例,請參閱 http://jmespath.org/。
訂用帳戶的名稱或識別碼。 您可以使用 az account set -s NAME_OR_ID
設定預設訂用帳戶。
增加記錄詳細資訊。 使用 --debug 來取得完整偵錯記錄。
az networkcloud virtualmachine wait
將 CLI 置於等候狀態,直到符合條件為止。
az networkcloud virtualmachine wait [--created]
[--custom]
[--deleted]
[--exists]
[--ids]
[--interval]
[--name]
[--resource-group]
[--subscription]
[--timeout]
[--updated]
選擇性參數
請等候在 'Succeeded' 使用 'provisioningState' 建立。
等到條件符合自定義 JMESPath 查詢為止。 例如 provisioningState!='InProgress', instanceView.statuses[?code=='PowerState/running']。
等到刪除為止。
等候資源存在。
一或多個資源識別碼 (以空格分隔)。 它應該是完整資源識別碼,其中包含「資源標識碼」引數的所有資訊。 您應該提供 --ids 或其他「資源識別碼」引數。
輪詢間隔以秒為單位。
虛擬機器的名稱。
資源群組的名稱。 您可以使用 az configure --defaults group=<name>
來設定預設群組。
訂用帳戶的名稱或識別碼。 您可以使用 az account set -s NAME_OR_ID
設定預設訂用帳戶。
以秒為單位的等候上限。
等到 provisioningState 更新為 'Succeeded'。
全域參數
增加記錄詳細資訊,以顯示所有偵錯記錄。
顯示此說明訊息並結束。
只顯示錯誤,隱藏警告。
輸出格式。
JMESPath 查詢字串。 如需詳細資訊和範例,請參閱 http://jmespath.org/。
訂用帳戶的名稱或識別碼。 您可以使用 az account set -s NAME_OR_ID
設定預設訂用帳戶。
增加記錄詳細資訊。 使用 --debug 來取得完整偵錯記錄。