az vm

Note

此命令群組具有 Azure CLI 和至少一個擴充功能中定義的命令。安裝每個擴充功能以受益於其擴充功能。 Learn more about extensions.

管理 Linux 或 Windows 虛擬機。

命令

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

az vm assess-patches

編輯

評估 VM 上的修補程式。

az vm assess-patches [--ids]
                     [--name --vm-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

選擇性參數

The following parameters are optional, but depending on the context, one or more might become required for the command to execute successfully.

--ids

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

屬性	值
Parameter group:	Resource Id Arguments

--name --vm-name -n

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

屬性	值
Parameter group:	Resource Id Arguments

--no-wait

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

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

--resource-group -g

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

屬性	值
Parameter group:	Resource Id Arguments

--subscription

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

屬性	值
Parameter group:	Resource Id Arguments

全域參數

--debug

提高日誌詳細程度以顯示所有調試日誌。

屬性	值
預設值:	False

--help -h

顯示此說明訊息並結束。

--only-show-errors

只顯示錯誤，隱藏警告。

屬性	值
預設值:	False

--output -o

Output format.

屬性	值
預設值:	json
接受的值:	json, jsonc, none, table, tsv, yaml, yamlc

--query

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

--verbose

增加記錄的詳細程度。針對完整偵錯記錄使用 --debug。

屬性	值
預設值:	False

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

選擇性參數

The following parameters are optional, but depending on the context, one or more might become required for the command to execute successfully.

--email

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

--ids

屬性	值
Parameter group:	Resource Id Arguments

--location -l

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

--name -n

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

屬性	值
Parameter group:	Resource Id Arguments

--off

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

--resource-group -g

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

屬性	值
Parameter group:	Resource Id Arguments

--subscription

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

屬性	值
Parameter group:	Resource Id Arguments

--time

排程將每天發生的UTC時間。 Format: hhmm. Example: 1730.

--webhook

將傳送通知的 Webhook URL。

全域參數

--debug

提高日誌詳細程度以顯示所有調試日誌。

屬性	值
預設值:	False

--help -h

顯示此說明訊息並結束。

--only-show-errors

只顯示錯誤，隱藏警告。

屬性	值
預設值:	False

--output -o

Output format.

屬性	值
預設值:	json
接受的值:	json, jsonc, none, table, tsv, yaml, yamlc

--query

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

--verbose

增加記錄的詳細程度。針對完整偵錯記錄使用 --debug。

屬性	值
預設值:	False

az vm capture

編輯

擷取已停止 VM 的資訊。

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

az vm capture --vhd-name-prefix
              [--ids]
              [--name]
              [--no-wait {0, 1, f, false, n, no, t, true, y, yes}]
              [--overwrite {0, 1, f, false, n, no, t, true, y, yes}]
              [--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

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

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

必要參數

--vhd-name-prefix

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

屬性	值
Parameter group:	Parameters Arguments

選擇性參數

The following parameters are optional, but depending on the context, one or more might become required for the command to execute successfully.

--ids

屬性	值
Parameter group:	Resource Id Arguments

--name -n

虛擬機器的名稱。

屬性	值
Parameter group:	Resource Id Arguments

--no-wait

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

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

--overwrite

覆寫現有的磁碟檔案。

屬性	值
Parameter group:	Parameters Arguments
預設值:	True
接受的值:	0, 1, f, false, n, no, t, true, y, yes

--resource-group -g

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

屬性	值
Parameter group:	Resource Id Arguments

--storage-container

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

屬性	值
Parameter group:	Parameters Arguments
預設值:	vhds

--subscription

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

屬性	值
Parameter group:	Resource Id Arguments

全域參數

--debug

提高日誌詳細程度以顯示所有調試日誌。

屬性	值
預設值:	False

--help -h

顯示此說明訊息並結束。

--only-show-errors

只顯示錯誤，隱藏警告。

屬性	值
預設值:	False

--output -o

Output format.

屬性	值
預設值:	json
接受的值:	json, jsonc, none, table, tsv, yaml, yamlc

--query

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

--verbose

增加記錄的詳細程度。針對完整偵錯記錄使用 --debug。

屬性	值
預設值:	False

az vm convert

編輯

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

az vm convert [--ids]
              [--name --vm-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)

選擇性參數

The following parameters are optional, but depending on the context, one or more might become required for the command to execute successfully.

--ids

屬性	值
Parameter group:	Resource Id Arguments

--name --vm-name -n

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

屬性	值
Parameter group:	Resource Id Arguments

--no-wait

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

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

--resource-group -g

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

屬性	值
Parameter group:	Resource Id Arguments

--subscription

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

屬性	值
Parameter group:	Resource Id Arguments

全域參數

--debug

提高日誌詳細程度以顯示所有調試日誌。

屬性	值
預設值:	False

--help -h

顯示此說明訊息並結束。

--only-show-errors

只顯示錯誤，隱藏警告。

屬性	值
預設值:	False

--output -o

Output format.

屬性	值
預設值:	json
接受的值:	json, jsonc, none, table, tsv, yaml, yamlc

--query

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

--verbose

增加記錄的詳細程度。針對完整偵錯記錄使用 --debug。

屬性	值
預設值:	False

az vm create

編輯

建立 Azure 虛擬機。

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

az vm create --name
             --resource-group
             [--accelerated-networking {false, true}]
             [--accept-term]
             [--additional-events --additional-scheduled-events {false, true}]
             [--admin-password]
             [--admin-username]
             [--align-regional-disks --align-regional-disks-to-vm-zone {false, true}]
             [--asgs]
             [--assign-identity]
             [--attach-data-disks]
             [--attach-os-disk]
             [--authentication-type {all, password, ssh}]
             [--availability-set]
             [--boot-diagnostics-storage]
             [--capacity-reservation-group --crg]
             [--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-reboot --enable-user-reboot-scheduled-events {false, true}]
             [--enable-redeploy --enable-user-redeploy-scheduled-events {false, true}]
             [--enable-secure-boot {false, true}]
             [--enable-vtpm {false, true}]
             [--encryption-at-host {false, true}]
             [--encryption-identity]
             [--ephemeral-os-disk {false, true}]
             [--ephemeral-os-disk-placement --ephemeral-placement {CacheDisk, NvmeDisk, ResourceDisk}]
             [--eviction-policy {Deallocate, Delete}]
             [--exclude-zones]
             [--generate-ssh-keys]
             [--host]
             [--host-group]
             [--image]
             [--imds-access-control-profile-reference-id --imds-profile-id]
             [--imds-mode {Audit, Enforce}]
             [--include-zones]
             [--key-incarnation-id]
             [--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-rp]
             [--source-disk-restore-point-size-gb --source-rp-size]
             [--source-resource --source-snapshots-or-disks]
             [--source-resource-size --source-snapshots-or-disks-size-gb]
             [--specialized {false, true}]
             [--ssh-dest-key-path]
             [--ssh-key-name]
             [--ssh-key-type {Ed25519, RSA}]
             [--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]
             [--wire-server-access-control-profile-reference-id --wire-server-profile-id]
             [--wire-server-mode {Audit, Enforce}]
             [--workspace]
             [--zone]
             [--zone-placement-policy {Any}]

範例

使用自動 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://learn.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

使用 Key Vault 秘密建立 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，並新增 Azure 磁碟加密的加密身分識別

az vm create -n MyVm -g rg1 --image Debian11 --assign-identity myID --encryption-identity /subscriptions/00000000-0000-0000-0000-000000000000/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>來設定預設群組。

選擇性參數

The following parameters are optional, but depending on the context, one or more might become required for the command to execute successfully.

--accelerated-networking

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

屬性	值
Parameter group:	Network Arguments
接受的值:	false, true

--accept-term

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

--additional-events --additional-scheduled-events

建立事件方格和資源圖表排程事件設定時所使用的組態參數。

屬性	值
接受的值:	false, true

--admin-password

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

屬性	值
Parameter group:	Authentication Arguments

--admin-username

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

屬性	值
Parameter group:	Authentication Arguments

--align-regional-disks --align-regional-disks-to-vm-zone

指定是否應將區域磁碟對齊/移動到 VM 區域。這僅適用於已設定放置屬性的 VM。請注意，這項變更無法復原。

屬性	值
接受的值:	false, true

--asgs

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

屬性	值
Parameter group:	Network Arguments

--assign-identity

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

屬性	值
Parameter group:	Managed Service Identity Arguments

--attach-data-disks

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

屬性	值
Parameter group:	Storage Arguments

--attach-os-disk

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

屬性	值
Parameter group:	Storage Arguments

--authentication-type

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

屬性	值
Parameter group:	Authentication Arguments
接受的值:	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> 來設定個別磁碟。

屬性	值
Parameter group:	Storage Arguments

--data-disk-delete-option

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

屬性	值
Parameter group:	Storage Arguments

--data-disk-encryption-sets

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

屬性	值
Parameter group:	Storage Arguments

--data-disk-sizes-gb

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

屬性	值
Parameter group:	Storage Arguments

--disable-integrity-monitoring-autoupgrade

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

屬性	值
預設值:	False

--disk-controller-type

預覽

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

屬性	值
Parameter group:	Storage Arguments
接受的值:	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-reboot --enable-user-reboot-scheduled-events

發佈排程事件時所使用的組態參數，其他發佈目標。

屬性	值
接受的值:	false, true

--enable-redeploy --enable-user-redeploy-scheduled-events

建立使用者起始的重新部署排程事件設定建立時所使用的組態參數。

屬性	值
接受的值:	false, true

--enable-secure-boot

啟用安全開機。

屬性	值
接受的值:	false, true

--enable-vtpm

Enable vTPM.

屬性	值
接受的值:	false, true

--encryption-at-host

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

屬性	值
Parameter group:	Storage Arguments
接受的值:	false, true

--encryption-identity

使用者受控識別的資源標識碼，可用於 Azure 磁碟加密。

--ephemeral-os-disk

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

屬性	值
Parameter group:	Storage Arguments
接受的值:	false, true

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

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

屬性	值
Parameter group:	Storage Arguments
接受的值:	CacheDisk, NvmeDisk, ResourceDisk

--eviction-policy

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

屬性	值
接受的值:	Deallocate, Delete

--exclude-zones

如果「--zone-placement-policy」設置為「Any」，則系統選擇的可用區不得出現在使用「excludeZones」傳遞的可用區清單中。如果未提供「--exclude-zones」，則將考慮選擇該區域的所有可用區。

--generate-ssh-keys

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

屬性	值
Parameter group:	Authentication Arguments
預設值:	False

--host

預覽

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

屬性	值
Parameter group:	Dedicated Host Arguments

--host-group

預覽

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

屬性	值
Parameter group:	Dedicated Host Arguments

--image

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

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

--imds-access-control-profile-reference-id --imds-profile-id

指定 imds 的存取控制範本版本、資源 ID 資源 ID。

--imds-mode

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

屬性	值
接受的值:	Audit, Enforce

--include-zones

如果「--zone-placement-policy」設置為「Any」，則系統選擇的可用區必須出現在通過「--include-zones」傳遞的可用區清單中。如果未提供「--include-zones」，則將考慮選擇該區域的所有可用區。

--key-incarnation-id

增加此屬性的值可讓使用者重設用來保護客體與主機之間通道的密鑰。

--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 時網路介面會發生什麼事。使用單一值來套用至所有資源，或使用 <Name>=<Value> 來設定個別資源的刪除行為。可能的選項為 [刪除] 和 [中斷連結]。

屬性	值
Parameter group:	Network Arguments

--nics

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

屬性	值
Parameter group:	Network Arguments

--no-wait

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

屬性	值
預設值:	False

--nsg

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

屬性	值
Parameter group:	Network Arguments

--nsg-rule

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

屬性	值
Parameter group:	Network Arguments
接受的值:	NONE, RDP, SSH

--os-disk-caching

VM OS 磁碟的記憶體快取類型。 Default: ReadWrite.

屬性	值
Parameter group:	Storage Arguments
接受的值:	None, ReadOnly, ReadWrite

--os-disk-delete-option

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

屬性	值
Parameter group:	Storage Arguments
接受的值:	Delete, Detach

--os-disk-encryption-set

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

屬性	值
Parameter group:	Storage Arguments

--os-disk-name

新 VM OS 磁碟的名稱。

屬性	值
Parameter group:	Storage Arguments

--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 為單位。

屬性	值
Parameter group:	Storage Arguments

--os-type

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

屬性	值
Parameter group:	Storage Arguments
接受的值:	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 name.

屬性	值
Parameter group:	Marketplace Image Plan Arguments

--plan-product

Plan product.

屬性	值
Parameter group:	Marketplace Image Plan Arguments

--plan-promotion-code

規劃促銷碼。

屬性	值
Parameter group:	Marketplace Image Plan Arguments

--plan-publisher

Plan publisher.

屬性	值
Parameter group:	Marketplace Image Plan Arguments

--platform-fault-domain

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

--ppg

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

--priority

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

屬性	值
接受的值:	Low, Regular, Spot

--private-ip-address

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

屬性	值
Parameter group:	Network Arguments

--proxy-agent-mode

已被取代

選項 '--proxy-agent-mode' 已棄用，並將在未來版本中刪除。請改用『--wire-server-mode』。

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

屬性	值
接受的值:	Audit, Enforce

--public-ip-address

建立一個公用IP位址時的名稱（預設值）或參考現有的IP位址。也可以使用 PowerShell 在 Azure CLI 中依標識符參考現有的公用 IP，或為 None 指定 “” 或 ' 。

屬性	值
Parameter group:	Network Arguments

--public-ip-address-allocation

屬性	值
Parameter group:	Network Arguments
接受的值:	dynamic, static

--public-ip-address-dns-name

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

屬性	值
Parameter group:	Network Arguments

--public-ip-sku

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

屬性	值
Parameter group:	Network Arguments
預設值:	Standard
接受的值:	Basic, Standard

--role

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

屬性	值
Parameter group:	Managed Service Identity Arguments

--scope

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

屬性	值
Parameter group:	Managed Service Identity Arguments

--secrets

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

--security-type

指定虛擬機的安全性類型。如果訂閱具有在 Microsoft.Compute 命名空間下註冊的功能標誌 UseStandardSecurityType，則可以使用值 Standard。有關啟用所需功能的步驟，請參閱 https://learn.microsoft.com/en-us/azure/azure-resource-manager/management/preview-features 。

屬性	值
接受的值:	ConfidentialVM, Standard, TrustedLaunch

--size

已被取代

'--size' 的預設值將會在未來版本中從 'Standard_DS1_v2' 變更為 'Standard_D2s_v5'。

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

屬性	值
預設值:	Standard_DS1_v2
值來源:	az vm list-sizes

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

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

屬性	值
Parameter group:	Storage Arguments

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

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

屬性	值
Parameter group:	Storage Arguments

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

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

屬性	值
Parameter group:	Storage Arguments

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

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

屬性	值
Parameter group:	Storage Arguments

--specialized

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

屬性	值
Parameter group:	Storage Arguments
接受的值:	false, true

--ssh-dest-key-path

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

屬性	值
Parameter group:	Authentication Arguments

--ssh-key-name

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

--ssh-key-type

指定遺失時要產生的 SSH 公用和私鑰檔案類型。

屬性	值
Parameter group:	Authentication Arguments
預設值:	RSA
接受的值:	Ed25519, RSA

--ssh-key-values

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

屬性	值
Parameter group:	Authentication Arguments

--storage-account

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

屬性	值
Parameter group:	Storage Arguments

--storage-container-name

僅適用於搭配 --use-unmanaged-disk使用時。 VM OS 磁碟的記憶體容器名稱。 Default: vhds.

屬性	值
Parameter group:	Storage Arguments

--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。

屬性	值
Parameter group:	Storage Arguments

--subnet

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

屬性	值
Parameter group:	Network Arguments

--subnet-address-prefix

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

屬性	值
Parameter group:	Network Arguments
預設值:	10.0.0.0/24

--tags

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

--ultra-ssd-enabled

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

屬性	值
Parameter group:	Storage Arguments
接受的值:	false, true

--use-unmanaged-disk

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

屬性	值
Parameter group:	Storage Arguments
預設值:	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 位址前綴。

屬性	值
Parameter group:	Network Arguments
預設值:	10.0.0.0/16

--vnet-name

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

屬性	值
Parameter group:	Network Arguments

--wire-server-access-control-profile-reference-id --wire-server-profile-id

指定Wire伺服器的存取控制配置檔版本資源ID。

--wire-server-mode

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

屬性	值
接受的值:	Audit, Enforce

--workspace

預覽

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

屬性	值
Parameter group:	Monitor Arguments

--zone -z

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

--zone-placement-policy

指定虛擬機在可用區中的放置策略。

屬性	值
接受的值:	Any

全域參數

--debug

提高日誌詳細程度以顯示所有調試日誌。

屬性	值
預設值:	False

--help -h

顯示此說明訊息並結束。

--only-show-errors

只顯示錯誤，隱藏警告。

屬性	值
預設值:	False

--output -o

Output format.

屬性	值
預設值:	json
接受的值:	json, jsonc, none, table, tsv, yaml, yamlc

--query

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

--subscription

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

--verbose

增加記錄的詳細程度。針對完整偵錯記錄使用 --debug。

屬性	值
預設值:	False

az vm deallocate

編輯

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

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

az vm deallocate [--hibernate {0, 1, f, false, n, no, t, true, y, yes}]
                 [--ids]
                 [--name --vm-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

選擇性參數

The following parameters are optional, but depending on the context, one or more might become required for the command to execute successfully.

--hibernate

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

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

--ids

屬性	值
Parameter group:	Resource Id Arguments

--name --vm-name -n

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

屬性	值
Parameter group:	Resource Id Arguments

--no-wait

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

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

--resource-group -g

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

屬性	值
Parameter group:	Resource Id Arguments

--subscription

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

屬性	值
Parameter group:	Resource Id Arguments

全域參數

--debug

提高日誌詳細程度以顯示所有調試日誌。

屬性	值
預設值:	False

--help -h

顯示此說明訊息並結束。

--only-show-errors

只顯示錯誤，隱藏警告。

屬性	值
預設值:	False

--output -o

Output format.

屬性	值
預設值:	json
接受的值:	json, jsonc, none, table, tsv, yaml, yamlc

--query

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

--verbose

增加記錄的詳細程度。針對完整偵錯記錄使用 --debug。

屬性	值
預設值:	False

az vm delete

編輯

刪除刪除虛擬機的作業。

az vm delete [--force-deletion {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]
             [--yes]

範例

刪除 VM，而不提示確認。

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

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

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

選擇性參數

The following parameters are optional, but depending on the context, one or more might become required for the command to execute successfully.

--force-deletion

選擇性參數以強制刪除虛擬機。

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

--ids

屬性	值
Parameter group:	Resource Id Arguments

--name -n

虛擬機器的名稱。

屬性	值
Parameter group:	Resource Id Arguments

--no-wait

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

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

--resource-group -g

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

屬性	值
Parameter group:	Resource Id Arguments

--subscription

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

屬性	值
Parameter group:	Resource Id Arguments

--yes -y

請勿提示確認。

屬性	值
預設值:	False

全域參數

--debug

提高日誌詳細程度以顯示所有調試日誌。

屬性	值
預設值:	False

--help -h

顯示此說明訊息並結束。

--only-show-errors

只顯示錯誤，隱藏警告。

屬性	值
預設值:	False

--output -o

Output format.

屬性	值
預設值:	json
接受的值:	json, jsonc, none, table, tsv, yaml, yamlc

--query

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

--verbose

增加記錄的詳細程度。針對完整偵錯記錄使用 --debug。

屬性	值
預設值:	False

az vm generalize

編輯

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

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

az vm generalize [--ids]
                 [--name --vm-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

選擇性參數

The following parameters are optional, but depending on the context, one or more might become required for the command to execute successfully.

--ids

屬性	值
Parameter group:	Resource Id Arguments

--name --vm-name -n

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

屬性	值
Parameter group:	Resource Id Arguments

--resource-group -g

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

屬性	值
Parameter group:	Resource Id Arguments

--subscription

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

屬性	值
Parameter group:	Resource Id Arguments

全域參數

--debug

提高日誌詳細程度以顯示所有調試日誌。

屬性	值
預設值:	False

--help -h

顯示此說明訊息並結束。

--only-show-errors

只顯示錯誤，隱藏警告。

屬性	值
預設值:	False

--output -o

Output format.

屬性	值
預設值:	json
接受的值:	json, jsonc, none, table, tsv, yaml, yamlc

--query

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

--verbose

增加記錄的詳細程度。針對完整偵錯記錄使用 --debug。

屬性	值
預設值:	False

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)

選擇性參數

The following parameters are optional, but depending on the context, one or more might become required for the command to execute successfully.

--ids

屬性	值
Parameter group:	Resource Id Arguments

--name -n

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

屬性	值
Parameter group:	Resource Id Arguments

--resource-group -g

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

屬性	值
Parameter group:	Resource Id Arguments

--subscription

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

屬性	值
Parameter group:	Resource Id Arguments

全域參數

--debug

提高日誌詳細程度以顯示所有調試日誌。

屬性	值
預設值:	False

--help -h

顯示此說明訊息並結束。

--only-show-errors

只顯示錯誤，隱藏警告。

屬性	值
預設值:	False

--output -o

Output format.

屬性	值
預設值:	json
接受的值:	json, jsonc, none, table, tsv, yaml, yamlc

--query

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

--verbose

增加記錄的詳細程度。針對完整偵錯記錄使用 --debug。

屬性	值
預設值:	False

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

選擇性參數

The following parameters are optional, but depending on the context, one or more might become required for the command to execute successfully.

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

屬性	值
Parameter group:	Resource Id Arguments

--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>。

屬性	值
Parameter group:	Resource Id Arguments

--no-wait

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

屬性	值
預設值:	False

--package-name-masks-to-exclude

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

--package-name-masks-to-include

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

--resource-group -g

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

屬性	值
Parameter group:	Resource Id Arguments

--subscription

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

屬性	值
Parameter group:	Resource Id Arguments

全域參數

--debug

提高日誌詳細程度以顯示所有調試日誌。

屬性	值
預設值:	False

--help -h

顯示此說明訊息並結束。

--only-show-errors

只顯示錯誤，隱藏警告。

屬性	值
預設值:	False

--output -o

Output format.

屬性	值
預設值:	json
接受的值:	json, jsonc, none, table, tsv, yaml, yamlc

--query

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

--verbose

增加記錄的詳細程度。針對完整偵錯記錄使用 --debug。

屬性	值
預設值:	False

az vm list

編輯

列出虛擬機的詳細數據。

--resource-group 可以傳入空字串做為參數，這會輸出訂用帳戶下的所有 VM 資訊。如需查詢虛擬機器相關信息的詳細資訊，請參閱 https://learn.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

選擇性參數

The following parameters are optional, but depending on the context, one or more might become required for the command to execute successfully.

--resource-group -g

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

--show-details -d

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

屬性	值
預設值:	False

--vmss

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

全域參數

--debug

提高日誌詳細程度以顯示所有調試日誌。

屬性	值
預設值:	False

--help -h

顯示此說明訊息並結束。

--only-show-errors

只顯示錯誤，隱藏警告。

屬性	值
預設值:	False

--output -o

Output format.

屬性	值
預設值:	json
接受的值:	json, jsonc, none, table, tsv, yaml, yamlc

--query

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

--subscription

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

--verbose

增加記錄的詳細程度。針對完整偵錯記錄使用 --debug。

屬性	值
預設值:	False

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)

選擇性參數

The following parameters are optional, but depending on the context, one or more might become required for the command to execute successfully.

--ids

屬性	值
Parameter group:	Resource Id Arguments

--name -n

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

屬性	值
Parameter group:	Resource Id Arguments

--resource-group -g

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

屬性	值
Parameter group:	Resource Id Arguments

--subscription

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

屬性	值
Parameter group:	Resource Id Arguments

全域參數

--debug

提高日誌詳細程度以顯示所有調試日誌。

屬性	值
預設值:	False

--help -h

顯示此說明訊息並結束。

--only-show-errors

只顯示錯誤，隱藏警告。

屬性	值
預設值:	False

--output -o

Output format.

屬性	值
預設值:	json
接受的值:	json, jsonc, none, table, tsv, yaml, yamlc

--query

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

--verbose

增加記錄的詳細程度。針對完整偵錯記錄使用 --debug。

屬性	值
預設值:	False

az vm list-sizes

編輯

已被取代

此命令已被取代，並將在未來版本中移除。請改用『az vm list-skus』。

列出 VM 的可用大小。

az vm list-sizes --location

範例

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

az vm list-sizes -l westus

必要參數

--location -l

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

全域參數

--debug

提高日誌詳細程度以顯示所有調試日誌。

屬性	值
預設值:	False

--help -h

顯示此說明訊息並結束。

--only-show-errors

只顯示錯誤，隱藏警告。

屬性	值
預設值:	False

--output -o

Output format.

屬性	值
預設值:	json
接受的值:	json, jsonc, none, table, tsv, yaml, yamlc

--query

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

--subscription

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

--verbose

增加記錄的詳細程度。針對完整偵錯記錄使用 --debug。

屬性	值
預設值:	False

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

選擇性參數

The following parameters are optional, but depending on the context, one or more might become required for the command to execute successfully.

--all

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

屬性	值
接受的值:	false, true

--location -l

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

--resource-type -r

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

--size -s

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

--zone -z

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

屬性	值
接受的值:	false, true

全域參數

--debug

提高日誌詳細程度以顯示所有調試日誌。

屬性	值
預設值:	False

--help -h

顯示此說明訊息並結束。

--only-show-errors

只顯示錯誤，隱藏警告。

屬性	值
預設值:	False

--output -o

Output format.

屬性	值
預設值:	json
接受的值:	json, jsonc, none, table, tsv, yaml, yamlc

--query

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

--subscription

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

--verbose

增加記錄的詳細程度。針對完整偵錯記錄使用 --debug。

屬性	值
預設值:	False

az vm list-usage

編輯

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

az vm list-usage --location

範例

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

az vm list-usage -l westus

必要參數

--location -l

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

全域參數

--debug

提高日誌詳細程度以顯示所有調試日誌。

屬性	值
預設值:	False

--help -h

顯示此說明訊息並結束。

--only-show-errors

只顯示錯誤，隱藏警告。

屬性	值
預設值:	False

--output -o

Output format.

屬性	值
預設值:	json
接受的值:	json, jsonc, none, table, tsv, yaml, yamlc

--query

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

--subscription

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

--verbose

增加記錄的詳細程度。針對完整偵錯記錄使用 --debug。

屬性	值
預設值:	False

az vm list-vm-resize-options

編輯

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

az vm list-vm-resize-options [--ids]
                             [--name --vm-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)

選擇性參數

The following parameters are optional, but depending on the context, one or more might become required for the command to execute successfully.

--ids

屬性	值
Parameter group:	Resource Id Arguments

--name --vm-name -n

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

屬性	值
Parameter group:	Resource Id Arguments

--resource-group -g

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

屬性	值
Parameter group:	Resource Id Arguments

--subscription

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

屬性	值
Parameter group:	Resource Id Arguments

全域參數

--debug

提高日誌詳細程度以顯示所有調試日誌。

屬性	值
預設值:	False

--help -h

顯示此說明訊息並結束。

--only-show-errors

只顯示錯誤，隱藏警告。

屬性	值
預設值:	False

--output -o

Output format.

屬性	值
預設值:	json
接受的值:	json, jsonc, none, table, tsv, yaml, yamlc

--query

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

--verbose

增加記錄的詳細程度。針對完整偵錯記錄使用 --debug。

屬性	值
預設值:	False

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）。使用『*』允許所有埠的流量。使用逗號分隔值來指定多個埠或埠範圍。

選擇性參數

The following parameters are optional, but depending on the context, one or more might become required for the command to execute successfully.

--apply-to-subnet

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

屬性	值
預設值:	False

--ids

屬性	值
Parameter group:	Resource Id Arguments

--name -n

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

屬性	值
Parameter group:	Resource Id Arguments

--nsg-name

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

--priority

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

屬性	值
預設值:	900

--resource-group -g

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

屬性	值
Parameter group:	Resource Id Arguments

--subscription

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

屬性	值
Parameter group:	Resource Id Arguments

全域參數

--debug

提高日誌詳細程度以顯示所有調試日誌。

屬性	值
預設值:	False

--help -h

顯示此說明訊息並結束。

--only-show-errors

只顯示錯誤，隱藏警告。

屬性	值
預設值:	False

--output -o

Output format.

屬性	值
預設值:	json
接受的值:	json, jsonc, none, table, tsv, yaml, yamlc

--query

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

--verbose

增加記錄的詳細程度。針對完整偵錯記錄使用 --debug。

屬性	值
預設值:	False

az vm perform-maintenance

編輯

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

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

選擇性參數

The following parameters are optional, but depending on the context, one or more might become required for the command to execute successfully.

--ids

屬性	值
Parameter group:	Resource Id Arguments

--name --vm-name -n

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

屬性	值
Parameter group:	Resource Id Arguments

--no-wait

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

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

--resource-group -g

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

屬性	值
Parameter group:	Resource Id Arguments

--subscription

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

屬性	值
Parameter group:	Resource Id Arguments

全域參數

--debug

提高日誌詳細程度以顯示所有調試日誌。

屬性	值
預設值:	False

--help -h

顯示此說明訊息並結束。

--only-show-errors

只顯示錯誤，隱藏警告。

屬性	值
預設值:	False

--output -o

Output format.

屬性	值
預設值:	json
接受的值:	json, jsonc, none, table, tsv, yaml, yamlc

--query

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

--verbose

增加記錄的詳細程度。針對完整偵錯記錄使用 --debug。

屬性	值
預設值:	False

az vm reapply

編輯

Reapply VMs.

az vm reapply [--ids]
              [--name --vm-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)

選擇性參數

The following parameters are optional, but depending on the context, one or more might become required for the command to execute successfully.

--ids

屬性	值
Parameter group:	Resource Id Arguments

--name --vm-name -n

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

屬性	值
Parameter group:	Resource Id Arguments

--no-wait

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

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

--resource-group -g

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

屬性	值
Parameter group:	Resource Id Arguments

--subscription

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

屬性	值
Parameter group:	Resource Id Arguments

全域參數

--debug

提高日誌詳細程度以顯示所有調試日誌。

屬性	值
預設值:	False

--help -h

顯示此說明訊息並結束。

--only-show-errors

只顯示錯誤，隱藏警告。

屬性	值
預設值:	False

--output -o

Output format.

屬性	值
預設值:	json
接受的值:	json, jsonc, none, table, tsv, yaml, yamlc

--query

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

--verbose

增加記錄的詳細程度。針對完整偵錯記錄使用 --debug。

屬性	值
預設值:	False

az vm redeploy

編輯

重新部署現有的 VM。

az vm redeploy [--ids]
               [--name --vm-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)

選擇性參數

The following parameters are optional, but depending on the context, one or more might become required for the command to execute successfully.

--ids

屬性	值
Parameter group:	Resource Id Arguments

--name --vm-name -n

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

屬性	值
Parameter group:	Resource Id Arguments

--no-wait

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

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

--resource-group -g

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

屬性	值
Parameter group:	Resource Id Arguments

--subscription

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

屬性	值
Parameter group:	Resource Id Arguments

全域參數

--debug

提高日誌詳細程度以顯示所有調試日誌。

屬性	值
預設值:	False

--help -h

顯示此說明訊息並結束。

--only-show-errors

只顯示錯誤，隱藏警告。

屬性	值
預設值:	False

--output -o

Output format.

屬性	值
預設值:	json
接受的值:	json, jsonc, none, table, tsv, yaml, yamlc

--query

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

--verbose

增加記錄的詳細程度。針對完整偵錯記錄使用 --debug。

屬性	值
預設值:	False

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

選擇性參數

The following parameters are optional, but depending on the context, one or more might become required for the command to execute successfully.

--admin-password

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

屬性	值
Parameter group:	OsProfile Arguments

--custom-data

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

屬性	值
Parameter group:	OsProfile Arguments

--exact-version

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

屬性	值
Parameter group:	Parameters Arguments

--ids

屬性	值
Parameter group:	Resource Id Arguments

--name --vm-name -n

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

屬性	值
Parameter group:	Resource Id Arguments

--no-wait

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

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

--resource-group -g

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

屬性	值
Parameter group:	Resource Id Arguments

--subscription

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

屬性	值
Parameter group:	Resource Id Arguments

--temp-disk

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

屬性	值
Parameter group:	Parameters Arguments
接受的值:	0, 1, f, false, n, no, t, true, y, yes

全域參數

--debug

提高日誌詳細程度以顯示所有調試日誌。

屬性	值
預設值:	False

--help -h

顯示此說明訊息並結束。

--only-show-errors

只顯示錯誤，隱藏警告。

屬性	值
預設值:	False

--output -o

Output format.

屬性	值
預設值:	json
接受的值:	json, jsonc, none, table, tsv, yaml, yamlc

--query

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

--verbose

增加記錄的詳細程度。針對完整偵錯記錄使用 --debug。

屬性	值
預設值:	False

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

選擇性參數

The following parameters are optional, but depending on the context, one or more might become required for the command to execute successfully.

--ids

屬性	值
Parameter group:	Resource Id Arguments

--name -n

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

屬性	值
Parameter group:	Resource Id Arguments

--no-wait

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

屬性	值
預設值:	False

--resource-group -g

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

屬性	值
Parameter group:	Resource Id Arguments

--subscription

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

屬性	值
Parameter group:	Resource Id Arguments

全域參數

--debug

提高日誌詳細程度以顯示所有調試日誌。

屬性	值
預設值:	False

--help -h

顯示此說明訊息並結束。

--only-show-errors

只顯示錯誤，隱藏警告。

屬性	值
預設值:	False

--output -o

Output format.

屬性	值
預設值:	json
接受的值:	json, jsonc, none, table, tsv, yaml, yamlc

--query

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

--verbose

增加記錄的詳細程度。針對完整偵錯記錄使用 --debug。

屬性	值
預設值:	False

az vm restart

編輯

Restart VMs.

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)

選擇性參數

The following parameters are optional, but depending on the context, one or more might become required for the command to execute successfully.

--force

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

屬性	值
預設值:	False

--ids

屬性	值
Parameter group:	Resource Id Arguments

--name -n

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

屬性	值
Parameter group:	Resource Id Arguments

--no-wait

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

屬性	值
預設值:	False

--resource-group -g

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

屬性	值
Parameter group:	Resource Id Arguments

--subscription

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

屬性	值
Parameter group:	Resource Id Arguments

全域參數

--debug

提高日誌詳細程度以顯示所有調試日誌。

屬性	值
預設值:	False

--help -h

顯示此說明訊息並結束。

--only-show-errors

只顯示錯誤，隱藏警告。

屬性	值
預設值:	False

--output -o

Output format.

屬性	值
預設值:	json
接受的值:	json, jsonc, none, table, tsv, yaml, yamlc

--query

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

--verbose

增加記錄的詳細程度。針對完整偵錯記錄使用 --debug。

屬性	值
預設值:	False

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)

選擇性參數

The following parameters are optional, but depending on the context, one or more might become required for the command to execute successfully.

--ids

屬性	值
Parameter group:	Resource Id Arguments

--include-user-data -u

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

屬性	值
預設值:	False

--name -n

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

屬性	值
Parameter group:	Resource Id Arguments

--resource-group -g

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

屬性	值
Parameter group:	Resource Id Arguments

--show-details -d

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

屬性	值
預設值:	False

--subscription

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

屬性	值
Parameter group:	Resource Id Arguments

全域參數

--debug

提高日誌詳細程度以顯示所有調試日誌。

屬性	值
預設值:	False

--help -h

顯示此說明訊息並結束。

--only-show-errors

只顯示錯誤，隱藏警告。

屬性	值
預設值:	False

--output -o

Output format.

屬性	值
預設值:	json
接受的值:	json, jsonc, none, table, tsv, yaml, yamlc

--query

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

--verbose

增加記錄的詳細程度。針對完整偵錯記錄使用 --debug。

屬性	值
預設值:	False

az vm simulate-eviction

編輯

模擬現成 VM 的收回。

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

範例

模擬現成 VM 的收回。

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

選擇性參數

The following parameters are optional, but depending on the context, one or more might become required for the command to execute successfully.

--ids

屬性	值
Parameter group:	Resource Id Arguments

--name --vm-name -n

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

屬性	值
Parameter group:	Resource Id Arguments

--resource-group -g

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

屬性	值
Parameter group:	Resource Id Arguments

--subscription

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

屬性	值
Parameter group:	Resource Id Arguments

全域參數

--debug

提高日誌詳細程度以顯示所有調試日誌。

屬性	值
預設值:	False

--help -h

顯示此說明訊息並結束。

--only-show-errors

只顯示錯誤，隱藏警告。

屬性	值
預設值:	False

--output -o

Output format.

屬性	值
預設值:	json
接受的值:	json, jsonc, none, table, tsv, yaml, yamlc

--query

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

--verbose

增加記錄的詳細程度。針對完整偵錯記錄使用 --debug。

屬性	值
預設值:	False

az vm start

編輯

啟動已停止的 VM。

az vm start [--ids]
            [--name --vm-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

選擇性參數

The following parameters are optional, but depending on the context, one or more might become required for the command to execute successfully.

--ids

屬性	值
Parameter group:	Resource Id Arguments

--name --vm-name -n

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

屬性	值
Parameter group:	Resource Id Arguments

--no-wait

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

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

--resource-group -g

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

屬性	值
Parameter group:	Resource Id Arguments

--subscription

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

屬性	值
Parameter group:	Resource Id Arguments

全域參數

--debug

提高日誌詳細程度以顯示所有調試日誌。

屬性	值
預設值:	False

--help -h

顯示此說明訊息並結束。

--only-show-errors

只顯示錯誤，隱藏警告。

屬性	值
預設值:	False

--output -o

Output format.

屬性	值
預設值:	json
接受的值:	json, jsonc, none, table, tsv, yaml, yamlc

--query

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

--verbose

增加記錄的詳細程度。針對完整偵錯記錄使用 --debug。

屬性	值
預設值:	False

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)

選擇性參數

The following parameters are optional, but depending on the context, one or more might become required for the command to execute successfully.

--ids

屬性	值
Parameter group:	Resource Id Arguments

--name -n

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

屬性	值
Parameter group:	Resource Id Arguments

--no-wait

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

屬性	值
預設值:	False

--resource-group -g

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

屬性	值
Parameter group:	Resource Id Arguments

--skip-shutdown

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

屬性	值
預設值:	False

--subscription

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

屬性	值
Parameter group:	Resource Id Arguments

全域參數

--debug

提高日誌詳細程度以顯示所有調試日誌。

屬性	值
預設值:	False

--help -h

顯示此說明訊息並結束。

--only-show-errors

只顯示錯誤，隱藏警告。

屬性	值
預設值:	False

--output -o

Output format.

屬性	值
預設值:	json
接受的值:	json, jsonc, none, table, tsv, yaml, yamlc

--query

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

--verbose

增加記錄的詳細程度。針對完整偵錯記錄使用 --debug。

屬性	值
預設值:	False

az vm update

編輯

更新 VM 的屬性。

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

az vm update [--add]
             [--additional-events --additional-scheduled-events {false, true}]
             [--align-regional-disks --align-regional-disks-to-vm-zone {false, true}]
             [--capacity-reservation-group --crg]
             [--disk-caching]
             [--disk-controller-type {NVMe, SCSI}]
             [--enable-hibernation {false, true}]
             [--enable-proxy-agent {false, true}]
             [--enable-reboot --enable-user-reboot-scheduled-events {false, true}]
             [--enable-redeploy --enable-user-redeploy-scheduled-events {false, true}]
             [--enable-secure-boot {false, true}]
             [--enable-vtpm {false, true}]
             [--ephemeral-os-disk-placement --ephemeral-placement {CacheDisk, NvmeDisk, ResourceDisk}]
             [--force-string]
             [--host]
             [--host-group]
             [--ids]
             [--imds-access-control-profile-reference-id --imds-profile-id]
             [--imds-mode {Audit, Enforce}]
             [--key-incarnation-id]
             [--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 {ConfidentialVM, Standard, TrustedLaunch}]
             [--set]
             [--size]
             [--subscription]
             [--ultra-ssd-enabled {false, true}]
             [--user-data]
             [--v-cpus-available]
             [--v-cpus-per-core]
             [--wire-server-access-control-profile-reference-id --wire-server-profile-id]
             [--wire-server-mode {Audit, Enforce}]
             [--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

選擇性參數

The following parameters are optional, but depending on the context, one or more might become required for the command to execute successfully.

--add

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

屬性	值
Parameter group:	Generic Update Arguments
預設值:	[]

--additional-events --additional-scheduled-events

建立事件方格和資源圖表排程事件設定時所使用的組態參數。

屬性	值
接受的值:	false, true

--align-regional-disks --align-regional-disks-to-vm-zone

指定是否應將區域磁碟對齊/移動到 VM 區域。這僅適用於已設定放置屬性的 VM。請注意，這項變更無法復原。

屬性	值
接受的值:	false, true

--capacity-reservation-group --crg

預覽

--disk-caching

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

--disk-controller-type

預覽

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

屬性	值
Parameter group:	Storage Arguments
接受的值:	NVMe, SCSI

--enable-hibernation

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

屬性	值
接受的值:	false, true

--enable-proxy-agent

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

屬性	值
接受的值:	false, true

--enable-reboot --enable-user-reboot-scheduled-events

發佈排程事件時所使用的組態參數，其他發佈目標。

屬性	值
接受的值:	false, true

--enable-redeploy --enable-user-redeploy-scheduled-events

建立使用者起始的重新部署排程事件設定建立時所使用的組態參數。

屬性	值
接受的值:	false, true

--enable-secure-boot

啟用安全開機。

屬性	值
接受的值:	false, true

--enable-vtpm

Enable vTPM.

屬性	值
接受的值:	false, true

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

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

屬性	值
接受的值:	CacheDisk, NvmeDisk, ResourceDisk

--force-string

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

屬性	值
Parameter group:	Generic Update Arguments
預設值:	False

--host

預覽

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

屬性	值
Parameter group:	Dedicated Host Arguments

--host-group

預覽

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

屬性	值
Parameter group:	Dedicated Host Arguments

--ids

屬性	值
Parameter group:	Resource Id Arguments

--imds-access-control-profile-reference-id --imds-profile-id

指定 imds 的存取控制範本版本、資源 ID 資源 ID。

--imds-mode

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

屬性	值
接受的值:	Audit, Enforce

--key-incarnation-id

增加此屬性的值可讓使用者重設用來保護客體與主機之間通道的密鑰。

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

預覽

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

--name -n

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

屬性	值
Parameter group:	Resource Id Arguments

--no-wait

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

屬性	值
預設值:	False

--os-disk

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

--ppg

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

--priority

屬性	值
接受的值:	Low, Regular, Spot

--proxy-agent-mode

已被取代

選項 '--proxy-agent-mode' 已棄用，並將在未來版本中刪除。請改用『--wire-server-mode』。

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

屬性	值
接受的值:	Audit, Enforce

--remove

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

屬性	值
Parameter group:	Generic Update Arguments
預設值:	[]

--resource-group -g

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

屬性	值
Parameter group:	Resource Id Arguments

--security-type

屬性	值
接受的值:	ConfidentialVM, Standard, TrustedLaunch

--set

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

屬性	值
Parameter group:	Generic Update Arguments
預設值:	[]

--size

預覽

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

--subscription

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

屬性	值
Parameter group:	Resource Id Arguments

--ultra-ssd-enabled

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

屬性	值
接受的值:	false, true

--user-data

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

--v-cpus-available

指定可用的 vCPU 數目。

--v-cpus-per-core

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

--wire-server-access-control-profile-reference-id --wire-server-profile-id

指定Wire伺服器的存取控制配置檔版本資源ID。

--wire-server-mode

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

屬性	值
接受的值:	Audit, Enforce

--workspace

預覽

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

屬性	值
Parameter group:	Monitor Arguments

--write-accelerator

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

全域參數

--debug

提高日誌詳細程度以顯示所有調試日誌。

屬性	值
預設值:	False

--help -h

顯示此說明訊息並結束。

--only-show-errors

只顯示錯誤，隱藏警告。

屬性	值
預設值:	False

--output -o

Output format.

屬性	值
預設值:	json
接受的值:	json, jsonc, none, table, tsv, yaml, yamlc

--query

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

--verbose

增加記錄的詳細程度。針對完整偵錯記錄使用 --debug。

屬性	值
預設值:	False

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)

選擇性參數

The following parameters are optional, but depending on the context, one or more might become required for the command to execute successfully.

--created

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

屬性	值
Parameter group:	Wait Condition Arguments
預設值:	False

--custom

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

屬性	值
Parameter group:	Wait Condition Arguments

--deleted

等到刪除為止。

屬性	值
Parameter group:	Wait Condition Arguments
預設值:	False

--exists

等候資源存在。

屬性	值
Parameter group:	Wait Condition Arguments
預設值:	False

--ids

屬性	值
Parameter group:	Resource Id Arguments

--interval

輪詢間隔以秒為單位。

屬性	值
Parameter group:	Wait Condition Arguments
預設值:	30

--name -n

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

屬性	值
Parameter group:	Resource Id Arguments

--resource-group -g

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

屬性	值
Parameter group:	Resource Id Arguments

--subscription

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

屬性	值
Parameter group:	Resource Id Arguments

--timeout

以秒為單位的等候上限。

屬性	值
Parameter group:	Wait Condition Arguments
預設值:	3600

--updated

等到 provisioningState 更新為 'Succeeded'。

屬性	值
Parameter group:	Wait Condition Arguments
預設值:	False

全域參數

--debug

提高日誌詳細程度以顯示所有調試日誌。

屬性	值
預設值:	False

--help -h

顯示此說明訊息並結束。

--only-show-errors

只顯示錯誤，隱藏警告。

屬性	值
預設值:	False

--output -o

Output format.

屬性	值
預設值:	json
接受的值:	json, jsonc, none, table, tsv, yaml, yamlc

--query

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

--verbose

增加記錄的詳細程度。針對完整偵錯記錄使用 --debug。

屬性	值
預設值:	False

共用方式為

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