az vm

參考

注意

此命令群組具有 Azure CLI 和至少一個擴充功能中定義的命令。安裝每個擴充功能以受益於其擴充功能。深入了解擴充功能。

管理 Linux 或 Windows 虛擬機。

命令

名稱	Description	類型	狀態
az vm aem	管理適用於 SAP 的 Azure 增強型監視擴充功能。	副檔名	GA
az vm aem delete	拿掉 Azure 增強型監視擴充功能。	副檔名	GA
az vm aem set	設定 Azure Enhanced Monitoring Extension。	副檔名	GA
az vm aem verify	確認 Azure 增強型監視延伸模組已正確設定。	副檔名	GA
az vm application	管理 VM 的應用程式。	核心	GA
az vm application list	列出 VM 的應用程式。	核心	GA
az vm application set	設定 VM 的應用程式。	核心	GA
az vm assess-patches	評估 VM 上的修補程式。	核心	GA
az vm auto-shutdown	管理 VM 的自動關機。	核心	GA
az vm availability-set	將資源分組到可用性設定組。	核心	GA
az vm availability-set convert	轉換 Azure 可用性設定組以包含具有受控磁碟的 VM。	核心	GA
az vm availability-set create	建立 Azure 可用性設定組。	核心	GA
az vm availability-set delete	刪除可用性設定組。	核心	GA
az vm availability-set list	列出可用性設定組。	核心	GA
az vm availability-set list-sizes	列出可用來在現有可用性設定組中建立新虛擬機的所有可用虛擬機大小。	核心	GA
az vm availability-set show	取得可用性設定組的相關信息。	核心	GA
az vm availability-set update	更新 Azure 可用性設定組。	核心	GA
az vm boot-diagnostics	針對 Azure 虛擬機的啟動進行疑難解答。	核心	GA
az vm boot-diagnostics disable	停用 VM 上的開機診斷。	核心	GA
az vm boot-diagnostics enable	在 VM 上啟用開機診斷。	核心	GA
az vm boot-diagnostics get-boot-log	從 VM 取得開機診斷記錄。	核心	GA
az vm boot-diagnostics get-boot-log-uris	取得虛擬機開機診斷記錄的SAS URI。	核心	GA
az vm capture	擷取已停止 VM 的資訊。	核心	GA
az vm convert	將具有非受控磁碟的 VM 轉換為使用受控磁碟。	核心	GA
az vm create	建立 Azure 虛擬機。	核心	GA
az vm deallocate	解除分配 VM，讓計算資源不再配置（不再適用費用）。狀態會從「已停止」變更為「已停止」（已解除分配）。」。	核心	GA
az vm delete	刪除 VM。	核心	GA
az vm diagnostics	設定 Azure 虛擬機診斷擴充功能。	核心	GA
az vm diagnostics get-default-config	取得 VM 的預設組態設定。	核心	GA
az vm diagnostics set	設定 Azure VM 診斷擴充功能。	核心	GA
az vm disk	管理連結至 VM 的受控數據磁碟。	核心	GA
az vm disk attach	將受控永續性磁碟連結至 VM。	核心	GA
az vm disk detach	從 VM 中斷鏈接受控磁碟。	核心	GA
az vm encryption	管理 VM 磁碟的加密。	核心	GA
az vm encryption disable	停用 OS 磁碟和/或資料磁碟上的磁碟加密。解密掛接的磁碟。	核心	GA
az vm encryption enable	在 OS 磁碟和/或資料磁碟上啟用磁碟加密。加密掛接的磁碟。	核心	GA
az vm encryption show	顯示加密狀態。	核心	GA
az vm extension	管理 VM 上的擴充功能。	核心	GA
az vm extension delete	刪除作業以刪除延伸模組。	核心	GA
az vm extension image	尋找訂用帳戶和區域的可用 VM 擴充功能。	核心	GA
az vm extension image list	列出可用擴充功能的相關信息。	核心	GA
az vm extension image list-names	列出可用延伸模組的名稱。	核心	GA
az vm extension image list-versions	列出可用擴充功能的版本。	核心	GA
az vm extension image show	顯示延伸模組的資訊。	核心	GA
az vm extension list	列出連結至 VM 的擴充功能。	核心	GA
az vm extension set	設定 VM 的擴充功能。	核心	GA
az vm extension show	顯示附加至 VM 之擴充功能的相關信息。	核心	GA
az vm extension wait	將 CLI 置於等候狀態，直到符合虛擬機擴充功能的條件為止。	核心	GA
az vm generalize	將 VM 標示為一般化，以便針對多個部署進行映像處理。	核心	GA
az vm get-instance-view	取得 VM 的實例資訊。	核心	GA
az vm host	管理虛擬機器專用主機。	核心	GA
az vm host create	建立專用主機。	核心	GA
az vm host delete	刪除專用主機。	核心	GA
az vm host get-instance-view	取得專用主機的實例資訊。	核心	GA
az vm host group	管理專用主機群組。	核心	GA
az vm host group create	建立專用主機群組。	核心	GA
az vm host group delete	刪除專用主機群組。	核心	GA
az vm host group get-instance-view	取得專用主機群組的實例檢視。	核心	GA
az vm host group list	列出專用主機群組。	核心	GA
az vm host group show	取得專用主機群組的詳細數據。	核心	GA
az vm host group update	更新專用主機群組。	核心	GA
az vm host list	列出專用主機。	核心	GA
az vm host list-resize-options	列出可調整指定專用主機大小的所有可用專用主機大小。注意：提供的專用主機大小只能用來相應增加現有的專用主機。	核心	GA
az vm host redeploy	重新部署專用主機。	核心	GA
az vm host resize	調整專用主機的大小。	核心	GA
az vm host restart	重新啟動專用主機。	核心	GA
az vm host show	取得專用主機的詳細數據。	核心	GA
az vm host update	更新專用主機。	核心	GA
az vm host wait	將 CLI 置於等候狀態，直到符合條件為止。	核心	GA
az vm identity	管理服務 VM 的身分識別。	核心	GA
az vm identity assign	在 VM 上啟用受控服務識別。	核心	GA
az vm identity remove	從 VM 移除受控服務識別。	核心	GA
az vm identity show	顯示 VM 的受控識別資訊。	核心	GA
az vm image	可用虛擬機映像的相關信息。	核心	GA
az vm image accept-terms	接受 Azure Marketplace 字詞，讓映像可用來建立 VM。	核心	已淘汰
az vm image list	列出 Azure Marketplace 中可用的 VM/VMSS 映像。	核心	GA
az vm image list-offers	列出 Azure Marketplace 中可用的 VM 映射供應專案。	核心	GA
az vm image list-publishers	列出 Azure Marketplace 中可用的 VM 映像發行者。	核心	GA
az vm image list-skus	列出 Azure Marketplace 中可用的 VM 映射 SKU。	核心	GA
az vm image show	取得 Azure Marketplace 中可用 VM 映像的詳細數據。	核心	GA
az vm image terms	管理 Azure Marketplace 映像條款。	核心	GA
az vm image terms accept	接受 Azure Marketplace 映像條款，讓映像可用來建立 VM。	核心	GA
az vm image terms cancel	取消 Azure Marketplace 映像條款。	核心	GA
az vm image terms show	取得 Azure Marketplace 映像字詞的詳細數據。	核心	GA
az vm install-patches	在 VM 上安裝修補程式。	核心	GA
az vm list	列出虛擬機器的詳細數據。	核心	GA
az vm list-ip-addresses	列出與 VM 相關聯的 IP 位址。	核心	GA
az vm list-sizes	列出 VM 的可用大小。	核心	GA
az vm list-skus	取得計算相關資源 SKU 的詳細數據。	核心	GA
az vm list-usage	列出 VM 的可用使用量資源。	核心	GA
az vm list-vm-resize-options	列出 VM 的可用重設大小選項。	核心	GA
az vm monitor	管理 VM 的監視層面。	核心	GA
az vm monitor log	管理 VM 的記錄分析工作區。	核心	GA
az vm monitor log show	針對與 VM 連結的 Log Analytics 工作區執行查詢。	核心	GA
az vm monitor metrics	管理 VM 的計量。	核心	預覽
az vm monitor metrics list-definitions	列出 VM 的計量定義。	核心	預覽
az vm monitor metrics tail	列出 VM 的計量值。	核心	預覽
az vm nic	管理網路介面。請參閱 `az network nic`。	核心	GA
az vm nic add	將現有的 NIC 新增至 VM。	核心	GA
az vm nic list	列出 VM 上可用的 NIC。	核心	GA
az vm nic remove	從 VM 移除 NIC。	核心	GA
az vm nic set	設定連結至 VM 的 NIC 設定。	核心	GA
az vm nic show	顯示連結至 VM 之 NIC 的資訊。	核心	GA
az vm open-port	為指定連接埠上的傳入流量開啟 VM。	核心	GA
az vm perform-maintenance	在虛擬機上執行維護的作業。	核心	GA
az vm reapply	重新套用 VM。	核心	GA
az vm redeploy	重新部署現有的 VM。	核心	GA
az vm reimage	將虛擬機重新安裝映像（升級作業系統）。	核心	GA
az vm repair	自動修復命令以修正 VM。	副檔名	GA
az vm repair create	建立新的修復 VM，並將來源 VM 複製的 OS 磁碟連結為數據磁碟。	副檔名	GA
az vm repair list-scripts	列出可用的腳本。位於 https://github.com/Azure/repair-script-library。	副檔名	GA
az vm repair repair-and-restore	修復和還原 VM。	副檔名	預覽
az vm repair reset-nic	重設 VM 客體 OS 上的網路介面堆疊。 https://docs.microsoft.com/en-us/troubleshoot/azure/virtual-machines/reset-network-interface	副檔名	預覽
az vm repair restore	將來源 VM 的 OS 磁碟取代為修復 VM 中的數據磁碟。	副檔名	GA
az vm repair run	在 VM 上從 GitHub 執行已驗證的腳本。 'az vm repair list-scripts' 以檢視可用的腳本。	副檔名	GA
az vm resize	更新 VM 的大小。	核心	GA
az vm restart	重新啟動 VM。	核心	GA
az vm run-command	管理虛擬機上的執行命令。	核心	GA
az vm run-command create	要建立執行命令的作業。	核心	GA
az vm run-command delete	要刪除執行命令的作業。	核心	GA
az vm run-command invoke	在 VM 上執行特定的執行命令。	核心	GA
az vm run-command list	從 VM 或位置列出執行命令。	核心	GA
az vm run-command show	取得特定的執行命令。	核心	GA
az vm run-command update	更新執行命令的作業。	核心	GA
az vm run-command wait	將 CLI 置於等候狀態，直到符合 res virtual-machine-run-command 的條件為止。	核心	GA
az vm secret	管理 VM 秘密。	核心	GA
az vm secret add	將秘密新增至 VM。	核心	GA
az vm secret format	將秘密轉換成 VM 和 VMSSes 可以使用的表單。	核心	GA
az vm secret list	列出 VM 上的秘密。	核心	GA
az vm secret remove	從 VM 移除秘密。	核心	GA
az vm show	取得 VM 的詳細數據。	核心	GA
az vm simulate-eviction	模擬現成 VM 的收回。	核心	GA
az vm start	啟動已停止的 VM。	核心	GA
az vm stop	關閉（停止）執行中的 VM。	核心	GA
az vm unmanaged-disk	管理連結至 VM 的 Unmanaged 數據磁碟。	核心	GA
az vm unmanaged-disk attach	將非受控永續性磁碟連結至 VM。	核心	GA
az vm unmanaged-disk detach	從 VM 中斷連結非受控磁碟。	核心	GA
az vm unmanaged-disk list	列出 VM 的非受控磁碟。	核心	GA
az vm update	更新 VM 的屬性。	核心	GA
az vm user	管理 VM 的用戶帳戶。	核心	GA
az vm user delete	從 VM 刪除使用者帳戶。	核心	GA
az vm user reset-ssh	重設 VM 上的 SSH 組態。	核心	GA
az vm user update	更新 VM 的用戶帳戶。您可以使用它來更新 VM 使用者的密碼或 SSH 金鑰值。	核心	GA
az vm wait	將 CLI 置於等候狀態，直到符合 VM 的條件為止。	核心	GA

az vm assess-patches

編輯

評估 VM 上的修補程式。

az vm assess-patches [--ids]
                     [--name]
                     [--no-wait {0, 1, f, false, n, no, t, true, y, yes}]
                     [--resource-group]
                     [--subscription]

範例

評估 VM 上的修補程式。

az vm assess-patches -g MyResourceGroup -n MyVm

選擇性參數

--ids

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

--name --vm-name -n

虛擬機的名稱。您可以使用來設定預設值 az configure --defaults vm=<name>。

--no-wait

請勿等候長時間執行的作業完成。

接受的值: 0, 1, f, false, n, no, t, true, y, yes

--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 vm auto-shutdown

編輯

管理 VM 的自動關機。

az vm auto-shutdown [--email]
                    [--ids]
                    [--location]
                    [--name]
                    [--off]
                    [--resource-group]
                    [--subscription]
                    [--time]
                    [--webhook]

範例

建立 VM 的自動關機排程。

az vm auto-shutdown -g MyResourceGroup -n MyVm --time 1730 --email "foo@bar.com" --webhook "https://example.com/"

刪除 VM 的自動關機排程。

az vm auto-shutdown -g MyResourceGroup -n MyVm --off

選擇性參數

--email

要傳送通知的電子郵件收件者（可以是分號分隔電子郵件地址的清單）。

--ids

--location -l

位置。值的來源：az account list-locations。您可以使用 az configure --defaults location=<location> 設定預設位置。

--name -n

虛擬機的名稱。您可以使用來設定預設值 az configure --defaults vm=<name>。

--off

關閉 VM 的自動關機。將會清除組態。

--resource-group -g

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

--subscription

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

--time

排程將每天發生的UTC時間。格式：hhmm。範例：1730。

--webhook

將傳送通知的 Webhook URL。

全域參數

--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 vm capture

編輯

擷取已停止 VM 的資訊。

如需端對端教學課程，請參閱 https://docs.microsoft.com/azure/virtual-machines/linux/capture-image。

az vm capture --vhd-name-prefix
              [--ids]
              [--name]
              [--overwrite]
              [--resource-group]
              [--storage-container]
              [--subscription]

範例

解除分配、一般化和擷取已停止的虛擬機。

az vm deallocate -g MyResourceGroup -n MyVm
az vm generalize -g MyResourceGroup -n MyVm
az vm capture -g MyResourceGroup -n MyVm --vhd-name-prefix MyPrefix

解除分配、一般化及擷取多個已停止的虛擬機。

vms_ids=$(az vm list -g MyResourceGroup --query "[].id" -o tsv)
az vm deallocate --ids {vms_ids}
az vm generalize --ids {vms_ids}
az vm capture --ids {vms_ids} --vhd-name-prefix MyPrefix

必要參數

--vhd-name-prefix

VHD 名稱前置詞會指定 VM 磁碟。

選擇性參數

--ids

--name -n

虛擬機的名稱。您可以使用來設定預設值 az configure --defaults vm=<name>。

--overwrite

覆寫現有的磁碟檔案。

預設值: True

--resource-group -g

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

--storage-container

用來儲存磁碟的記憶體帳戶容器名稱。

預設值: vhds

--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 vm convert

編輯

將具有非受控磁碟的 VM 轉換為使用受控磁碟。

az vm convert [--ids]
              [--name]
              [--no-wait {0, 1, f, false, n, no, t, true, y, yes}]
              [--resource-group]
              [--subscription]

範例

將具有非受控磁碟的 VM 轉換為使用受控磁碟。

az vm convert -g MyResourceGroup -n MyVm

將資源群組中具有非受控磁碟的所有 VM 轉換為使用受控磁碟。

az vm convert --ids $(az vm list -g MyResourceGroup --query "[].id" -o tsv)

選擇性參數

--ids

--name --vm-name -n

虛擬機的名稱。您可以使用來設定預設值 az configure --defaults vm=<name>。

--no-wait

請勿等候長時間執行的作業完成。

接受的值: 0, 1, f, false, n, no, t, true, y, yes

--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 vm create

編輯

建立 Azure 虛擬機。

如需端對端教學課程，請參閱 https://docs.microsoft.com/azure/virtual-machines/linux/quick-create-cli。

az vm create --name
             --resource-group
             [--accelerated-networking {false, true}]
             [--accept-term]
             [--admin-password]
             [--admin-username]
             [--asgs]
             [--assign-identity]
             [--attach-data-disks]
             [--attach-os-disk]
             [--authentication-type {all, password, ssh}]
             [--availability-set]
             [--boot-diagnostics-storage]
             [--capacity-reservation-group]
             [--computer-name]
             [--count]
             [--custom-data]
             [--data-disk-caching]
             [--data-disk-delete-option]
             [--data-disk-encryption-sets]
             [--data-disk-sizes-gb]
             [--disable-integrity-monitoring-autoupgrade]
             [--disk-controller-type {NVMe, SCSI}]
             [--edge-zone]
             [--enable-agent {false, true}]
             [--enable-auto-update {false, true}]
             [--enable-hibernation {false, true}]
             [--enable-hotpatching {false, true}]
             [--enable-integrity-monitoring]
             [--enable-proxy-agent {false, true}]
             [--enable-secure-boot {false, true}]
             [--enable-vtpm {false, true}]
             [--encryption-at-host {false, true}]
             [--ephemeral-os-disk {false, true}]
             [--ephemeral-os-disk-placement {CacheDisk, NvmeDisk, ResourceDisk}]
             [--eviction-policy {Deallocate, Delete}]
             [--generate-ssh-keys]
             [--host]
             [--host-group]
             [--image]
             [--license-type {None, RHEL_BASE, RHEL_BASESAPAPPS, RHEL_BASESAPHA, RHEL_BYOS, RHEL_ELS_6, RHEL_EUS, RHEL_SAPAPPS, RHEL_SAPHA, SLES, SLES_BYOS, SLES_HPC, SLES_SAP, SLES_STANDARD, UBUNTU, UBUNTU_PRO, Windows_Client, Windows_Server}]
             [--location]
             [--max-price]
             [--nic-delete-option]
             [--nics]
             [--no-wait]
             [--nsg]
             [--nsg-rule {NONE, RDP, SSH}]
             [--os-disk-caching {None, ReadOnly, ReadWrite}]
             [--os-disk-delete-option {Delete, Detach}]
             [--os-disk-encryption-set]
             [--os-disk-name]
             [--os-disk-secure-vm-disk-encryption-set]
             [--os-disk-security-encryption-type {DiskWithVMGuestState, NonPersistedTPM, VMGuestStateOnly}]
             [--os-disk-size-gb]
             [--os-type {linux, windows}]
             [--patch-mode {AutomaticByOS, AutomaticByPlatform, ImageDefault, Manual}]
             [--plan-name]
             [--plan-product]
             [--plan-promotion-code]
             [--plan-publisher]
             [--platform-fault-domain]
             [--ppg]
             [--priority {Low, Regular, Spot}]
             [--private-ip-address]
             [--proxy-agent-mode {Audit, Enforce}]
             [--public-ip-address]
             [--public-ip-address-allocation {dynamic, static}]
             [--public-ip-address-dns-name]
             [--public-ip-sku {Basic, Standard}]
             [--role]
             [--scope]
             [--secrets]
             [--security-type {ConfidentialVM, Standard, TrustedLaunch}]
             [--size]
             [--source-disk-restore-point]
             [--source-disk-restore-point-size-gb]
             [--source-resource]
             [--source-resource-size]
             [--specialized {false, true}]
             [--ssh-dest-key-path]
             [--ssh-key-name]
             [--ssh-key-values]
             [--storage-account]
             [--storage-container-name]
             [--storage-sku]
             [--subnet]
             [--subnet-address-prefix]
             [--tags]
             [--ultra-ssd-enabled {false, true}]
             [--use-unmanaged-disk]
             [--user-data]
             [--v-cpus-available]
             [--v-cpus-per-core]
             [--validate]
             [--vmss]
             [--vnet-address-prefix]
             [--vnet-name]
             [--workspace]
             [--zone]

範例

使用自動 SSH 驗證建立預設的 Ubuntu2204 VM。

az vm create -n MyVm -g MyResourceGroup --image Ubuntu2204

使用映像 URN 建立具有自動 SSH 驗證的預設 RedHat VM。

az vm create -n MyVm -g MyResourceGroup --image RedHat:RHEL:7-RAW:7.4.2018010506

建立具有私人IP位址的預設 Windows Server VM。

az vm create -n MyVm -g MyResourceGroup --public-ip-address "" --image Win2012R2Datacenter

從自定義受控映像建立 VM。

az vm create -g MyResourceGroup -n MyVm --image MyImage

從一般化資源庫映像版本建立 VM。

az vm create -g MyResourceGroup -n MyVm --image /subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/myRG/providers/Microsoft.Compute/galleries/myGallery/images/myImage/versions/1.0.0

從特製化資源庫映像版本建立 VM。

az vm create -g MyResourceGroup -n MyVm --image /subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/myRG/providers/Microsoft.Compute/galleries/myGallery/images/myImage/versions/1.0.0 --specialized

從最新版資源庫映像建立 VM

az vm create -g MyResourceGroup -n MyVm --image /subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/myRG/providers/Microsoft.Compute/galleries/myGallery/images/myImage

藉由連結至受控操作系統磁碟來建立 VM。

az vm create -g MyResourceGroup -n MyVm --attach-os-disk MyOsDisk --os-type linux

從 VHD Blob URI 連結至非受控作業系統磁碟，以建立 VM。

az vm create -g MyResourceGroup -n MyVm --attach-os-disk https://vhd1234.blob.core.windows.net/vhds/osdisk1234.vhd --os-type linux --use-unmanaged-disk

使用 cloud-init 腳本建立 Debian11 VM 以進行設定。請參閱：https://docs.microsoft.com/azure/virtual-machines/linux/using-cloud-init.

az vm create -g MyResourceGroup -n MyVm --image Debian11 --custom-data MyCloudInitScript.yml

使用 SSH 金鑰驗證和位於現有虛擬網路和可用性設定組的公用 DNS 專案，建立 Debian11 VM。

az vm create -n MyVm -g MyResourceGroup --image Debian11 --vnet-name MyVnet --subnet subnet1 \
    --availability-set MyAvailabilitySet --public-ip-address-dns-name MyUniqueDnsName \
    --ssh-key-values @key-file

建立具有公用IP位址、DNS專案、兩個數據磁碟（10GB和 20GB）的簡單Ubuntu Linux VM，然後產生 RSA ssh 金鑰組。

az vm create -n MyVm -g MyResourceGroup --public-ip-address-dns-name MyUniqueDnsName \
    --image Ubuntu2204 --data-disk-sizes-gb 10 20 --size Standard_DS2_v2 \
    --generate-ssh-keys

使用金鑰保存庫秘密建立Debian11 VM。

az keyvault certificate create --vault-name vaultname -n cert1 \
  -p "$(az keyvault certificate get-default-policy)"

secrets=$(az keyvault secret list-versions --vault-name vaultname \
  -n cert1 --query "[?attributes.enabled].id" -o tsv)

vm_secrets=$(az vm secret format -s "$secrets")

az vm create -g group-name -n vm-name --admin-username deploy  \
  --image debian11 --secrets "$vm_secrets"

建立具有系統指派身分識別的 CentOS VM。 VM 將具有記憶體帳戶存取權的「參與者」角色。

az vm create -n MyVm -g rg1 --image CentOS85Gen2 --assign-identity [system] --scope /subscriptions/99999999-1bf0-4dda-aec3-cb9272f09590/MyResourceGroup/myRG/providers/Microsoft.Storage/storageAccounts/storage1 --role Contributor

建立具有使用者指派身分識別的Debian11 VM。

az vm create -n MyVm -g rg1 --image Debian11 --assign-identity /subscriptions/99999999-1bf0-4dda-aec3-cb9272f09590/resourcegroups/myRG/providers/Microsoft.ManagedIdentity/userAssignedIdentities/myID

建立具有系統與使用者指派身分識別的Debian11 VM。

az vm create -n MyVm -g rg1 --image Debian11 --assign-identity [system] /subscriptions/99999999-1bf0-4dda-aec3-cb9272f09590/resourcegroups/myRG/providers/Microsoft.ManagedIdentity/userAssignedIdentities/myID

在目前資源群組區域中的可用性區域中建立 VM。

az vm create -n MyVm -g MyResourceGroup --image CentOS85Gen2 --zone 1

建立多個 VM。在此範例中，會建立 3 部 VM。它們是 MyVm0、MyVm1、MyVm2。

az vm create -n MyVm -g MyResourceGroup --image CentOS85Gen2 --count 3

從共享資源庫映像建立 VM

az vm create -n MyVm -g MyResourceGroup --image /SharedGalleries/{gallery_unique_name}/Images/{image}/Versions/{version}

從社群資源庫映像建立 VM

az vm create -n MyVm -g MyResourceGroup --image /CommunityGalleries/{gallery_unique_name}/Images/{image}/Versions/{version}

必要參數

--name -n

虛擬機的名稱。

--resource-group -g

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

選擇性參數

--accelerated-networking

啟用加速網路功能。除非指定，否則 CLI 會根據電腦映像和大小加以啟用。

接受的值: false, true

--accept-term

接受許可協議和隱私聲明。

--admin-password

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

--admin-username

VM 的用戶名稱。預設值是OS的目前用戶名稱。如果預設值是系統保留的，則預設值會設定為 azureuser。請參閱 https://docs.microsoft.com/rest/api/compute/virtualmachines/createorupdate#osprofile 以取得保留值的完整清單。

--asgs

要與 VM 建立關聯的現有應用程式安全組的空間分隔清單。

--assign-identity

接受以空格分隔的系統或使用者指派身分識別。使用 '[system]' 來參考系統指派的身分識別，或參考使用者指派的身分識別的資源標識符。如需更多範例，請參閱說明。

--attach-data-disks

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

--attach-os-disk

將現有的 OS 磁碟連結至 VM。可以使用受控磁碟的名稱或標識符，或非受控磁碟 VHD 的 URI。

--authentication-type

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

接受的值: all, password, ssh

--availability-set

要新增 VM 之現有可用性設定組的名稱或識別碼。預設為 None。

--boot-diagnostics-storage

預先存在的記憶體帳戶名稱或其 Blob URI，以擷取開機診斷。其sku應該是其中一個Standard_GRS、Standard_LRS和Standard_RAGRS。

--capacity-reservation-group --crg

預覽

用來配置之容量保留群組的標識碼或名稱。傳入「None」以解除容量保留群組的關聯。請注意，如果您想要刪除已與容量保留群組相關聯的 VM/VMSS，您必須先解除與容量保留群組的關聯。

--computer-name

虛擬機的主機OS名稱。預設為 VM 的名稱。

--count

預覽

要建立的虛擬機數目。值範圍是 [2， 250]，內含。如果您想要建立一般單一 VM，請勿指定此參數。 VM 會以平行的方式建立。此命令的輸出是 VM 陣列，而不是單一 VM。每個 VM 都有自己的公用 IP NIC。 VNET 和 NSG 會共用。建議沒有任何現有的公用IP、NIC、VNET和NSG位於資源群組中。指定 --count 時,--attach-data-disks、--attach-os-disk、 --boot-diagnostics-storage、--computer-name、--host、--host-group、--nics、-os-disk-name、--private-ip-address、--public-ip-address、--public-ip-address-dns-name、--storage-account、--storage-container-name、--subnet、--use-unmanaged-disk、--vnet-name。

--custom-data

自定義 init 腳本檔案或文字（cloud-init、cloud-config 等）。

--data-disk-caching

數據磁碟的記憶體快取類型，包括『None』、『ReadOnly』、『ReadWrite』等。使用單一值在所有磁碟上套用，或使用 <lun>=<vaule1> <lun>=<value2> 來設定個別磁碟。

--data-disk-delete-option

指定在 VM 刪除時，是否應該刪除或中斷連結數據磁碟。如果連結單一數據磁碟，允許的值為 Delete 和 Detach。若是連結多個數據磁碟，請使用「<data_disk=Delete <data_disk2>>=Detach」來設定每個磁碟。

--data-disk-encryption-sets

數據磁碟的磁碟加密集名稱或標識碼（以空格分隔）。

--data-disk-sizes-gb

以 GB 為單位的空間分隔空白受控數據磁碟大小來建立。

--disable-integrity-monitoring-autoupgrade

針對已啟用信任啟動的 VM 和 VMSS，停用客體證明延伸模組的自動升級。

預設值: False

--disk-controller-type

預覽

指定為 VM 或 VMSS 設定的磁碟控制器類型。

接受的值: NVMe, SCSI

--edge-zone

邊緣區域的名稱。

--enable-agent

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

接受的值: false, true

--enable-auto-update

指出是否為 Windows 虛擬機啟用自動更新。

接受的值: false, true

--enable-hibernation

在 VM 上啟用或停用休眠功能的旗標。

接受的值: false, true

--enable-hotpatching

修補 VM 而不需重新啟動。 --enable-agent 必須設定，而且 --patch-mode 必須設定為 AutomaticByPlatform。

接受的值: false, true

--enable-integrity-monitoring

啟用安裝Microsoft支援且不支援安全性的客體證明延伸模組，並啟用已啟用受信任啟動之 VM 和 VMSS 的系統指派身分識別。

預設值: False

--enable-proxy-agent

指定是否應在虛擬機或虛擬機擴展集上啟用 Proxy 代理程式功能。

接受的值: false, true

--enable-secure-boot

啟用安全開機。

接受的值: false, true

--enable-vtpm

啟用 vTPM。

接受的值: false, true

--encryption-at-host

啟用 VM 或 VMSS 的主機加密。這會啟用所有磁碟的加密，包括主機本身的資源/暫存磁碟。

接受的值: false, true

--ephemeral-os-disk

可讓您直接在主機節點上建立OS磁碟，以提供本機磁碟效能和更快的VM/VMSS重新映像時間。

接受的值: false, true

--ephemeral-os-disk-placement --ephemeral-placement

僅適用於搭配 --ephemeral-os-disk使用時。可讓您選擇暫時 OS 磁碟布建位置。

接受的值: CacheDisk, NvmeDisk, ResourceDisk

--eviction-policy

Spot 優先順序虛擬機的收回原則。默認收回原則是 Spot 優先順序虛擬機的解除分配。

接受的值: Deallocate, Delete

--generate-ssh-keys

如果遺失 SSH 公用和私人 RSA 金鑰檔案，請產生 SSH 公用和私人 RSA 金鑰檔案。金鑰會儲存在 ~/.ssh 目錄中。

預設值: False

--host

預覽

VM 將位於之專用主機的資源標識碼。 --host 和 --host-group 無法一起使用。

--host-group

預覽

VM 將位於之專用主機群組的名稱或資源識別碼。 --host 和 --host-group 無法一起使用。

--image

操作系統映像的名稱，做為 URN 別名、URN、自定義映像名稱或識別碼、自定義映射版本識別碼或 VHD Blob URI。此外，它也支援共用資源庫映像。請使用映像別名，包括您想要使用的發行版版本。例如：請使用Debian11，而不是Debian。除非使用有效的 URN 格式：“Publisher：Offer：Sku：Version”，否則需要此參數 --attach-os-disk. 。如需詳細資訊，請參閱https://docs.microsoft.com/azure/virtual-machines/linux/cli-ps-findimage。

值來源: az sig image-version show-shared, az vm image list, az vm image show

--license-type

指定 Windows 映像或磁碟已獲內部部署授權。若要啟用適用於 Windows Server 的 Azure Hybrid Benefit，請使用「Windows_Server」。若要啟用 Windows 10 的多租用戶裝載許可權，請使用『Windows_Client』。如需詳細資訊，請參閱 Azure Windows VM 在線檔。

接受的值: None, RHEL_BASE, RHEL_BASESAPAPPS, RHEL_BASESAPHA, RHEL_BYOS, RHEL_ELS_6, RHEL_EUS, RHEL_SAPAPPS, RHEL_SAPHA, SLES, SLES_BYOS, SLES_HPC, SLES_SAP, SLES_STANDARD, UBUNTU, UBUNTU_PRO, Windows_Client, Windows_Server

--location -l

用來建立 VM 和相關資源的位置。如果未設定預設位置，則會預設為資源群組的位置。

--max-price

預覽

您願意支付現成 VM/VMSS 的最高價格（以美元為單位）。 -1 表示基於價格原因，不應收回 Spot VM/VMSS。

--nic-delete-option

指定刪除 VM 時網路介面會發生什麼事。使用單一值在所有資源上套用，或使用 = 來設定個別資源的刪除行為。可能的選項為 [刪除] 和 [中斷連結]。

--nics

要連結至 VM 之現有 NIC 的名稱或識別碼。第一個 NIC 將會指定為主要。如果省略，將會建立新的 NIC。如果已指定現有的 NIC，請勿指定子網、VNet、公用 IP 或 NSG。

--no-wait

請勿等候長時間執行的作業完成。

預設值: False

--nsg

建立新的網路安全組時要使用的名稱（預設值）或參考現有的網路安全組。也可以使用 PowerShell 或 --% 運算符，依標識符參考現有的 NSG，或在 Azure CLI 中為 none 指定 “”'“。

--nsg-rule

建立新 NSG 時要建立的 NSG 規則。默認為開啟埠以允許 Windows 上的 RDP，並允許 Linux 上的 SSH。 NONE 不代表 NSG 規則。

接受的值: NONE, RDP, SSH

--os-disk-caching

VM OS 磁碟的記憶體快取類型。默認值：ReadWrite。

接受的值: None, ReadOnly, ReadWrite

--os-disk-delete-option

指定刪除 VM 時受控磁碟的行為，也就是刪除或中斷鏈接受控磁碟。

接受的值: Delete, Detach

--os-disk-encryption-set

OS 磁碟的磁碟加密集名稱或標識碼。

--os-disk-name

新 VM OS 磁碟的名稱。

--os-disk-secure-vm-disk-encryption-set

針對客戶受控密鑰加密的機密 VM OS 磁碟和 VM 客體 Blob，指定客戶受控磁碟加密集資源識別碼或名稱。

--os-disk-security-encryption-type

指定 OS 受控磁碟的加密類型。

接受的值: DiskWithVMGuestState, NonPersistedTPM, VMGuestStateOnly

--os-disk-size-gb

要建立的 OS 磁碟大小以 GB 為單位。

--os-type

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

接受的值: linux, windows

--patch-mode

客體內修補至 IaaS 虛擬機的模式。 Windows VM 允許的值：AutomaticByOS、AutomaticByPlatform、Manual。 Linux VM 允許的值：AutomaticByPlatform、ImageDefault。手動 - 您可以控制將修補程式的應用程式套用至虛擬機。您可以手動在 VM 內套用修補程式來執行此動作。在此模式中，會停用自動更新;paramater --enable-auto-update 必須是 false。 AutomaticByOS - 作業系統會自動更新虛擬機。參數 --enable-auto-update 必須為 true。 AutomaticByPlatform - 虛擬機將會由操作系統自動更新。 ImageDefault - 會使用虛擬機的默認修補組態。參數 --enable-agent 和 --enable-auto-update 必須為 true。

接受的值: AutomaticByOS, AutomaticByPlatform, ImageDefault, Manual

--plan-name

方案名稱。

--plan-product

規劃產品。

--plan-promotion-code

規劃促銷碼。

--plan-publisher

方案發行者。

--platform-fault-domain

指定要在其中建立虛擬機的擴展集邏輯容錯網域。根據預設，虛擬機會自動指派給容錯網域，以在可用的容錯網域之間維持平衡。只有在設定此虛擬機的 virtualMachineScaleSet 屬性時，才適用此情況。參考的虛擬機擴展集必須具有平臺容錯網域計數。建立虛擬機之後，就無法更新這個屬性。容錯網域指派可以在虛擬機實例檢視中檢視。

--ppg

VM 應該與鄰近放置群組的名稱或標識符相關聯。

--priority

優先順序。使用『Spot』以符合成本效益的方式執行短期工作負載。未來『低』列舉將會淘汰。請使用「Spot」來部署 Azure 現成 VM 和/或 VMSS。默認為 [一般]。

接受的值: Low, Regular, Spot

--private-ip-address

靜態私人IP位址（例如10.0.0.0.5）。

--proxy-agent-mode

如果啟用此功能，請指定 Proxy 代理程式在上執行的模式。

接受的值: Audit, Enforce

--public-ip-address

建立一個公用IP位址時的名稱（預設值）或參考現有的IP位址。也可以使用 PowerShell 或 --% 運算符，依標識符參考現有的公用 IP，或在 Azure CLI 中為 None 指定 “”'“。針對使用 powershell Core 7.3.4 版的 Azure CLI，請指定或 “” （--public-ip-address 或 --public-ip-address “” ）。

--public-ip-address-allocation

接受的值: dynamic, static

--public-ip-address-dns-name

新建立公用IP的全域唯一 DNS 名稱。

--public-ip-sku

公用IP SKU。只有在「標準」時，才支援在邊緣區域建立公用IP。

接受的值: Basic, Standard

預設值: Standard

--role

系統指派身分識別的角色名稱或標識碼。

--scope

系統指派的身分識別可以存取的範圍。

--secrets

一或多個金鑰保存庫秘密作為 JSON 字串或檔案，透過@{path}包含 [{ "sourceVault": { "id": "value" }, "vaultCertificates": [{ "certificateUrl": "value", "certificateStore": "cert store name (only on windows)"}] }]。

--security-type

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

接受的值: ConfidentialVM, Standard, TrustedLaunch

--size

要建立的 VM 大小。如需大小資訊，請參閱 https://azure.microsoft.com/pricing/details/virtual-machines/ 。

預設值: Standard_DS1_v2

值來源: az vm list-sizes

--source-disk-restore-point --source-disk-rp

從磁碟還原點建立數據磁碟。可以使用磁碟還原點的標識碼。

--source-disk-restore-point-size-gb --source-rp-size

來源磁碟還原點的大小，以 GB 為單位。

--source-resource --source-snapshots-or-disks

從快照集或其他磁碟建立數據磁碟。可以使用磁碟或快照集的標識碼。

--source-resource-size --source-snapshots-or-disks-size-gb

以 GB 為單位的來源磁碟大小。

--specialized

指出來源映像是否特製化。

接受的值: false, true

--ssh-dest-key-path

SSH 金鑰 VM 上的目的地檔案路徑。如果檔案已經存在，指定的索引鍵會附加至檔案。 SSH 公鑰的目的地路徑目前受限於其預設值 “/home/username/.ssh/authorized_keys”，因為 Linux 布建代理程式有已知問題。

--ssh-key-name

將它當做虛擬機中的公鑰使用。它應該是 Azure 中現有的 SSH 金鑰資源。

--ssh-key-values

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

--storage-account

僅適用於搭配 --use-unmanaged-disk使用時。建立新的記憶體帳戶或參考現有記憶體帳戶時要使用的名稱。如果省略，將會使用相同資源群組和位置中的適當記憶體帳戶，或建立新的記憶體帳戶。

--storage-container-name

僅適用於搭配 --use-unmanaged-disk使用時。 VM OS 磁碟的記憶體容器名稱。默認值：vhds。

--storage-sku

要保存 VM 之記憶體帳戶的 SKU。使用可套用至所有磁碟的單一 SKU，或指定個別磁碟。使用方式：[--storage-sku SKU | --storage-sku ID=SKU ID=SKU=SKU...]，其中每個標識符都是 “os” 或 0 索引的 lun。允許的值：Standard_LRS、Premium_LRS、StandardSSD_LRS、UltraSSD_LRS、Premium_ZRS、StandardSSD_ZRS、PremiumV2_LRS。

--subnet

建立新的 VNet 或參考現有 VNet 時，子網的名稱。也可以依標識碼參考現有的子網。如果省略 vnet 名稱和子網，系統會自動選取適當的 VNet 和子網，或建立新的 VNet。

--subnet-address-prefix

建立 CIDR 格式的新 VNet 時要使用的子網 IP 位址前綴。

預設值: 10.0.0.0/24

--tags

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

--ultra-ssd-enabled

啟用或停用具有1個以上的受控數據磁碟與UltraSSD_LRS記憶體帳戶的功能。

接受的值: false, true

--use-unmanaged-disk

請勿使用受控磁碟來保存 VM。

預設值: False

--user-data

VM 的 UserData。它可以以檔案或字串的形式傳入。

--v-cpus-available

指定可用的 vCPU 數目。

--v-cpus-per-core

指定 vCPU 與實體核心的比例。將此屬性設定為 1 也表示已停用超線程處理。

--validate

產生並驗證 ARM 範本，而不需建立任何資源。

預設值: False

--vmss

應指派虛擬機之現有虛擬機擴展集的名稱或標識符。預設為 None。

--vnet-address-prefix

以 CIDR 格式建立新 VNet 時要使用的 IP 位址前綴。

預設值: 10.0.0.0/16

--vnet-name

建立新的虛擬網路或參考現有虛擬網路時的名稱。

--workspace

預覽

Log Analytics 工作區的名稱或標識碼。如果您透過其名稱指定工作區，則工作區應該位於與 vm 相同的資源群組中，否則將會建立新的工作區。

--zone -z

要在其中佈建資源的可用性區域。

全域參數

--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 vm deallocate

編輯

解除分配 VM，讓計算資源不再配置（不再適用費用）。狀態會從「已停止」變更為「已停止」（已解除分配）。」。

如需端對端教學課程，請參閱 https://docs.microsoft.com/azure/virtual-machines/linux/capture-image。

az vm deallocate [--hibernate {0, 1, f, false, n, no, t, true, y, yes}]
                 [--ids]
                 [--name]
                 [--no-wait {0, 1, f, false, n, no, t, true, y, yes}]
                 [--resource-group]
                 [--subscription]

範例

解除分配、一般化和擷取已停止的虛擬機。

az vm deallocate -g MyResourceGroup -n MyVm
az vm generalize -g MyResourceGroup -n MyVm
az vm capture -g MyResourceGroup -n MyVm --vhd-name-prefix MyPrefix

解除分配、一般化及擷取多個已停止的虛擬機。

az vm deallocate --ids vms_ids
az vm generalize --ids vms_ids
az vm capture --ids vms_ids --vhd-name-prefix MyPrefix

解除分配 VM。

az vm deallocate --name MyVm --no-wait --resource-group MyResourceGroup

選擇性參數

--hibernate

用來休眠虛擬機的選擇性參數。（預覽中的功能）。

接受的值: 0, 1, f, false, n, no, t, true, y, yes

--ids

--name --vm-name -n

虛擬機的名稱。您可以使用來設定預設值 az configure --defaults vm=<name>。

--no-wait

請勿等候長時間執行的作業完成。

接受的值: 0, 1, f, false, n, no, t, true, y, yes

--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 vm delete

編輯

刪除 VM。

az vm delete [--force-deletion]
             [--ids]
             [--name]
             [--no-wait]
             [--resource-group]
             [--subscription]
             [--yes]

範例

刪除 VM，而不提示確認。

az vm delete -g MyResourceGroup -n MyVm --yes

刪除資源群組中的所有 VM。

az vm delete --ids $(az vm list -g MyResourceGroup --query "[].id" -o tsv)

選擇性參數

--force-deletion

選擇性參數以強制刪除虛擬機。預設值為 None。

--ids

--name -n

虛擬機的名稱。您可以使用來設定預設值 az configure --defaults vm=<name>。

--no-wait

請勿等候長時間執行的作業完成。

預設值: False

--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 vm generalize

編輯

將 VM 標示為一般化，以便針對多個部署進行映像處理。

如需端對端教學課程，請參閱 https://docs.microsoft.com/azure/virtual-machines/linux/capture-image。

az vm generalize [--ids]
                 [--name]
                 [--resource-group]
                 [--subscription]

範例

解除分配、一般化和擷取已停止的虛擬機。

az vm deallocate -g MyResourceGroup -n MyVm
az vm generalize -g MyResourceGroup -n MyVm
az vm capture -g MyResourceGroup -n MyVm --vhd-name-prefix MyPrefix

解除分配、一般化及擷取多個已停止的虛擬機。

az vm deallocate --ids vms_ids
az vm generalize --ids vms_ids
az vm capture --ids vms_ids --vhd-name-prefix MyPrefix

選擇性參數

--ids

--name --vm-name -n

虛擬機的名稱。您可以使用來設定預設值 az configure --defaults vm=<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 vm get-instance-view

編輯

取得 VM 的實例資訊。

az vm get-instance-view [--ids]
                        [--name]
                        [--resource-group]
                        [--subscription]

範例

使用資源群組和名稱來取得 VM 的實例檢視資訊。

az vm get-instance-view -g MyResourceGroup -n MyVm

取得資源群組中所有 VM 的實例檢視。

az vm get-instance-view --ids $(az vm list -g MyResourceGroup --query "[].id" -o tsv)

選擇性參數

--ids

--name -n

虛擬機的名稱。您可以使用來設定預設值 az configure --defaults vm=<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 vm install-patches

編輯

在 VM 上安裝修補程式。

az vm install-patches --maximum-duration
                      --reboot-setting {Always, IfRequired, Never}
                      [--classifications-to-include-linux {Critical, Other, Security}]
                      [--classifications-to-include-win {Critical, Definition, FeaturePack, Security, ServicePack, Tools, UpdateRollUp, Updates}]
                      [--exclude-kbs-requiring-reboot {false, true}]
                      [--ids]
                      [--kb-numbers-to-exclude]
                      [--kb-numbers-to-include]
                      [--max-patch-publish-date]
                      [--name]
                      [--no-wait]
                      [--package-name-masks-to-exclude]
                      [--package-name-masks-to-include]
                      [--resource-group]
                      [--subscription]

範例

在 Windows VM 上安裝修補程式，允許最多 4 小時的時間，並在軟體更新作業期間視需要重新啟動 VM。

az vm install-patches -g MyResourceGroup -n MyVm --maximum-duration PT4H --reboot-setting IfRequired --classifications-to-include-win Critical Security --exclude-kbs-requiring-reboot true

在Linux VM上安裝修補程式，允許最多4小時的時間，並在軟體更新作業期間視需要重新啟動VM。

az vm install-patches -g MyResourceGroup -n MyVm --maximum-duration PT4H --reboot-setting IfRequired --classifications-to-include-linux Critical

必要參數

--maximum-duration

指定作業將執行的最大時間量。它必須是符合 ISO 8601 規範的持續時間字串，例如 PT4H（4 小時）。

--reboot-setting

定義在軟體更新作業期間可接受重新啟動 VM 的時機。

接受的值: Always, IfRequired, Never

選擇性參數

--classifications-to-include-linux

要包含Linux VM的分類空間分隔清單。

接受的值: Critical, Other, Security

--classifications-to-include-win

要針對 Windows VM 包含的空間分隔分類清單。

接受的值: Critical, Definition, FeaturePack, Security, ServicePack, Tools, UpdateRollUp, Updates

--exclude-kbs-requiring-reboot

篩選掉設定此選項時，沒有 'NeverReboots' 重新啟動行為的 KB。僅適用於 Windows VM。

接受的值: false, true

--ids

--kb-numbers-to-exclude

修補作業中要排除之 KB 的空間分隔清單。僅適用於 Windows VM。

--kb-numbers-to-include

要包含在修補作業中之 KB 的空間分隔清單。僅適用於 Windows VM。

--max-patch-publish-date

ISO 8601 安裝修補程式的 ISO 8601 時間值，其發行日期上限為或之前。格式：date（yyyy-mm-dd） time （hh：mm：ss.xxxxx） timezone （+/-hh：mm）。

--name -n

虛擬機的名稱。您可以使用來設定預設值 az configure --defaults vm=<name>。

--no-wait

請勿等候長時間執行的作業完成。

預設值: False

--package-name-masks-to-exclude

修補作業中要排除的套件空間分隔清單。格式：packageName_packageVersion。僅適用於Linux VM。

--package-name-masks-to-include

要包含在修補作業中的封裝空間分隔清單。格式：packageName_packageVersion。僅適用於Linux VM。

--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 vm list

編輯

列出虛擬機器的詳細數據。

--resource-group 可以傳入空字串做為參數，這會輸出訂用帳戶下的所有 VM 資訊。如需查詢虛擬機器相關資訊的詳細資訊，請參閱 https://docs.microsoft.com/cli/azure/query-az-cli2。

az vm list [--resource-group]
           [--show-details]
           [--vmss]

範例

列出所有 VM。

az vm list

依資源群組列出所有 VM。

az vm list -g MyResourceGroup

依資源群組列出所有 VM，其中包含詳細數據。

az vm list -g MyResourceGroup -d

選擇性參數

--resource-group -g

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

--show-details -d

顯示公用IP位址、FQDN和電源狀態。命令的執行速度將會變慢。

預設值: False

--vmss

列出特定 VMSS 中的 VM 實例。請指定 VMSS 識別碼或 VMSS 名稱。

全域參數

--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 vm list-ip-addresses

編輯

列出與 VM 相關聯的 IP 位址。

az vm list-ip-addresses [--ids]
                        [--name]
                        [--resource-group]
                        [--subscription]

範例

取得 VM 的 IP 位址。

az vm list-ip-addresses -g MyResourceGroup -n MyVm

取得資源群組中所有 VM 的 IP 位址。

az vm list-ip-addresses --ids $(az vm list -g MyResourceGroup --query "[].id" -o tsv)

選擇性參數

--ids

--name -n

虛擬機的名稱。您可以使用來設定預設值 az configure --defaults vm=<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 vm list-sizes

編輯

列出 VM 的可用大小。

az vm list-sizes [--ids]
                 [--location]
                 [--subscription]

範例

列出美國西部區域中可用的 VM 大小。

az vm list-sizes -l westus

選擇性參數

--ids

--location -l

位置。值的來源：az account list-locations。您可以使用 az configure --defaults location=<location> 設定預設位置。

--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 vm list-skus

編輯

取得計算相關資源 SKU 的詳細數據。

此命令會納入訂用帳戶層級限制，以提供最精確的資訊。

az vm list-skus [--all {false, true}]
                [--location]
                [--resource-type]
                [--size]
                [--zone {false, true}]

範例

列出美國西部區域的所有 SKU。

az vm list-skus -l westus

列出支援可用性區域之美國東部 2 區域中的所有可用 VM 大小。

az vm list-skus -l eastus2 --zone

列出美國東部 2 區域中所有可用的 VM 大小，其支援名稱為「standard_ds1...“的可用性區域。

az vm list-skus -l eastus2 --zone --size standard_ds1

列出美國西部區域的可用性設定組相關 SKU 資訊。

az vm list-skus -l westus --resource-type availabilitySets

選擇性參數

--all

顯示所有資訊，包括目前訂用帳戶下無法使用的 VM 大小。

接受的值: false, true

--location -l

位置。值的來源：az account list-locations。您可以使用 az configure --defaults location=<location> 設定預設位置。

--resource-type -r

資源類型，例如 “availabilitySets”、“snapshots”、“disks” 等。

--size -s

大小名稱，會接受部分名稱。

--zone -z

顯示支援可用性區域的 SKU。

接受的值: false, true

全域參數

--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 vm list-usage

編輯

列出 VM 的可用使用量資源。

az vm list-usage --location

範例

取得美國西部區域的計算資源使用量。

az vm list-usage -l westus

必要參數

--location -l

位置。值的來源：az account list-locations。您可以使用 az configure --defaults location=<location> 設定預設位置。

全域參數

--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 vm list-vm-resize-options

編輯

列出 VM 的可用重設大小選項。

az vm list-vm-resize-options [--ids]
                             [--name]
                             [--resource-group]
                             [--subscription]

範例

列出調整大小的所有可用 VM 大小。

az vm list-vm-resize-options -g MyResourceGroup -n MyVm

列出資源群組中所有 VM 的可用大小。

az vm list-vm-resize-options --ids $(az vm list -g MyResourceGroup --query "[].id" -o tsv)

選擇性參數

--ids

--name --vm-name -n

虛擬機的名稱。您可以使用來設定預設值 az configure --defaults vm=<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 vm open-port

編輯

為指定連接埠上的傳入流量開啟 VM。

將安全性規則新增至連結至 VM 網路介面（NIC）或子網的網路安全組（NSG）。將會使用現有的 NSG，或建立新的 NSG。規則名稱為『open-port-{port}』，且會以這個名稱覆寫現有的規則。針對多 NIC VM 或更精細的控制，請直接使用適當的網路命令（nsg 規則建立等）。

az vm open-port --port
                [--apply-to-subnet]
                [--ids]
                [--name]
                [--nsg-name]
                [--priority]
                [--resource-group]
                [--subscription]

範例

將 VM 上的所有埠開啟至輸入流量。

az vm open-port -g MyResourceGroup -n MyVm --port '*'

以最高優先順序開啟 VM 上的埠範圍至輸入流量。

az vm open-port -g MyResourceGroup -n MyVm --port 80-100 --priority 100

以最高優先順序開啟埠 555、557、558 和 559 到輸入流量。

az vm open-port -g MyResourceGroup -n MyVm --port 555,557-559 --priority 100

開啟資源群組中所有 VM 的所有埠。

az vm open-port --ids $(az vm list -g MyResourceGroup --query "[].id" -o tsv) --port '*'

必要參數

--port

要開啟輸入流量的埠或埠範圍（例如：80-100）。使用『*』允許所有埠的流量。使用逗號分隔值來指定多個埠或埠範圍。

選擇性參數

--apply-to-subnet

允許子網上的輸入流量，而不是 NIC。

預設值: False

--ids

--name -n

要開啟輸入流量的虛擬機名稱。

--nsg-name

如果網路安全組不存在，要建立的網路安全組名稱。如果 NSG 已經存在，則忽略。

--priority

規則優先順序，介於 100（最高優先順序）和 4096 之間（最低優先順序）。集合中每個規則都必須是唯一的。

預設值: 900

--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 vm perform-maintenance

編輯

在虛擬機上執行維護的作業。

az vm perform-maintenance [--ids]
                          [--name]
                          [--no-wait {0, 1, f, false, n, no, t, true, y, yes}]
                          [--resource-group]
                          [--subscription]

選擇性參數

--ids

--name --vm-name -n

虛擬機的名稱。您可以使用來設定預設值 az configure --defaults vm=<name>。

--no-wait

請勿等候長時間執行的作業完成。

接受的值: 0, 1, f, false, n, no, t, true, y, yes

--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 vm reapply

編輯

重新套用 VM。

az vm reapply [--ids]
              [--name]
              [--no-wait {0, 1, f, false, n, no, t, true, y, yes}]
              [--resource-group]
              [--subscription]

範例

重新套用 VM。

az vm reapply -g MyResourceGroup -n MyVm

重新套用資源群組中的所有 VM。

az vm reapply --ids $(az vm list -g MyResourceGroup --query "[].id" -o tsv)

選擇性參數

--ids

--name --vm-name -n

虛擬機的名稱。您可以使用來設定預設值 az configure --defaults vm=<name>。

--no-wait

請勿等候長時間執行的作業完成。

接受的值: 0, 1, f, false, n, no, t, true, y, yes

--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 vm redeploy

編輯

重新部署現有的 VM。

az vm redeploy [--ids]
               [--name]
               [--no-wait {0, 1, f, false, n, no, t, true, y, yes}]
               [--resource-group]
               [--subscription]

範例

重新部署 VM。

az vm redeploy -g MyResourceGroup -n MyVm

重新部署資源群組中的所有 VM。

az vm redeploy --ids $(az vm list -g MyResourceGroup --query "[].id" -o tsv)

選擇性參數

--ids

--name --vm-name -n

虛擬機的名稱。您可以使用來設定預設值 az configure --defaults vm=<name>。

--no-wait

請勿等候長時間執行的作業完成。

接受的值: 0, 1, f, false, n, no, t, true, y, yes

--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 vm reimage

編輯

將虛擬機重新安裝映像（升級作業系統）。

對於具有暫時 OS 磁碟的虛擬機，將虛擬機重設為初始狀態，請重新安裝映像（升級作業系統）沒有暫時 OS 磁碟的虛擬機。注意：保留舊的OS磁碟取決於OS磁碟的deleteOption值。如果 deleteOption 中斷連結，則會在重新安裝映射之後保留舊的 OS 磁碟。如果 deleteOption 已刪除，在重新安裝映像之後，將會刪除舊的 OS 磁碟。執行重新安裝映像之前，應該更新OS磁碟的deleteOption。

az vm reimage [--admin-password]
              [--custom-data]
              [--exact-version]
              [--ids]
              [--name]
              [--no-wait {0, 1, f, false, n, no, t, true, y, yes}]
              [--resource-group]
              [--subscription]
              [--temp-disk {0, 1, f, false, n, no, t, true, y, yes}]

範例

重新映像虛擬機。

az vm reimage --name MyVm --resource-group MyResourceGroup --admin-password MyPassword --custom-data "dGVzdA==" --temp-disk false --exact-version 0.1

選擇性參數

--admin-password

指定系統管理員帳戶的密碼。

--custom-data

指定自訂數據的base-64編碼字串。

--exact-version

以十進位數指定作業系統磁碟應重新映像至的版本。如果未提供確切版本，OS 磁碟會重新映像到現有的 OS 磁碟版本。

--ids

--name --vm-name -n

虛擬機的名稱。您可以使用來設定預設值 az configure --defaults vm=<name>。

--no-wait

請勿等候長時間執行的作業完成。

接受的值: 0, 1, f, false, n, no, t, true, y, yes

--resource-group -g

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

--subscription

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

--temp-disk

指定是否要重新設定暫存磁碟的映像。預設值：false。注意：只有具有暫時 OS 磁碟的 VM/VMSS 才支援此暫存磁碟重新映像參數。

接受的值: 0, 1, f, false, n, no, t, true, y, yes

全域參數

--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 vm resize

編輯

更新 VM 的大小。

az vm resize --size
             [--ids]
             [--name]
             [--no-wait]
             [--resource-group]
             [--subscription]

範例

調整 VM 的大小。

az vm resize -g MyResourceGroup -n MyVm --size Standard_DS3_v2

調整資源群組中所有 VM 的大小。

az vm resize --size Standard_DS3_v2 --ids $(az vm list -g MyResourceGroup --query "[].id" -o tsv)

必要參數

--size

VM 大小。

值來源: az vm list-vm-resize-options

選擇性參數

--ids

--name -n

虛擬機的名稱。您可以使用來設定預設值 az configure --defaults vm=<name>。

--no-wait

請勿等候長時間執行的作業完成。

預設值: False

--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 vm restart

編輯

重新啟動 VM。

az vm restart [--force]
              [--ids]
              [--name]
              [--no-wait]
              [--resource-group]
              [--subscription]

範例

重新啟動 VM。

az vm restart -g MyResourceGroup -n MyVm

重新啟動資源群組中的所有 VM。

az vm restart --ids $(az vm list -g MyResourceGroup --query "[].id" -o tsv)

選擇性參數

--force

重新部署 VM 以強制重新啟動。如果 VM 沒有回應，請使用。

預設值: False

--ids

--name -n

虛擬機的名稱。您可以使用來設定預設值 az configure --defaults vm=<name>。

--no-wait

請勿等候長時間執行的作業完成。

預設值: False

--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 vm show

編輯

取得 VM 的詳細數據。

az vm show [--ids]
           [--include-user-data]
           [--name]
           [--resource-group]
           [--show-details]
           [--subscription]

範例

顯示 VM 的相關信息。

az vm show -g MyResourceGroup -n MyVm -d

取得資源群組中所有 VM 的詳細數據。

az vm show -d --ids $(az vm list -g MyResourceGroup --query "[].id" -o tsv)

選擇性參數

--ids

--include-user-data -u

在查詢結果中包含用戶資料屬性。

預設值: False

--name -n

虛擬機的名稱。您可以使用來設定預設值 az configure --defaults vm=<name>。

--resource-group -g

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

--show-details -d

顯示公用IP位址、FQDN和電源狀態。命令的執行速度將會變慢。

預設值: False

--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 vm simulate-eviction

編輯

模擬現成 VM 的收回。

az vm simulate-eviction [--ids]
                        [--name]
                        [--resource-group]
                        [--subscription]

範例

模擬現成 VM 的收回。

az vm simulate-eviction --resource-group MyResourceGroup --name MyVm

選擇性參數

--ids

--name --vm-name -n

虛擬機的名稱。您可以使用來設定預設值 az configure --defaults vm=<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 vm start

編輯

啟動已停止的 VM。

az vm start [--ids]
            [--name]
            [--no-wait {0, 1, f, false, n, no, t, true, y, yes}]
            [--resource-group]
            [--subscription]

範例

啟動已停止的 VM。

az vm start -g MyResourceGroup -n MyVm

啟動資源群組中的所有 VM。

az vm start --ids $(az vm list -g MyResourceGroup --query "[].id" -o tsv)

啟動已停止的 VM。

az vm start --name MyVm --no-wait --resource-group MyResourceGroup

選擇性參數

--ids

--name --vm-name -n

虛擬機的名稱。您可以使用來設定預設值 az configure --defaults vm=<name>。

--no-wait

請勿等候長時間執行的作業完成。

接受的值: 0, 1, f, false, n, no, t, true, y, yes

--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 vm stop

編輯

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

VM 將會繼續計費。若要避免這種情況，您可以透過「az vm deallocate」解除分配 VM。

az vm stop [--ids]
           [--name]
           [--no-wait]
           [--resource-group]
           [--skip-shutdown]
           [--subscription]

範例

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

az vm stop --resource-group MyResourceGroup --name MyVm

在不關閉的情況下關閉執行中的 VM。

az vm stop --resource-group MyResourceGroup --name MyVm --skip-shutdown

關閉資源群組中的 VM 電源。

az vm stop --ids $(az vm list -g MyResourceGroup --query "[].id" -o tsv)

選擇性參數

--ids

--name -n

虛擬機的名稱。您可以使用來設定預設值 az configure --defaults vm=<name>。

--no-wait

請勿等候長時間執行的作業完成。

預設值: False

--resource-group -g

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

--skip-shutdown

立即略過關機和關閉電源。

預設值: False

--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 vm update

編輯

更新 VM 的屬性。

使用對應至『az vm show』的路徑來更新 VM 物件和屬性。

az vm update [--add]
             [--capacity-reservation-group]
             [--disk-caching]
             [--disk-controller-type {NVMe, SCSI}]
             [--enable-hibernation {false, true}]
             [--enable-proxy-agent {false, true}]
             [--enable-secure-boot {false, true}]
             [--enable-vtpm {false, true}]
             [--ephemeral-os-disk-placement {CacheDisk, NvmeDisk, ResourceDisk}]
             [--force-string]
             [--host]
             [--host-group]
             [--ids]
             [--license-type {None, RHEL_BASE, RHEL_BASESAPAPPS, RHEL_BASESAPHA, RHEL_BYOS, RHEL_ELS_6, RHEL_EUS, RHEL_SAPAPPS, RHEL_SAPHA, SLES, SLES_BYOS, SLES_HPC, SLES_SAP, SLES_STANDARD, UBUNTU, UBUNTU_PRO, Windows_Client, Windows_Server}]
             [--max-price]
             [--name]
             [--no-wait]
             [--os-disk]
             [--ppg]
             [--priority {Low, Regular, Spot}]
             [--proxy-agent-mode {Audit, Enforce}]
             [--remove]
             [--resource-group]
             [--security-type {TrustedLaunch}]
             [--set]
             [--size]
             [--subscription]
             [--ultra-ssd-enabled {false, true}]
             [--user-data]
             [--v-cpus-available]
             [--v-cpus-per-core]
             [--workspace]
             [--write-accelerator]

範例

新增或更新標記。

az vm update -n name -g group --set tags.tagName=tagValue

拿掉標籤。

az vm update -n name -g group --remove tags.tagName

設定 VM 的主要 NIC。

az vm update -n name -g group --set networkProfile.networkInterfaces[1].primary=false networkProfile.networkInterfaces[0].primary=true

將新的非主要 NIC 新增至 VM。

az vm update -n name -g group --add networkProfile.networkInterfaces primary=false id={NIC_ID}

從 VM 移除第四個 NIC。

az vm update -n name -g group --remove networkProfile.networkInterfaces 3

將現有的 VM 新增至專用主機

az vm deallocate -n name -g group
az vm update -n name -g group --host my-host
az vm start -n name -g group

將現有的 VM 新增至專用主機群組

az vm deallocate -n name -g group
az vm update -n name -g group --host-group my-host-group
az vm start -n name -g group

選擇性參數

--add

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

預設值: []

--capacity-reservation-group --crg

預覽

--disk-caching

使用單一值來套用到或指定個別磁碟，例如 'os=ReadWrite 0=None 1=ReadOnly' 應該啟用更新 os 磁碟和 2 個數據磁碟。

--disk-controller-type

預覽

指定為 VM 或 VMSS 設定的磁碟控制器類型。

接受的值: NVMe, SCSI

--enable-hibernation

在 VM 上啟用或停用休眠功能的旗標。

接受的值: false, true

--enable-proxy-agent

指定是否應在虛擬機或虛擬機擴展集上啟用 Proxy 代理程式功能。

接受的值: false, true

--enable-secure-boot

啟用安全開機。

接受的值: false, true

--enable-vtpm

啟用 vTPM。

接受的值: false, true

--ephemeral-os-disk-placement --ephemeral-placement

僅適用於搭配 --size使用時。可讓您選擇暫時 OS 磁碟布建位置。

接受的值: CacheDisk, NvmeDisk, ResourceDisk

--force-string

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

預設值: False

--host

預覽

VM 將位於之專用主機的資源標識碼。 --host 和 --host-group 無法一起使用。您應該在更新之前解除分配 VM，並在更新後啟動 VM。如需更多範例，請參閱說明。

--host-group

預覽

VM 將位於之專用主機群組的名稱或資源識別碼。 --host 和 --host-group 無法一起使用。您應該在更新之前解除分配 VM，並在更新後啟動 VM。如需更多範例，請參閱說明。

--ids

--license-type

--max-price

預覽

您願意支付現成 VM/VMSS 的最高價格（以美元為單位）。 -1 表示基於價格原因，不應收回 Spot VM/VMSS。

--name -n

虛擬機的名稱。您可以使用來設定預設值 az configure --defaults vm=<name>。

--no-wait

請勿等候長時間執行的作業完成。

預設值: False

--os-disk

要交換的受控 OS 磁碟標識碼或名稱。

--ppg

VM 應該與鄰近放置群組的名稱或標識符相關聯。

--priority

接受的值: Low, Regular, Spot

--proxy-agent-mode

如果啟用此功能，請指定 Proxy 代理程式在上執行的模式。

接受的值: Audit, Enforce

--remove

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

預設值: []

--resource-group -g

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

--security-type

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

接受的值: TrustedLaunch

--set

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

預設值: []

--size

預覽

虛擬機的新大小。如需大小資訊，請參閱 https://azure.microsoft.com/pricing/details/virtual-machines/ 。

--subscription

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

--ultra-ssd-enabled

啟用或停用具有1個以上的受控數據磁碟與UltraSSD_LRS記憶體帳戶的功能。

接受的值: false, true

--user-data

VM 的 UserData。它可以以檔案或字串的形式傳入。如果傳入空字串，將會刪除現有的值。

--v-cpus-available

指定可用的 vCPU 數目。

--v-cpus-per-core

指定 vCPU 與實體核心的比例。將此屬性設定為 1 也表示已停用超線程處理。

--workspace

預覽

Log Analytics 工作區的名稱或標識碼。如果您透過其名稱指定工作區，則工作區應該位於與 vm 相同的資源群組中，否則將會建立新的工作區。

--write-accelerator

啟用/停用磁碟寫入加速器。針對 os 磁碟和數據磁碟使用單一值 'true/false' 來套用到或指定個別磁碟，例如'os=true 1=true 2=true'。

全域參數

--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 vm wait

編輯

將 CLI 置於等候狀態，直到符合 VM 的條件為止。

az vm wait [--created]
           [--custom]
           [--deleted]
           [--exists]
           [--ids]
           [--interval]
           [--name]
           [--resource-group]
           [--subscription]
           [--timeout]
           [--updated]

範例

等候 VM 建立。

az vm wait -g MyResourceGroup -n MyVm --created

等到資源群組中的所有 VM 都刪除為止。

az vm wait --deleted --ids $(az vm list -g MyResourceGroup --query "[].id" -o tsv)

選擇性參數

--created

請等候在 'Succeeded' 使用 'provisioningState' 建立。

預設值: False

--custom

等到條件符合自定義 JMESPath 查詢為止。例如 provisioningState！='InProgress'， instanceView.statuses[？code=='PowerState/running']。

--deleted

等到刪除為止。

預設值: False

--exists

等候資源存在。

預設值: False

--ids

--interval

輪詢間隔以秒為單位。

預設值: 30

--name -n

虛擬機的名稱。您可以使用來設定預設值 az configure --defaults vm=<name>。

--resource-group -g

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

--subscription

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

--timeout

以秒為單位的等候上限。

預設值: 3600

--updated

等到 provisioningState 更新為 'Succeeded'。

預設值: 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 vm

命令

az vm assess-patches

範例

選擇性參數

az vm auto-shutdown

範例

選擇性參數

az vm capture

範例

必要參數

選擇性參數

az vm convert

範例

選擇性參數

az vm create

範例

必要參數

選擇性參數

az vm deallocate

範例

選擇性參數

az vm delete

範例

選擇性參數

az vm generalize

範例

選擇性參數

az vm get-instance-view

範例

選擇性參數

az vm install-patches

範例

必要參數

選擇性參數

az vm list

範例

選擇性參數

az vm list-ip-addresses

範例

選擇性參數

az vm list-sizes

範例

選擇性參數

az vm list-skus

範例

選擇性參數

az vm list-usage

範例

必要參數

az vm list-vm-resize-options

範例

選擇性參數

az vm open-port

範例

必要參數

選擇性參數

az vm perform-maintenance

選擇性參數

az vm reapply

範例

選擇性參數

az vm redeploy

範例

選擇性參數

az vm reimage

範例

選擇性參數

az vm resize

範例

必要參數

選擇性參數

az vm restart

範例

選擇性參數

az vm show

範例

選擇性參數

az vm simulate-eviction