使用 Azure CLI 管理虛擬機器擴展集

發行項
06/14/2024

注意

本文件中所列的許多步驟適用於使用統一協調流程模式的虛擬機擴展集。我們建議針對新的工作負載使用彈性協調流程。如需詳細資訊，請參閱 Azure 中虛擬機器擴展集的協調流程模式。

在虛擬機器擴展集生命週期期間，您可能需要執行一或多個管理工作。此外，您可以建立指令碼來自動化各種生命週期工作。此文章詳述一些可讓您執行這些工作的一般 Azure CLI 命令。

若要完成這些管理工作，您需要最新的 Azure CLI。如需相關資訊，請參閱安裝 Azure CLI。如果您需要建立虛擬機器擴展集，可以使用 Azure CLI 建立擴展集。

檢視擴展集的相關資訊

若要檢視擴展集的整體資訊，請使用 az vmss show。下列範例取得 myResourceGroup 資源群組中 myScaleSet 擴展集的相關資訊。輸入您自己的名稱，如下所示：

az vmss show --resource-group myResourceGroup --name myScaleSet

檢視擴展集中的 VM

若要檢視擴展集中的 VM 執行個體清單，請使用 az vmss list-instances。下列範例列出 myResourceGroup 資源群組中，名稱為 myScaleSet 擴展集內的所有虛擬機器執行個體。針對這些名稱提供您自己的值：

az vmss list-instances \
    --resource-group myResourceGroup \
    --name myScaleSet \
    --output table

若要檢視特定 VM 執行個體的其他資訊，請將 --instance-id 參數新增至 az vmss get-instance-view，並指定要檢視的執行個體。下列範例檢視 myScaleSet 擴展集和 myResourceGroup 資源群組中 VM 執行個體 0 的相關資訊。輸入您自己的名稱，如下所示：

az vmss get-instance-view \
    --resource-group myResourceGroup \
    --name myScaleSet \
    --instance-id 0

您也可以在一個 API 呼叫中取得所有執行個體的詳細 instanceView 資訊，這有助於避免大型安裝的 API 節流。針對 --resource-group、--subscription 和 --name 提供您自己的值：

az vmss list-instances \
    --expand instanceView \
    --select instanceView \
    --resource-group <resourceGroupName> \
    --subscription <subID> \
    --name <vmssName>

GET "https://management.azure.com/subscriptions/<sub-id>/resourceGroups/<resourceGroupName>/providers/Microsoft.Compute/virtualMachineScaleSets/<VMSSName>/virtualMachines?api-version=2019-03-01&%24expand=instanceView"

列出 VM 的連線資訊

若要連線至擴展集中的 VM，您可以 SSH 或 RDP 到指派的公用 IP 位址和連接埠號碼。網路位址轉譯 (NAT) 規則預設會新增至 Azure 負載平衡器，以將遠端連線流量轉送給每部虛擬機器。若要列出連線至擴展集中 VM 執行個體的位址和連接埠，請使用 az vmss list-instance-connection-info。下列範例列出 myScaleSet 擴展集和 myResourceGroup 資源群組中虛擬機器執行個體的連線資訊。針對這些名稱提供您自己的值：

az vmss list-instance-connection-info \
    --resource-group myResourceGroup \
    --name myScaleSet

變更擴展集的容量

上述命令顯示您擴展集和 VM 執行個體的相關資訊。若要增加或減少擴展集中的執行個體數目，您可以變更容量。擴展集會建立或移除所需的 VM 數目，然後設定接收應用程式流量的 VM。

若要查看擴展集中目前擁有的執行個體數目，請使用 az vmss show並查詢 sku.capacity：

az vmss show \
    --resource-group myResourceGroup \
    --name myScaleSet \
    --query [sku.capacity] \
    --output table

然後，您可以使用 az vmss scale，手動增加或減少擴展集中的虛擬機器數目。下列範例會將擴展集中的 VM 數目設定為 5：

az vmss scale \
    --resource-group myResourceGroup \
    --name myScaleSet \
    --new-capacity 5

如果需要幾分鐘的時間才能更新您擴展集的容量。如果您減少擴展集的容量，則會先移除具有最高執行個體識別碼的 VM。

停止和啟動擴展集中的 VM

若要停止擴展集中的一或多個 VM，請使用 az vmss stop。 --instance-ids 參數可讓您指定停止一或多個 VM。如果您未指定執行個體識別碼，則會停止擴展集中的所有 VM。若要停止多個 VM，請以空格分隔每個執行個體識別碼。

下列範例停止 myScaleSet 擴展集和 myResourceGroup 資源群組中的執行個體 0。提供您自己的值，如下所示︰

az vmss stop --resource-group myResourceGroup --name myScaleSet --instance-ids 0

已停止的 VM 會維持配置，並繼續產生計算費用。如果您改為想要解除配置 VM，而且只要產生儲存體費用，請使用 az vmss deallocate。若要解除配置多個 VM，請以空格分隔每個執行個體識別碼。下列範例停止和解除配置 myScaleSet 擴展集和 myResourceGroup 資源群組中的執行個體 0。提供您自己的值，如下所示︰

az vmss deallocate --resource-group myResourceGroup --name myScaleSet --instance-ids 0

啟動擴展集中的 VM

若要啟動擴展集中的一或多個 VM，請使用 az vmss start。 --instance-ids 參數可讓您指定啟動一或多個 VM。如果您未指定執行個體識別碼，則會啟動擴展集中的所有 VM。若要啟動多個 VM，請以空格分隔每個執行個體識別碼。

下列範例啟動 myScaleSet 擴展集和 myResourceGroup 資源群組中的執行個體 0。提供您自己的值，如下所示︰

az vmss start --resource-group myResourceGroup --name myScaleSet --instance-ids 0

重新啟動擴展集中的 VM

若要重新啟動擴展集中的一或多個 VM，請使用 az vmss restart。 --instance-ids 參數可讓您指定重新啟動一或多個 VM。如果您未指定執行個體識別碼，則會重新啟動擴展集中的所有 VM。若要重新啟動多個 VM，請以空格分隔每個執行個體識別碼。

下列範例重新啟動 myScaleSet 擴展集和 myResourceGroup 資源群組中的執行個體 0。提供您自己的值，如下所示︰

az vmss restart --resource-group myResourceGroup --name myScaleSet --instance-ids 0

移除擴展集中的 VM

若要移除擴展集中的一或多個 VM，請使用 az vmss delete-instances。 --instance-ids 參數可讓您指定移除一或多個 VM。如果您指定 * 表示執行個體識別碼，則會移除擴展集中的所有 VM。若要移除多個 VM，請以空格分隔每個執行個體識別碼。

下列範例移除 myScaleSet 擴展集和 myResourceGroup 資源群組中的執行個體 0。提供您自己的值，如下所示︰

az vmss delete-instances --resource-group myResourceGroup --name myScaleSet --instance-ids 0

下一步

擴展集的其他一般工作包含如何部署應用程式以及升級 VM 執行個體。您也可以使用 Azure CLI 設定自動調整規則。

共用方式為