Compartilhar via

Projetos/pools do Microsoft.DevCenter

Definição de recurso do Bicep

O tipo de recurso de projetos/pools pode ser implantado com operações direcionadas:

Para obter uma lista de propriedades alteradas em cada versão da API, consulte de log de alterações.

Formato de recurso

Para criar um recurso Microsoft.DevCenter/projects/pools, adicione o Bicep a seguir ao seu modelo.

resource symbolicname 'Microsoft.DevCenter/projects/pools@2026-01-01-preview' = {
  parent: resourceSymbolicName
  location: 'string'
  name: 'string'
  properties: {
    activeHoursConfiguration: {
      autoStartEnableStatus: 'string'
      daysOfWeekLimit: int
      defaultDaysOfWeek: [
        'string'
      ]
      defaultEndTimeHour: int
      defaultStartTimeHour: int
      defaultTimeZone: 'string'
      keepAwakeEnableStatus: 'string'
    }
    devBoxDefinition: {
      imageReference: {
        id: 'string'
      }
      sku: {
        capacity: int
        family: 'string'
        name: 'string'
        size: 'string'
        tier: 'string'
      }
    }
    devBoxDefinitionName: 'string'
    devBoxDefinitionType: 'string'
    devBoxTunnelEnableStatus: 'string'
    displayName: 'string'
    licenseType: 'string'
    localAdministrator: 'string'
    managedVirtualNetworkRegions: [
      'string'
    ]
    networkConnectionName: 'string'
    singleSignOnStatus: 'string'
    stopOnDisconnect: {
      gracePeriodMinutes: int
      status: 'string'
    }
    stopOnNoConnect: {
      gracePeriodMinutes: int
      status: 'string'
    }
    virtualNetworkType: 'string'
  }
  tags: {
    {customized property}: 'string'
  }
}

Valores de propriedade

Microsoft.DevCenter/projects/pools

Name Description Value
local A localização geográfica onde o recurso reside cadeia de caracteres (obrigatório)
name O nome do recurso string

Constraints:
Comprimento mínimo = 3
Comprimento máximo = 63
Padrão = ^[a-zA-Z0-9][a-zA-Z0-9-_.]{2,62}$ (obrigatório)
pai No Bicep, você pode especificar o recurso pai para um recurso filho. Você só precisa adicionar essa propriedade quando o recurso filho é declarado fora do recurso pai.

Para obter mais informações, consulte recurso filho fora do recurso pai.		 Nome simbólico para o recurso do tipo: projetos
properties Propriedades do pool PoolProperties
tags Etiquetas de recursos Dicionário de nomes e valores de marca. Consulte Marcas em modelos

ActiveHoursConfiguration

Name Description Value
autoStartEnableStatus Habilita ou desabilita se a Caixa de Desenvolvimento deve ser iniciada automaticamente no início do horário ativo. 'Disabled'
'Enabled'
daysOfWeekLimit A quantidade máxima de dias por semana em que um usuário pode habilitar recursos relacionados ao horário ativo. int
defaultDaysOfWeek Os dias da semana em que os recursos de horas ativas serão habilitados. Isso serve como um padrão que pode ser atualizado por cada usuário individual. Matriz de cadeia de caracteres que contém qualquer um dos:
'Friday'
'Monday'
'Saturday'
'Sunday'
'Thursday'
'Tuesday'
'Wednesday'
defaultEndTimeHour A hora de término padrão das horas ativas. int
defaultStartTimeHour A hora de início padrão das horas ativas. int
defaultTimeZone A ID de fuso horário IANA padrão do horário ativo. cadeia
keepAwakeEnableStatus Habilita ou desabilita se a Caixa de Desenvolvimento deve ser mantida ativa durante o horário ativo. 'Disabled'
'Enabled'

ImageReference

Name Description Value
id ID da imagem ou ID da versão da imagem. Quando a ID da Imagem for fornecida, sua versão mais recente será usada. cadeia

PoolDevBoxDefinition

Name Description Value
imageReference Informações de referência de imagem. ImageReference
sku A SKU para Caixas de Desenvolvimento criadas a partir do Pool. Sku

PoolProperties

Name Description Value
activeHoursConfiguration Definições de configuração de horário ativo para Computadores de Desenvolvimento criados neste pool. ActiveHoursConfiguration
devBoxDefinition Uma definição dos computadores que são criados a partir desse pool. Será ignorado se devBoxDefinitionType for Referência ou não for fornecido. PoolDevBoxDefinition
devBoxDefinitionName Nome de uma definição de Caixa de Desenvolvimento no Projeto pai deste pool. Será ignorado se devBoxDefinitionType for Value. cadeia
devBoxDefinitionType Indica se o pool é criado a partir de uma Definição de Caixa de Desenvolvimento existente ou se um é fornecido diretamente. 'Reference'
'Value'
devBoxTunnelEnableStatus Indica se o Túnel do Computador de Desenvolvimento está habilitado para um pool. 'Disabled'
'Enabled'
displayName O nome de exibição do pool. cadeia
licenseType Especifica o tipo de licença que indica que o chamador já adquiriu licenças para as Caixas de Desenvolvimento que serão criadas. 'Windows_Client'
localAdministrator Indica se os proprietários das Caixas de Desenvolvimento nesse pool são adicionados como administradores locais na Caixa de Desenvolvimento. 'Disabled'
'Enabled'
managedVirtualNetworkRegions As regiões da rede virtual gerenciada (necessárias quando managedNetworkType é Gerenciado). string[]
networkConnectionName Nome de uma conexão de rede no projeto pai deste pool. cadeia
singleSignOnStatus Indica se as Caixas de Desenvolvimento nesse pool são criadas com logon único habilitado. Também exige que o logon único seja habilitado no locatário. 'Disabled'
'Enabled'
stopOnDisconnect Interrompa as configurações de desconexão das Caixas de Desenvolvimento criadas neste pool. StopOnDisconnectConfiguration
stopOnNoConnect Pare sem nenhuma configuração de conexão para Caixas de Desenvolvimento criadas neste pool. StopOnNoConnectConfiguration
virtualNetworkType Indica se o pool usa uma Rede Virtual gerenciada pela Microsoft ou uma rede fornecida pelo cliente. 'Managed'
'Unmanaged'

Sku

Name Description Value
capacidade Se o SKU der suporte a expansão/entrada, o inteiro de capacidade deverá ser incluído. Se a escala horizontal/in não for possível para o recurso, isso poderá ser omitido. int
family Se o serviço tiver diferentes gerações de hardware, para a mesma SKU, isso poderá ser capturado aqui. cadeia
name O nome da SKU. Por exemplo, P3. Normalmente, é um código letter+number cadeia de caracteres (obrigatório)
size O tamanho da SKU. Quando o campo de nome é a combinação de camada e algum outro valor, esse seria o código autônomo. cadeia
nível Esse campo deverá ser implementado pelo Provedor de Recursos se o serviço tiver mais de uma camada, mas não for necessário em um PUT. 'Basic'
'Free'
'Premium'
'Standard'

StopOnDisconnectConfiguration

Name Description Value
gracePeriodMinutes O tempo especificado em minutos para aguardar antes de parar uma Caixa de Desenvolvimento após a desconexão ser detectada. int
status Se o recurso para interromper a Caixa de Desenvolvimento ao desconectar depois que o período de carência tiver expirado está habilitado. 'Disabled'
'Enabled'

StopOnNoConnectConfiguration

Name Description Value
gracePeriodMinutes O tempo especificado em minutos para aguardar antes de parar uma Caixa de Desenvolvimento se nenhuma conexão for feita. int
status Permite que o recurso interrompa uma Caixa de Desenvolvimento iniciada quando ela não estiver conectada, depois que o período de carência tiver expirado. 'Disabled'
'Enabled'

TrackedResourceTags

Name Description Value

Exemplos de uso

Exemplos de Início Rápido do Azure

Os modelos de Início Rápido do Azure a seguir contêm exemplos de Bicep para implantar esse tipo de recurso.

Arquivo Bicep Description
configurar de serviço do Dev Box Esse modelo criaria todos os recursos de administrador do Dev Box de acordo com o guia de início rápido do Dev Box (/azure/dev-box/quickstart-create-dev-box). Você pode exibir todos os recursos criados ou ir diretamente para DevPortal.microsoft.com para criar sua primeira Caixa de Desenvolvimento.
Implantar o serviço de computador de desenvolvimento Este modelo fornece uma maneira de configurar todos os recursos necessários para criar um Computador de Desenvolvimento.
implantar o Serviço de Caixa de Desenvolvimento com de imagem interna Esse modelo fornece uma maneira de implantar um serviço Dev Box com imagem interna.

Definição de recurso de modelo do ARM

O tipo de recurso de projetos/pools pode ser implantado com operações direcionadas:

Para obter uma lista de propriedades alteradas em cada versão da API, consulte de log de alterações.

Formato de recurso

Para criar um recurso Microsoft.DevCenter/projects/pools, adicione o JSON a seguir ao seu modelo.

{
  "type": "Microsoft.DevCenter/projects/pools",
  "apiVersion": "2026-01-01-preview",
  "name": "string",
  "location": "string",
  "properties": {
    "activeHoursConfiguration": {
      "autoStartEnableStatus": "string",
      "daysOfWeekLimit": "int",
      "defaultDaysOfWeek": [ "string" ],
      "defaultEndTimeHour": "int",
      "defaultStartTimeHour": "int",
      "defaultTimeZone": "string",
      "keepAwakeEnableStatus": "string"
    },
    "devBoxDefinition": {
      "imageReference": {
        "id": "string"
      },
      "sku": {
        "capacity": "int",
        "family": "string",
        "name": "string",
        "size": "string",
        "tier": "string"
      }
    },
    "devBoxDefinitionName": "string",
    "devBoxDefinitionType": "string",
    "devBoxTunnelEnableStatus": "string",
    "displayName": "string",
    "licenseType": "string",
    "localAdministrator": "string",
    "managedVirtualNetworkRegions": [ "string" ],
    "networkConnectionName": "string",
    "singleSignOnStatus": "string",
    "stopOnDisconnect": {
      "gracePeriodMinutes": "int",
      "status": "string"
    },
    "stopOnNoConnect": {
      "gracePeriodMinutes": "int",
      "status": "string"
    },
    "virtualNetworkType": "string"
  },
  "tags": {
    "{customized property}": "string"
  }
}

Valores de propriedade

Microsoft.DevCenter/projects/pools

Name Description Value
apiVersion A versão da API 'Prévia 2026-01-01'
local A localização geográfica onde o recurso reside cadeia de caracteres (obrigatório)
name O nome do recurso string

Constraints:
Comprimento mínimo = 3
Comprimento máximo = 63
Padrão = ^[a-zA-Z0-9][a-zA-Z0-9-_.]{2,62}$ (obrigatório)
properties Propriedades do pool PoolProperties
tags Etiquetas de recursos Dicionário de nomes e valores de marca. Consulte Marcas em modelos
tipo O tipo de recurso 'Microsoft.DevCenter/projects/pools'

ActiveHoursConfiguration

Name Description Value
autoStartEnableStatus Habilita ou desabilita se a Caixa de Desenvolvimento deve ser iniciada automaticamente no início do horário ativo. 'Disabled'
'Enabled'
daysOfWeekLimit A quantidade máxima de dias por semana em que um usuário pode habilitar recursos relacionados ao horário ativo. int
defaultDaysOfWeek Os dias da semana em que os recursos de horas ativas serão habilitados. Isso serve como um padrão que pode ser atualizado por cada usuário individual. Matriz de cadeia de caracteres que contém qualquer um dos:
'Friday'
'Monday'
'Saturday'
'Sunday'
'Thursday'
'Tuesday'
'Wednesday'
defaultEndTimeHour A hora de término padrão das horas ativas. int
defaultStartTimeHour A hora de início padrão das horas ativas. int
defaultTimeZone A ID de fuso horário IANA padrão do horário ativo. cadeia
keepAwakeEnableStatus Habilita ou desabilita se a Caixa de Desenvolvimento deve ser mantida ativa durante o horário ativo. 'Disabled'
'Enabled'

ImageReference

Name Description Value
id ID da imagem ou ID da versão da imagem. Quando a ID da Imagem for fornecida, sua versão mais recente será usada. cadeia

PoolDevBoxDefinition

Name Description Value
imageReference Informações de referência de imagem. ImageReference
sku A SKU para Caixas de Desenvolvimento criadas a partir do Pool. Sku

PoolProperties

Name Description Value
activeHoursConfiguration Definições de configuração de horário ativo para Computadores de Desenvolvimento criados neste pool. ActiveHoursConfiguration
devBoxDefinition Uma definição dos computadores que são criados a partir desse pool. Será ignorado se devBoxDefinitionType for Referência ou não for fornecido. PoolDevBoxDefinition
devBoxDefinitionName Nome de uma definição de Caixa de Desenvolvimento no Projeto pai deste pool. Será ignorado se devBoxDefinitionType for Value. cadeia
devBoxDefinitionType Indica se o pool é criado a partir de uma Definição de Caixa de Desenvolvimento existente ou se um é fornecido diretamente. 'Reference'
'Value'
devBoxTunnelEnableStatus Indica se o Túnel do Computador de Desenvolvimento está habilitado para um pool. 'Disabled'
'Enabled'
displayName O nome de exibição do pool. cadeia
licenseType Especifica o tipo de licença que indica que o chamador já adquiriu licenças para as Caixas de Desenvolvimento que serão criadas. 'Windows_Client'
localAdministrator Indica se os proprietários das Caixas de Desenvolvimento nesse pool são adicionados como administradores locais na Caixa de Desenvolvimento. 'Disabled'
'Enabled'
managedVirtualNetworkRegions As regiões da rede virtual gerenciada (necessárias quando managedNetworkType é Gerenciado). string[]
networkConnectionName Nome de uma conexão de rede no projeto pai deste pool. cadeia
singleSignOnStatus Indica se as Caixas de Desenvolvimento nesse pool são criadas com logon único habilitado. Também exige que o logon único seja habilitado no locatário. 'Disabled'
'Enabled'
stopOnDisconnect Interrompa as configurações de desconexão das Caixas de Desenvolvimento criadas neste pool. StopOnDisconnectConfiguration
stopOnNoConnect Pare sem nenhuma configuração de conexão para Caixas de Desenvolvimento criadas neste pool. StopOnNoConnectConfiguration
virtualNetworkType Indica se o pool usa uma Rede Virtual gerenciada pela Microsoft ou uma rede fornecida pelo cliente. 'Managed'
'Unmanaged'

Sku

Name Description Value
capacidade Se o SKU der suporte a expansão/entrada, o inteiro de capacidade deverá ser incluído. Se a escala horizontal/in não for possível para o recurso, isso poderá ser omitido. int
family Se o serviço tiver diferentes gerações de hardware, para a mesma SKU, isso poderá ser capturado aqui. cadeia
name O nome da SKU. Por exemplo, P3. Normalmente, é um código letter+number cadeia de caracteres (obrigatório)
size O tamanho da SKU. Quando o campo de nome é a combinação de camada e algum outro valor, esse seria o código autônomo. cadeia
nível Esse campo deverá ser implementado pelo Provedor de Recursos se o serviço tiver mais de uma camada, mas não for necessário em um PUT. 'Basic'
'Free'
'Premium'
'Standard'

StopOnDisconnectConfiguration

Name Description Value
gracePeriodMinutes O tempo especificado em minutos para aguardar antes de parar uma Caixa de Desenvolvimento após a desconexão ser detectada. int
status Se o recurso para interromper a Caixa de Desenvolvimento ao desconectar depois que o período de carência tiver expirado está habilitado. 'Disabled'
'Enabled'

StopOnNoConnectConfiguration

Name Description Value
gracePeriodMinutes O tempo especificado em minutos para aguardar antes de parar uma Caixa de Desenvolvimento se nenhuma conexão for feita. int
status Permite que o recurso interrompa uma Caixa de Desenvolvimento iniciada quando ela não estiver conectada, depois que o período de carência tiver expirado. 'Disabled'
'Enabled'

TrackedResourceTags

Name Description Value

Exemplos de uso

Modelos de Início Rápido do Azure

Os modelos de Início Rápido do Azure a seguir implantar esse tipo de recurso.

Template Description
configurar de serviço do Dev Box

Implantar no Azure 		Esse modelo criaria todos os recursos de administrador do Dev Box de acordo com o guia de início rápido do Dev Box (/azure/dev-box/quickstart-create-dev-box). Você pode exibir todos os recursos criados ou ir diretamente para DevPortal.microsoft.com para criar sua primeira Caixa de Desenvolvimento.
Implantar o serviço de computador de desenvolvimento

Implantar no Azure 		Este modelo fornece uma maneira de configurar todos os recursos necessários para criar um Computador de Desenvolvimento.
implantar o Serviço de Caixa de Desenvolvimento com de imagem interna

Implantar no Azure 		Esse modelo fornece uma maneira de implantar um serviço Dev Box com imagem interna.

Definição de recurso do Terraform (provedor de AzAPI)

O tipo de recurso de projetos/pools pode ser implantado com operações direcionadas:

  • Grupos de recursos

Para obter uma lista de propriedades alteradas em cada versão da API, consulte de log de alterações.

Formato de recurso

Para criar um recurso Microsoft.DevCenter/projects/pools, adicione o Terraform a seguir ao seu modelo.

resource "azapi_resource" "symbolicname" {
  type = "Microsoft.DevCenter/projects/pools@2026-01-01-preview"
  name = "string"
  parent_id = "string"
  location = "string"
  tags = {
    {customized property} = "string"
  }
  body = {
    properties = {
      activeHoursConfiguration = {
        autoStartEnableStatus = "string"
        daysOfWeekLimit = int
        defaultDaysOfWeek = [
          "string"
        ]
        defaultEndTimeHour = int
        defaultStartTimeHour = int
        defaultTimeZone = "string"
        keepAwakeEnableStatus = "string"
      }
      devBoxDefinition = {
        imageReference = {
          id = "string"
        }
        sku = {
          capacity = int
          family = "string"
          name = "string"
          size = "string"
          tier = "string"
        }
      }
      devBoxDefinitionName = "string"
      devBoxDefinitionType = "string"
      devBoxTunnelEnableStatus = "string"
      displayName = "string"
      licenseType = "string"
      localAdministrator = "string"
      managedVirtualNetworkRegions = [
        "string"
      ]
      networkConnectionName = "string"
      singleSignOnStatus = "string"
      stopOnDisconnect = {
        gracePeriodMinutes = int
        status = "string"
      }
      stopOnNoConnect = {
        gracePeriodMinutes = int
        status = "string"
      }
      virtualNetworkType = "string"
    }
  }
}

Valores de propriedade

Microsoft.DevCenter/projects/pools

Name Description Value
local A localização geográfica onde o recurso reside cadeia de caracteres (obrigatório)
name O nome do recurso string

Constraints:
Comprimento mínimo = 3
Comprimento máximo = 63
Padrão = ^[a-zA-Z0-9][a-zA-Z0-9-_.]{2,62}$ (obrigatório)
parent_id A ID do recurso que é o pai desse recurso. ID do recurso do tipo: projetos
properties Propriedades do pool PoolProperties
tags Etiquetas de recursos Dicionário de nomes e valores de marca.
tipo O tipo de recurso "Microsoft.DevCenter/projects/pools@2026-01-01-preview"

ActiveHoursConfiguration

Name Description Value
autoStartEnableStatus Habilita ou desabilita se a Caixa de Desenvolvimento deve ser iniciada automaticamente no início do horário ativo. 'Disabled'
'Enabled'
daysOfWeekLimit A quantidade máxima de dias por semana em que um usuário pode habilitar recursos relacionados ao horário ativo. int
defaultDaysOfWeek Os dias da semana em que os recursos de horas ativas serão habilitados. Isso serve como um padrão que pode ser atualizado por cada usuário individual. Matriz de cadeia de caracteres que contém qualquer um dos:
'Friday'
'Monday'
'Saturday'
'Sunday'
'Thursday'
'Tuesday'
'Wednesday'
defaultEndTimeHour A hora de término padrão das horas ativas. int
defaultStartTimeHour A hora de início padrão das horas ativas. int
defaultTimeZone A ID de fuso horário IANA padrão do horário ativo. cadeia
keepAwakeEnableStatus Habilita ou desabilita se a Caixa de Desenvolvimento deve ser mantida ativa durante o horário ativo. 'Disabled'
'Enabled'

ImageReference

Name Description Value
id ID da imagem ou ID da versão da imagem. Quando a ID da Imagem for fornecida, sua versão mais recente será usada. cadeia

PoolDevBoxDefinition

Name Description Value
imageReference Informações de referência de imagem. ImageReference
sku A SKU para Caixas de Desenvolvimento criadas a partir do Pool. Sku

PoolProperties

Name Description Value
activeHoursConfiguration Definições de configuração de horário ativo para Computadores de Desenvolvimento criados neste pool. ActiveHoursConfiguration
devBoxDefinition Uma definição dos computadores que são criados a partir desse pool. Será ignorado se devBoxDefinitionType for Referência ou não for fornecido. PoolDevBoxDefinition
devBoxDefinitionName Nome de uma definição de Caixa de Desenvolvimento no Projeto pai deste pool. Será ignorado se devBoxDefinitionType for Value. cadeia
devBoxDefinitionType Indica se o pool é criado a partir de uma Definição de Caixa de Desenvolvimento existente ou se um é fornecido diretamente. 'Reference'
'Value'
devBoxTunnelEnableStatus Indica se o Túnel do Computador de Desenvolvimento está habilitado para um pool. 'Disabled'
'Enabled'
displayName O nome de exibição do pool. cadeia
licenseType Especifica o tipo de licença que indica que o chamador já adquiriu licenças para as Caixas de Desenvolvimento que serão criadas. 'Windows_Client'
localAdministrator Indica se os proprietários das Caixas de Desenvolvimento nesse pool são adicionados como administradores locais na Caixa de Desenvolvimento. 'Disabled'
'Enabled'
managedVirtualNetworkRegions As regiões da rede virtual gerenciada (necessárias quando managedNetworkType é Gerenciado). string[]
networkConnectionName Nome de uma conexão de rede no projeto pai deste pool. cadeia
singleSignOnStatus Indica se as Caixas de Desenvolvimento nesse pool são criadas com logon único habilitado. Também exige que o logon único seja habilitado no locatário. 'Disabled'
'Enabled'
stopOnDisconnect Interrompa as configurações de desconexão das Caixas de Desenvolvimento criadas neste pool. StopOnDisconnectConfiguration
stopOnNoConnect Pare sem nenhuma configuração de conexão para Caixas de Desenvolvimento criadas neste pool. StopOnNoConnectConfiguration
virtualNetworkType Indica se o pool usa uma Rede Virtual gerenciada pela Microsoft ou uma rede fornecida pelo cliente. 'Managed'
'Unmanaged'

Sku

Name Description Value
capacidade Se o SKU der suporte a expansão/entrada, o inteiro de capacidade deverá ser incluído. Se a escala horizontal/in não for possível para o recurso, isso poderá ser omitido. int
family Se o serviço tiver diferentes gerações de hardware, para a mesma SKU, isso poderá ser capturado aqui. cadeia
name O nome da SKU. Por exemplo, P3. Normalmente, é um código letter+number cadeia de caracteres (obrigatório)
size O tamanho da SKU. Quando o campo de nome é a combinação de camada e algum outro valor, esse seria o código autônomo. cadeia
nível Esse campo deverá ser implementado pelo Provedor de Recursos se o serviço tiver mais de uma camada, mas não for necessário em um PUT. 'Basic'
'Free'
'Premium'
'Standard'

StopOnDisconnectConfiguration

Name Description Value
gracePeriodMinutes O tempo especificado em minutos para aguardar antes de parar uma Caixa de Desenvolvimento após a desconexão ser detectada. int
status Se o recurso para interromper a Caixa de Desenvolvimento ao desconectar depois que o período de carência tiver expirado está habilitado. 'Disabled'
'Enabled'

StopOnNoConnectConfiguration

Name Description Value
gracePeriodMinutes O tempo especificado em minutos para aguardar antes de parar uma Caixa de Desenvolvimento se nenhuma conexão for feita. int
status Permite que o recurso interrompa uma Caixa de Desenvolvimento iniciada quando ela não estiver conectada, depois que o período de carência tiver expirado. 'Disabled'
'Enabled'

TrackedResourceTags

Name Description Value
  • Last updated on