在 Azure DevTest Labs 中指定實驗室虛擬機器的資源群組

發行項
04/13/2023

根據預設，每當建立新的虛擬機器時，Azure DevTest Labs 就會建立新的資源群組。身為實驗室擁有者，您可以將實驗室虛擬機器設定在特定資源群組中建立。此功能可在下列情況中協助您：

透過訂用帳戶中的實驗室建立的資源群組較少。
讓您的實驗室在您所設定的一組固定資源群組內操作。
解決在 Azure 訂用帳戶內建立資源群組所需的限制和核准。
合併單一資源群組中的所有實驗室資源，以簡化對這些資源的追蹤，並套用原則在資源群組層級管理資源。

使用此功能，您可以使用指令碼為所有實驗室虛擬機器指定 Azure 訂用帳戶內全新或現有的資源群組。目前，Azure DevTest Labs 透過 API 支援此功能。

注意

當您在 DevTest Labs 中建立實驗室時，適用所有訂用帳戶限制。請將實驗室視為訂用帳戶中的任何其他資源。如果是資源群組，則限制為每個訂用帳戶 980 個資源群組。

使用 Azure 入口網站

請遵循下列步驟，為實驗室中建立的所有虛擬機器指定資源群組。

登入 Azure 入口網站。
選取左側導覽功能表上的 [所有服務]。
從清單中選取 [DevTest Labs]。
從實驗室清單中選取您的 [實驗室]。
在左側功能表上的 [設定] 區段中，選取 [組態和原則]。
在左側功能表上選取 [實驗室設定]。
選取 [所有虛擬機器都位於一個資源群組中]。
從下拉式清單中選取現有的資源群組，或選取 [新建]，輸入資源群組的 [名稱]，然後選取 [確定]。

使用 PowerShell

下列範例說明如何使用 PowerShell 指令碼，在新的資源群組中建立所有的實驗室虛擬機器。

[CmdletBinding()]
Param(
    $subId,
    $labRg,
    $labName,
    $vmRg
)

az login | out-null

az account set --subscription $subId | out-null

$rgId = "/subscriptions/"+$subId+"/resourceGroups/"+$vmRg

"Updating lab '$labName' with vm rg '$rgId'..."

az resource update -g $labRg -n $labName --resource-type "Microsoft.DevTestLab/labs" --api-version 2018-10-15-preview --set properties.vmCreationResourceGroupId=$rgId

"Done. New virtual machines will now be created in the resource group '$vmRg'."

使用下列命令叫用指令碼。 ResourceGroup.ps1 是包含上述指令碼的檔案：

.\ResourceGroup.ps1 -subId <subscriptionID> -labRg <labRGNAme> -labName <LanName> -vmRg <RGName>

使用 Azure Resource Manager 範本

如果您使用 Azure Resource Manager 範本建立實驗室，請在範本的實驗室屬性區段中使用 vmCreationResourceGroupId 屬性，如下列範例所示：

{
    "type": "microsoft.devtestlab/labs",
    "name": "[parameters('lab_name')]",
    "apiVersion": "2018-10-15-preview",
    "location": "eastus",
    "tags": {},
    "scale": null,
    "properties": {
        "vmCreationResourceGroupId": "/subscriptions/<SubscriptionID>/resourcegroups/<ResourceGroupName>",
        "labStorageType": "Premium",
        "premiumDataDisks": "Disabled",
        "provisioningState": "Succeeded",
        "uniqueIdentifier": "000000000f-0000-0000-0000-00000000000000"
    },
    "dependsOn": []
},

針對實驗室虛擬機器設定資源群組的 API

使用此 API 時，身為實驗室擁有者的您有下列選項：

為所有虛擬機器選擇實驗室的資源群組。
為所有虛擬機器選擇實驗室資源群組以外的現有資源群組。
為所有虛擬機器輸入新的資源群組名稱。
繼續使用現有的行為，也就是為實驗室中的每部虛擬機器建立資源群組。

此設定適用於實驗室中建立的新虛擬機器。在您實驗室中以自身資源組建立的較舊虛擬機器不受影響。在實驗室中建立的環境會繼續保留在自己的資源群組中。

如何使用此 API：

使用 API 版本 2018-10-15-preview。
如果您指定新的資源群組，請確定您在訂用帳戶中擁有對資源群組的寫入權限。如果您沒有寫入權限，在指定的資源群組中建立新的虛擬機器時會失敗。
在使用 API 時，請傳入完整的資源群組識別碼。例如： /subscriptions/<SubscriptionID>/resourceGroups/<ResourceGroupName> 。確定資源群組與實驗室位在相同的訂用帳戶中。

下一步

請參閱以下文章：

設定實驗室的原則

共用方式為