設定集區設定

本文說明如何設定受控 DevOps 集區執行個體的基本設定。

概觀

若要檢視集區設定的概觀，請移至概觀。

從 「概觀」中，您可以：

檢視您的資源群組和訂用帳戶詳細資料，並將 Azure 資源移至新的資源群組或訂用帳戶。
查看您的泳池位置。若要檢視支援的位置，請遵循在 Azure 訂用帳戶中註冊受控 DevOps 集區資源提供者中的程序。
設定標籤。受管理 DevOps 集區最多可將 20 個標籤傳遞至虛擬機器（VM），其餘的會被忽略。
檢視集區的組態資訊，例如名稱、 Azure DevOps 組織、 代理程式狀態和 代理程式數目上限。
檢視預先定義的指標圖表。

集區設定

若要設定您的集區，請移至 [設定>集區]。

若要設定集區，請使用下列設定：

開發人員中心專案
Azure DevOps 組織
影像
代理程式數目上限
代理程式大小
OS 磁碟類型

開發人員中心專案

選取您的集區的 開發中心專案 實例。如果您還沒有，則可以在建立集區時建立 開發人員中心 和 開發人員中心專案 的執行個體。

顯示開發人員中心設定的螢幕擷取畫面。

屬性 devCenterProjectResourceId 會指定 開發人員中心專案 實例。

{
    "$schema": "https://schema.management.azure.com/schemas/2019-04-01/deploymentTemplate.json#",
    "contentVersion": "1.0.0.0",
    "resources": [
        {
            "name": "fabrikam-managed-pool",
            "type": "microsoft.devopsinfrastructure/pools",
            "location": "eastus",
            "tags": {},
            "properties": {
                ...
                "devCenterProjectResourceId": "/subscriptions/subscription_id_placeholder/resourceGroups/fabrikam-managed-devops-pools/providers/Microsoft.DevCenter/projects/fabrikam-dev-center-project"
            }
        }
    ]
}

您可以在 Azure 入口網站中，透過 開發人員中心專案 執行個體的概觀頁面的 JSON 檢視，擷取該 開發人員中心專案 執行個體的 devCenterProjectResourceId 值。您也可以使用 Azure CLI 查詢專案來擷取其 id 的屬性。

在下列範例中，devCenterProjectResourceId 值是從 fabrikam-managed-devops-pools 資源群組中的 fabrikam-dev-center-project開發人員中心專案 實例擷取而來。

 az devcenter admin project show --name fabrikam-dev-center-project --resource-group fabrikam-managed-devops-pools --query "id"

參數會在devcenter-project-id您建立或更新集區時指定開發人員中心專案實例。

az mdp pool create \
   --devcenter-project-id /subscriptions/aaaa0a0a-bb1b-cc2c-dd3d-eeeeee4e4e4e/resourceGroups/resourceGroupName/providers/Microsoft.DevCenter/projects/devCenterProjectName
   # other parameters omitted for space

您可以從 Azure 入口網站中的開發人員中心專案執行個體的 [概觀] 頁面使用 JSON 檢視，擷取該開發人員中心專案執行個體的devcenter-project-id。您也可以使用 Azure CLI 查詢專案，以擷取其 id 屬性。

在下列範例中，從fabrikam-managed-devops-pools資源群組中的開發人員中心專案fabrikam-dev-center-project實例擷取devcenter-project-id。

 az devcenter admin project show --name fabrikam-dev-center-project --resource-group fabrikam-managed-devops-pools --query "id"

屬性 devCenterProjectResourceId 會指定 開發人員中心專案 實例。

resource managedDevOpsPools 'Microsoft.DevOpsInfrastructure/pools@2025-09-20' = {
  name: 'fabrikam-managed-pool'
  location: 'eastus'
  properties: {
    ...
    devCenterProjectResourceId: '/subscriptions/subscription_id_placeholder/resourceGroups/fabrikam-managed-devops-pools/providers/Microsoft.DevCenter/projects/fabrikam-dev-center-project'
  }
}

您可以從 Azure 入口網站的概觀頁面上使用 JSON 檢視模式，擷取您的 Dev Center 專案 執行個體的 devCenterProjectResourceId。您也可以使用 Azure CLI 查詢專案的 id 屬性來擷取它。

在下列範例中，devCenterProjectResourceId 從資源群組中的fabrikam-dev-center-project實例被擷取。fabrikam-managed-devops-pools

 az devcenter admin project show --name fabrikam-dev-center-project --resource-group fabrikam-managed-devops-pools --query "id"

Azure DevOps 組織

如果您為單一 Azure DevOps 組織設定集區，您可以在集區設定中指定組織。

螢幕擷取畫面，顯示如何設定單一組織。

如果您為多個組織設定集區，則集區設定中不會存在 Azure DevOps 組織 設定。若要設定您的集區以用於多個組織，請移至 [設定>安全性]，然後設定在多個組織中使用集區。

您可以透過使用 organizations 區段中的清單來設定 Azure DevOps 組織 值。

在下列範例中，將為單一組織中的所有專案設定一個集區，並行度為 4。如需示範如何設定多個組織的範例，請參閱在多個組織中使用集區。

{
    "$schema": "https://schema.management.azure.com/schemas/2019-04-01/deploymentTemplate.json#",
    "contentVersion": "1.0.0.0",
    "resources": [
        {
            "name": "fabrikam-managed-pool",
            "type": "microsoft.devopsinfrastructure/pools",
            "apiVersion": "2025-09-20",
            "location": "eastus",
            "properties": {
                ...
                "organizationProfile": {
                    "organizations": [
                        {
                            "url": "https://dev.azure.com/fabrikam-tailspin",
                            "projects": [],
                            "parallelism": 4
                        }
                    ]
                }
            }
        }
    ]
}

您可以在參數中的organization-profile中使用organizations來設定 Azure DevOps 組織值。

在下列範例中，會為單一組織中的所有專案配置一個集區，並且平行度為 4。如需示範如何設定多個組織的範例，請參閱在多個組織中使用集區。

az mdp pool create \
   --organization-profile organization-profile.json
   # other parameters omitted for space

下列範例顯示 organizations organization-profile.json 檔案中的清單。

{
  "AzureDevOps": {
    "organizations": [
      {
        "url": "https://dev.azure.com/fabrikam-tailspin",
        "projects": [],
        "parallelism": 4
      }
    ],
    "permissionProfile": {...}
  }
}

您可以使用organizations清單來設定organizationProfile值，位於區段中。

在下列範例中，會針對單一組織中的所有專案設定資源池，並行度為 4。

如需示範如何設定多個組織的範例，請參閱在多個組織中使用集區。

resource managedDevOpsPools 'Microsoft.DevOpsInfrastructure/pools@2025-09-20' = {
  name: 'fabrikam-managed-pool'
  location: 'eastus'
  properties: {
    ...
    organizationProfile: {
      organizations: [
        {
          url: 'https://dev.azure.com/fabrikam-tailspin'
          projects: []
          parallelism: 4
        }
      ]
    }
  }
}

根據預設，您的集區可供指定組織中的所有專案使用。若要將集區限制為特定專案，請參閱安全性設定：設定組織存取權。

代理程式數目上限

指定集區中可同時配置的代理程式數目上限。例如，如果您指定最大 代理程式 值為 2，則可以同時執行最多兩個代理程式。如果兩個以上的工作排入佇列，則只有兩個代理程式執行工作，而其他工作則等待。

您可以使用 [代理程式 ] 窗格來檢視集區中已佈建代理程式的目前狀態和計數。「 代理程式」 檢視中的所有代理程式（狀態為 「已傳回」 的代理程式除外）都會在虛擬機器資源上執行，並計入 「代理程式數目上限」 計數。

您可以在現有集區的集區設定中設定代理程式數目上限值，並在建立集區時在基本設定標籤上設定代理程式數目上限值。

顯示客服專員數目上限設定的螢幕擷取畫面。

您可以使用maximumConcurrency來配置代理程式的最大數目值。

在下列範例中，代理 程式數目上限 值為 4。

{
    "$schema": "https://schema.management.azure.com/schemas/2019-04-01/deploymentTemplate.json#",
    "contentVersion": "1.0.0.0",
    "resources": [
        {
            "name": "fabrikam-managed-pool",
            "type": "microsoft.devopsinfrastructure/pools",
            "apiVersion": "2025-09-20",
            "location": "eastus",
            "properties": {
                ...
                "maximumConcurrency": 4
            }
        }
    ]
}

您可以在建立或maximum-concurrency集區時使用參數來設定代理程式數目上限值。

在下列範例中，代理 程式數目上限 值為 4。

az mdp pool create \
   --maximum-concurrency 4
   # other parameters omitted for space

您可以使用maximumConcurrency來配置代理程式的最大數目值。

在下列範例中，代理 程式數目上限 值為 4。

resource managedDevOpsPools 'Microsoft.DevOpsInfrastructure/pools@2025-09-20' = {
  name: 'fabrikam-managed-pool'
  location: 'eastus'
  properties: {
    ...
    maximumConcurrency: 4
  }
}

注意

代理 程式數目上限 值會設定可同時佈建的代理程式數目上限，但組織的自我託管平行工作計數會指定可同時執行的工作數目。請確定您組織中有足夠的自我裝載平行作業，讓您的代理程式能夠執行作業。如需詳細資訊，請參閱 Azure DevOps Services 平行作業定價。

代理程式大小

代理程式大小設定會指定要用來裝載受控 DevOps 集區代理程式的 Azure 虛擬機器大小。

顯示客服專員大小設定的螢幕擷取畫面。

若要檢視並選取 Azure 區域中可用的 Azure 虛擬機器大小，請選取 [ 變更大小]。具有受控 DevOps 集區配額的可用代理大小 SKU 會標記為可用。您可以為標示 為「無法使用」的 SKU 申請更多配額。核准針對不可用SKU的配額要求後，會標示為可用。深入瞭解管理式 DevOps 集區配額。

您可以在 fabricProfile 區段中使用 sku 屬性來設定代理程式大小。在下列範例中， Standard_D2ads_v5 會指定 VM 大小。

{
    "$schema": "https://schema.management.azure.com/schemas/2019-04-01/deploymentTemplate.json#",
    "contentVersion": "1.0.0.0",
    "resources": [
        {
            "name": "fabrikam-managed-pool",
            "type": "microsoft.devopsinfrastructure/pools",
            "apiVersion": "2025-09-20",
            "location": "eastus",
            "properties": {
                ...
                "fabricProfile": {
                    "sku": {
                        "name": "Standard_D2ads_v5"
                    }
                }
            }
        }
    ]
}

您可以在建立或更新集區時，使用sku屬性配置fabricProfile區段中的代理程式大小。在下列範例中， Standard_D2ads_v5 會指定 VM 大小。

az mdp pool create \
   --fabric-profile fabric-profile.json
   # other parameters omitted for space

下列範例顯示 sku 檔案的 fabric-profile.json 區段。

{
  "vmss": {
    "sku": {
      "name": "Standard_D2ads_v5"
    },
    "images": [...],
    "osProfile": {...},
    "storageProfile": {...}
  }
}

您可以使用 sku 屬性在 fabricProfile 區段中設定代理程式大小。在下列範例中， Standard_D2ads_v5 會指定 VM 大小。

resource managedDevOpsPools 'Microsoft.DevOpsInfrastructure/pools@2025-09-20' = {
  name: 'fabrikam-managed-pool'
  location: 'eastus'
  properties: {
    fabricProfile: {
      ...
      sku: {
        name: 'Standard_D2ads_v5'
      }
    }
  }
}

如果您的訂用帳戶沒有能力讓您依照您指定的 Azure VM SKU 和最大代理程式數量來配置您的集區，您會收到如下的錯誤訊息：

Cores needed to complete this request is 8, which exceeds the current limit of 0 for SKU family standardDDSv4Family in region eastus. Please choose a different region if possible, or request additional quota at https://portal.azure.com/#view/Microsoft_Azure_Support/NewSupportRequestV3Blade/issueType/quota/subscriptionId/subscription_id_placeholder/topicId/3eadc5d3-b59a-3658-d8c6-9c729ba35b97

若要解決此問題，請參閱檢閱受控 DevOps 集區配額。

並非所有 Azure 區域都支援所有 SKU。如果您收到類似 SKU family <sku-family> is not available in location <region>的錯誤，請確定您所在的區域支援您的 SKU 大小。如需其他詳細資訊，請參閱Azure 中的虛擬機器大小和各地區的產品供應狀況。

OS 磁碟類型

管理的 DevOps 集區為 OS 磁碟提供以下磁碟類型：

標準
標準 SSD
進階 SSD

預設OS磁碟類型為 Standard。如果您的工作負載輸送量超過標準層的層級，您可以升級至效能較高效能的磁碟類型，以提升工作負載的效能。如需磁碟類型和效能的詳細資訊，請參閱 Azure 受控磁碟類型。

您可以在現有集區的集區設定中設定 OS 磁碟類型。建立集區時，您可以在 [基本] 索引標籤上設定 OS 磁碟類型。

顯示 OS 磁碟類型設定的螢幕擷取畫面。

您可以使用區段中的屬性osDiskStorageAccountType來設定 storageProfile。選取 [標準]、[標準 SSD] 或 [進階]。

在下列範例中，會指定標準 OS 磁碟類型：

{
    "$schema": "https://schema.management.azure.com/schemas/2019-04-01/deploymentTemplate.json#",
    "contentVersion": "1.0.0.0",
    "resources": [
        {
            "name": "fabrikam-managed-pool",
            "type": "microsoft.devopsinfrastructure/pools",
            "apiVersion": "2025-09-20",
            "location": "eastus",
            "properties": {
                ...
                "storageProfile": {
                    "osDiskStorageAccountType": "Standard"
                }
            }
        }
    ]
}

您可以使用參數中區osDiskStorageAccountType段中的屬性來storageProfile設定 fabric-profile。

選取 [標準]、[標準 SSD] 或 [進階]。 在下列範例中， 會指定標準 OS 磁碟類型。

az mdp pool create \
   --fabric-profile fabric-profile.json
   # other parameters omitted for space

下列範例顯示 storageProfile 檔案的 fabric-profile.json 區段。

{
  "vmss": {
    "sku": {...},
    "images": [...],
    "osProfile": {...},
    "storageProfile": {
      "osDiskStorageAccountType": "Standard",
      "dataDisks": []
    }
  }
}

您可以使用區段中的屬性osDiskStorageAccountType來設定 storageProfile。

選取 [標準]、[標準 SSD] 或 [進階]。 在下列範例中， 會指定標準 OS 磁碟類型。

resource managedDevOpsPools 'Microsoft.DevOpsInfrastructure/pools@2025-09-20' = {
  name: 'fabrikam-managed-pool'
  location: 'eastus'
  properties: {
    fabricProfile: {
      ...
      storageProfile: {
        osDiskStorageAccountType: 'Standard'
      }
    }
  }
}

影像

受控 DevOps 集區提供數個 VM 映像選項，可用來在集區中執行管線。您可以使用選取的市集 VM 映像、Azure Compute Gallery 實例中您自己的自定義映像，或 Azure Pipelines Microsoft 裝載代理程式所使用的相同 Windows 和 Linux 映像來建立集區。

這很重要

下列影像將在受控 DevOps 集區中淘汰：

Azure Pipelines - Windows Server 2019
Ubuntu 20.04 的

如需詳細資訊，請參閱受控 DevOps 集區映像停用時間表。

顯示如何設定影像的螢幕擷取畫面。

您可以將集區設定為使用單一映像或多個映像。您也可以使用別名來設定管線以使用特定映像。如需詳細資訊，請參閱設定受控DevOps集區映像。

這很重要

如果您的集區中有多個映像，而且您未在管線中使用指令來指定映像，則管線會使用集區中第一個列出的映像來執行。您可以透過下列方式變更集區中影像的順序：

使用模板：更改fabricProfile部分中的images列表中圖像的順序。
使用拖曳：在 Azure 入口網站的影像清單中排序影像。

設定映像

意見反應

此頁面對您有幫助嗎？

Last updated on 2025-11-18

共用方式為

設定集區設定

概觀

集區設定

開發人員中心 專案

Azure DevOps 組織

代理程式數目上限

代理程式大小

OS 磁碟類型

影像

相關內容

意見反應

其他資源

開發人員中心專案