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 來取得完整偵錯記錄。