Definir configurações do pool

Selecione a instância do projeto do Centro de Desenvolvimento para o seu pool. (Se você não tiver uma, poderá criar uma instância do Centro de Desenvolvimento e uma instância de projeto do Centro de Desenvolvimento ao criar seu pool.)

A devCenterProjectResourceId propriedade especifica a instância de projeto do Centro de Desenvolvimento .

{
    "$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"
            }
        }
    ]
}

Você pode recuperar o devCenterProjectResourceId valor de uma instância do projeto do Dev Center no portal do Azure usando a Visão JSON na página de visão geral da sua instância do projeto Dev Center. Você também pode recuperá-lo usando a CLI do Azure para consultar a propriedade id do projeto.

No exemplo a seguir, o devCenterProjectResourceId valor é recuperado de uma instância de projeto do Centro de Desenvolvimento nomeada fabrikam-dev-center-project no fabrikam-managed-devops-pools grupo de recursos.

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

O devcenter-project-id parâmetro especifica a instância de projeto do Centro de Desenvolvimento ao criar ou atualizar um pool.

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

Você pode recuperar o devcenter-project-id para sua instância de projeto do Centro de Desenvolvimento no portal do Azure usando a Visualização em JSON na página de Visão Geral da instância de projeto do Centro de Desenvolvimento. Você também pode recuperá-lo usando a CLI do Azure para consultar a propriedade id do projeto.

No exemplo a seguir, devcenter-project-id é recuperado de uma instância de projeto do Centro de Desenvolvimento nomeada fabrikam-dev-center-project no fabrikam-managed-devops-pools grupo de recursos.

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

A devCenterProjectResourceId propriedade especifica a instância de projeto do Centro de Desenvolvimento .

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

Você pode recuperar o devCenterProjectResourceId para sua instância de projeto do Centro de Desenvolvimento no portal do Azure usando a Visualização em JSON na página de Visão Geral da instância de projeto do Centro de Desenvolvimento. Você também pode recuperá-lo usando a CLI do Azure para consultar a propriedade id do projeto.

No exemplo a seguir, devCenterProjectResourceId é recuperado de uma instância de projeto do Centro de Desenvolvimento nomeada fabrikam-dev-center-project no fabrikam-managed-devops-pools grupo de recursos.

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

Se você configurou o pool para uma única organização do Azure DevOps, poderá especificar a organização nas configurações do pool.

Se você configurou o pool para várias organizações, a configuração da organização do Azure DevOps não está presente nas configurações do pool. Para configurar seu pool para uso em várias organizações, acesse Configurações>Segurança e configure Usar pool em várias organizações.

Você pode configurar o valor da organização do Azure DevOps usando a organizations lista na organizationProfile seção.

No exemplo a seguir, um pool é configurado para todos os projetos em uma única organização, com um paralelismo de 4. Para obter um exemplo que mostra como configurar várias organizações, consulte Usar pool em várias organizações.

{
    "$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
                        }
                    ]
                }
            }
        }
    ]
}

Você pode configurar o valor da organização do Azure DevOps usando a lista organizations no parâmetro organization-profile.

No exemplo a seguir, um pool é configurado para todos os projetos em uma única organização, com um paralelismo de 4. Para obter um exemplo que mostra como configurar várias organizações, consulte Usar pool em várias organizações.

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

O exemplo a seguir mostra a lista organizations no arquivo organization-profile.json.

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

Você pode configurar o valor da organização do Azure DevOps usando a organizations lista na organizationProfile seção.

No exemplo a seguir, um pool é configurado para todos os projetos em uma única organização, com um paralelismo de 4.

Para obter um exemplo que mostra como configurar várias organizações, consulte Usar pool em várias organizações.

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

Você pode definir o valor máximo de agentes nas configurações do Pool para um pool existente e na guia Noções básicas ao criar um pool.

Você pode configurar o valor máximo de agentes usando a maximumConcurrency propriedade.

No exemplo a seguir, o valor máximo dos agentes é 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
            }
        }
    ]
}

Você pode configurar o valor máximo de agentes usando o maximum-concurrency parâmetro ao criar ou atualizar um pool.

No exemplo a seguir, o valor máximo dos agentes é 4.

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

Você pode configurar o valor máximo de agentes usando a maximumConcurrency propriedade.

No exemplo a seguir, o valor máximo dos agentes é 4.

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

Para exibir e selecionar um tamanho de máquina virtual Azure disponível em sua região de Azure, selecione até cinco tamanhos de SKU. Os tamanhos de agente (SKUs) com cotas disponíveis de Pools Gerenciados de DevOps são marcados como Disponíveis. Você pode solicitar mais cota para SKUs marcadas como Não Disponíveis. Depois que uma solicitação de cota para um SKU Não Disponível for aprovada, ela será marcada como Disponível. Saiba mais sobre cotas de Pools de DevOps Gerenciados.

Para reordenar os tamanhos do agente, arraste e solte-os usando a alça na ordem desejada. A ordem determina a prioridade para o provisionamento de agentes, sendo que o tamanho no topo da lista possui a prioridade mais alta.

Você pode configurar um único tamanho de agente usando a sku propriedade na fabricProfile seção. No exemplo a seguir, um tamanho de Standard_D2ads_v5 VM é especificado.

{
    "$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"
                    }
                }
            }
        }
    ]
}

Para usar combinação de instâncias, especifique Mix como valor de sku.name e forneça uma lista de tamanhos de VM em vmSizes. A ordem dos tamanhos de VM na lista define a prioridade para o provisionamento dos agentes.

{
  "$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": "Mix",
            "vmSizes": [
              {
                "name": "Standard_D2ads_v5"
              },
              {
                "name": "Standard_D2ds_v5"
              }
            ]
          }
        }
      }
    }
  ]
}

Você pode configurar o tamanho do agente usando a sku propriedade na fabricProfile seção ao criar ou atualizar um pool. No exemplo a seguir, um tamanho de Standard_D2ads_v5 VM é especificado.

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

O exemplo a seguir mostra a sku seção do fabric-profile.json arquivo.

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

Para configurar a combinação de instâncias para um pool existente, chame az resource update, especifique a versão 2026-06-02 da API ou posterior, defina sku.name como Mixe forneça os tamanhos da VM em sku.vmSizes. A ordem dos tamanhos da VM define a prioridade para os agentes de provisionamento.

az resource update \
  --ids "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.DevOpsInfrastructure/pools/{poolName}" \
  --api-version "2026-06-02" \
  --set properties.fabricProfile.sku='{"name":"Mix","vmSizes":[{"name":"Standard_D2ads_v5"},{"name":"Standard_D2ds_v5"}]}'

Você pode configurar um único tamanho de agente usando a sku propriedade na fabricProfile seção. No exemplo a seguir, um tamanho de Standard_D2ads_v5 VM é especificado.

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

Para usar combinação de instâncias, especifique Mix como valor de sku.name, e forneça uma lista de tamanhos de VM em vmSizes. A ordem dos tamanhos da VM na lista determina a prioridade para os agentes de provisionamento.

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

Você pode definir o tipo de disco do sistema operacional nas configurações do Pool para um pool existente. Você pode configurar o tipo de disco do sistema operacional na guia Noções básicas ao criar um pool.

Você pode configurar o tipo de disco do sistema operacional usando a osDiskStorageAccountType propriedade na storageProfile seção. Selecione Standard, StandardSSD ou Premium.

No exemplo a seguir, um tipo de disco do sistema operacional Standard é especificado:

{
    "$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"
                }
            }
        }
    ]
}

Você pode configurar o tipo de disco do sistema usando a osDiskStorageAccountType propriedade na seção storageProfile no parâmetro fabric-profile.

Selecione Standard, StandardSSD ou Premium. No exemplo a seguir, um tipo de disco do sistema operacional padrão é especificado.

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

O exemplo a seguir mostra a storageProfile seção do fabric-profile.json arquivo.

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

Você pode configurar o tipo de disco do sistema operacional usando a osDiskStorageAccountType propriedade na storageProfile seção.

Selecione Standard, StandardSSD ou Premium. No exemplo a seguir, um tipo de disco do sistema operacional padrão é especificado.

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