az networkcloud virtualmachine
注意
此參考是 Azure CLI 網路雲端 擴充功能的一部分 （2.51.0 版或更高版本）。 擴充功能會在您第一次執行 az networkcloud virtualmachine 命令時自動安裝。 深入了解擴充功能。
命令群組 'az networkcloud' 處於預覽狀態，且正在開發中。 參考和支援層級： https://aka.ms/CLI_refstatus
管理虛擬機器。
命令
az networkcloud virtualmachine create
命令群組 'az networkcloud' 處於預覽狀態，且正在開發中。 參考和支援層級： https://aka.ms/CLI_refstatus
建立新的虛擬機器，或更新現有虛擬機器的屬性。
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}]
[--generate-ssh-keys {0, 1, f, false, n, no, t, true, y, yes}]
[--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}]
[--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。 請嘗試 「？？」 以顯示更多。
以 GB 為單位的虛擬機器記憶體大小。
虛擬機器的名稱。
資源組名。 您可以使用 來設定預設群組 az configure --defaults group=<name> 。
儲存體設定檔，指定與虛擬機器相關磁片的大小和其他參數。 支援速記語法、json-file 和 yaml-file。 請嘗試 「？？」 以顯示更多。
目前布建至 OS 磁片的虛擬機器映射，使用用來提取映射的完整 URL 和標記標記法。
選擇性參數
選取虛擬機器的開機方法。
如果遺失，請產生 SSH 公開和私密金鑰檔案。 金鑰會儲存在 '~/.ssh' 底下。
未指定資源所在的地理位置，將會使用資源群組的位置。
虛擬機器的網路附件清單。 支援速記語法、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' 處於預覽狀態，且正在開發中。 參考和支援層級： https://aka.ms/CLI_refstatus
刪除提供的虛擬機器。
az networkcloud virtualmachine delete [--ids]
[--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 或其他「資源識別碼」引數。
虛擬機器的名稱。
請勿等候長時間執行的作業完成。
資源組名。 您可以使用 來設定預設群組 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' 處於預覽狀態，且正在開發中。 參考和支援層級： https://aka.ms/CLI_refstatus
列出所提供資源群組或訂用帳戶中的虛擬機器。
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' 處於預覽狀態，且正在開發中。 參考和支援層級： https://aka.ms/CLI_refstatus
關閉提供的虛擬機器電源。
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' 處於預覽狀態，且正在開發中。 參考和支援層級： https://aka.ms/CLI_refstatus
重新建立所提供虛擬機器的映射。
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' 處於預覽狀態，且正在開發中。 參考和支援層級： https://aka.ms/CLI_refstatus
重新開機提供的虛擬機器。
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' 處於預覽狀態，且正在開發中。 參考和支援層級： https://aka.ms/CLI_refstatus
取得所提供虛擬機器的屬性。
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' 處於預覽狀態，且正在開發中。 參考和支援層級： https://aka.ms/CLI_refstatus
啟動提供的虛擬機器。
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' 處於預覽狀態，且正在開發中。 參考和支援層級： https://aka.ms/CLI_refstatus
更新所提供虛擬機器的屬性，或更新與虛擬機器相關聯的標記。 屬性和標記更新可以獨立完成。
az networkcloud virtualmachine update [--ids]
[--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 或其他「資源識別碼」引數。
虛擬機器的名稱。
請勿等候長時間執行的作業完成。
資源組名。 您可以使用 來設定預設群組 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
命令群組 'az networkcloud' 處於預覽狀態，且正在開發中。 參考和支援層級： https://aka.ms/CLI_refstatus
將 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 來取得完整偵錯記錄。
意見反應
即將登場：在 2024 年，我們將逐步淘汰 GitHub 問題作為內容的意見反應機制，並將它取代為新的意見反應系統。 如需詳細資訊，請參閱：https://aka.ms/ContentUserFeedback。
提交並檢視相關的意見反應