Progetti/pool Microsoft.DevCenter

Definizione di risorsa Bicep

Il tipo di risorsa progetti/pool può essere distribuito con operazioni destinate a:

  • gruppi di risorse - Vedere i comandi di distribuzione del gruppo di risorse

Per un elenco delle proprietà modificate in ogni versione dell'API, vedere log delle modifiche.

Esempi di utilizzo

Esempi di avvio rapido di Azure

I modelli di avvio rapido di Azure seguenti contengono esempi Bicep per la distribuzione di questo tipo di risorsa.

File bicipite Description
Configurare il servizio Dev Box Questo modello crea tutte le risorse di amministrazione di Dev Box in base alla guida introduttiva di Dev Box (/azure/dev-box/quickstart-create-dev-box). È possibile visualizzare tutte le risorse create oppure passare direttamente a DevPortal.microsoft.com per creare il primo Dev Box.
Distribuire il servizio Dev Box Questo modello consente di configurare tutte le risorse necessarie per creare una Dev Box.
Distribuire Dev Box Service con un'immagine predefinita Questo modello consente di distribuire un servizio Dev Box con un'immagine predefinita.

Formato risorsa

Per creare una risorsa Microsoft.DevCenter/projects/pools, aggiungere il bicep seguente al modello.

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

Valori delle proprietà

Microsoft.DevCenter/projects/pools

Name Description Value
location Posizione geografica in cui risiede la risorsa stringa (obbligatorio)
name Nome della risorsa string

Constraints:
Lunghezza minima = 3
Lunghezza massima = 63
Pattern = ^[a-zA-Z0-9][a-zA-Z0-9-_.]{2,62}$ (obbligatorio)
parent In Bicep è possibile specificare la risorsa padre per una risorsa figlio. È necessario aggiungere questa proprietà solo quando la risorsa figlio viene dichiarata all'esterno della risorsa padre.

Per altre informazioni, vedere risorsa figlio all'esterno della risorsa padre.		 Nome simbolico per la risorsa di tipo: progetti
properties Proprietà della piscina PoolProperties
tags Tag delle risorse Dizionario di nomi e valori di tag. Vedere tag nei modelli

ActiveHoursConfiguration

Name Description Value
autoStartEnableStatus Abilita o disabilita se Dev Box deve essere avviato automaticamente all'inizio dell'orario di attività. 'Disabled'
'Enabled'
daysOfWeekLimit Il numero massimo di giorni alla settimana in cui un utente può abilitare le funzionalità relative all'orario di attività. int
defaultDaysOfWeek I giorni della settimana in cui verranno attivate le funzioni dell'orario di attività. Questo serve come impostazione predefinita che può essere aggiornata da ogni singolo utente. Matrice di stringhe contenente uno dei seguenti elementi:
'Friday'
'Monday'
'Saturday'
'Sunday'
'Thursday'
'Tuesday'
'Wednesday'
defaultEndTimeHour L'ora di fine predefinita dell'orario di attività. int
defaultStartTimeHour Ora di inizio predefinita dell'orario di attività. int
defaultTimeZone ID fuso orario IANA predefinito dell'orario di attività. string
keepAwakeEnableStatus Abilita o disabilita se Dev Box deve essere mantenuto attivo durante l'orario di attività. 'Disabled'
'Enabled'

ImageReference

Name Description Value
id ID immagine o ID versione immagine. Quando viene specificato l'ID immagine, verrà usata la versione più recente. string

PoolDevBoxDefinition

Name Description Value
imageReference Informazioni di riferimento sulle immagini. ImageReference
sku SKU per Dev Boxes creato dal pool. Sku

PoolProperties

Name Description Value
activeHoursConfiguration Impostazioni di configurazione dell'orario di attività per le Dev Box create in questo pool. ActiveHoursConfiguration
devBoxDefinition Definizione dei computer creati da questo pool. Verrà ignorato se devBoxDefinitionType è Reference o non viene specificato. PoolDevBoxDefinition
devBoxDefinitionName Nome di una definizione di Dev Box nel progetto padre di questo pool. Verrà ignorato se devBoxDefinitionType è Value. string
devBoxDefinitionType Indica se il pool viene creato da una definizione di Dev Box esistente o se ne viene fornita direttamente una. 'Reference'
'Value'
devBoxTunnelEnableStatus Indica se Dev Box Tunnel è abilitato per un pool. 'Disabled'
'Enabled'
displayName Nome visualizzato del pool. string
licenseType Specifica il tipo di licenza che indica che il chiamante ha già acquisito le licenze per dev boxes che verranno create. 'Windows_Client'
localAdministrator Indica se i proprietari di Dev Boxes in questo pool vengono aggiunti come amministratori locali in Dev Box. 'Disabled'
'Enabled'
managedVirtualNetworkRegions Aree della rete virtuale gestita (obbligatoria quando managedNetworkType è gestito). string[]
networkConnectionName Nome di una connessione di rete nel progetto padre di questo pool. string
singleSignOnStatus Indica se Dev Boxes in questo pool vengono creati con l'accesso Single Sign-On abilitato. Richiede anche che l'accesso Single Sign-On sia abilitato nel tenant. 'Disabled'
'Enabled'
stopOnDisconnect Arresta in caso di disconnessione delle impostazioni di configurazione per Dev Boxes create in questo pool. StopOnDisconnectConfiguration
stopOnNoConnect Arresta senza impostazioni di configurazione di connessione per Dev Boxes creati in questo pool. StopOnNoConnectConfiguration
virtualNetworkType Indica se il pool usa una rete virtuale gestita da Microsoft o da una rete fornita dal cliente. 'Managed'
'Unmanaged'

Sku

Name Description Value
capacity Se lo SKU supporta l'aumento o l'aumento del numero di istanze, è necessario includere l'intero della capacità. Se non è possibile aumentare o ridurre il numero di istanze per la risorsa, potrebbe essere omesso. int
family Se il servizio ha generazioni diverse di hardware, per lo stesso SKU, è possibile acquisire qui. string
name Nome dello SKU. Ad esempio P3. Si tratta in genere di un codice lettera+numero stringa (obbligatorio)
size Dimensioni dello SKU. Quando il campo nome è la combinazione di livello e un altro valore, si tratta del codice autonomo. string
tier Questo campo deve essere implementato dal provider di risorse se il servizio ha più di un livello, ma non è necessario in un PUT. 'Basic'
'Free'
'Premium'
'Standard'

StopOnDisconnectConfiguration

Name Description Value
gracePeriodMinutes Tempo specificato in minuti di attesa prima di arrestare un Dev Box una volta rilevata la disconnessione. int
status Indica se la funzionalità per arrestare Dev Box alla disconnessione dopo che il periodo di tolleranza è scaduto. 'Disabled'
'Enabled'

StopOnNoConnectConfiguration

Name Description Value
gracePeriodMinutes Tempo specificato in minuti di attesa prima di arrestare dev Box se non viene stabilita alcuna connessione. int
status Consente alla funzionalità di arrestare un dev Box avviato quando non è stato connesso, una volta scaduto il periodo di tolleranza. 'Disabled'
'Enabled'

TrackedResourceTags

Name Description Value

Definizione di risorsa del modello di Resource Manager

Il tipo di risorsa progetti/pool può essere distribuito con operazioni destinate a:

Esempi di utilizzo

Modelli di avvio rapido di Azure

I modelli di avvio rapido di Azure seguenti distribuire questo tipo di risorsa.

Template Description
Configurare il servizio Dev Box

Distribuire in Azure 		Questo modello crea tutte le risorse di amministrazione di Dev Box in base alla guida introduttiva di Dev Box (/azure/dev-box/quickstart-create-dev-box). È possibile visualizzare tutte le risorse create oppure passare direttamente a DevPortal.microsoft.com per creare il primo Dev Box.
Distribuire il servizio Dev Box

Distribuire in Azure 		Questo modello consente di configurare tutte le risorse necessarie per creare una Dev Box.
Distribuire Dev Box Service con un'immagine predefinita

Distribuire in Azure 		Questo modello consente di distribuire un servizio Dev Box con un'immagine predefinita.

Formato risorsa

Per creare una risorsa Microsoft.DevCenter/projects/pools, aggiungere il codice JSON seguente al modello.

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

Valori delle proprietà

Microsoft.DevCenter/projects/pools

Name Description Value
apiVersion Versione dell'API 'anteprima 2026-01-01-preview'
location Posizione geografica in cui risiede la risorsa stringa (obbligatorio)
name Nome della risorsa string

Constraints:
Lunghezza minima = 3
Lunghezza massima = 63
Pattern = ^[a-zA-Z0-9][a-zA-Z0-9-_.]{2,62}$ (obbligatorio)
properties Proprietà della piscina PoolProperties
tags Tag delle risorse Dizionario di nomi e valori di tag. Vedere tag nei modelli
type Tipo di risorsa 'Microsoft.DevCenter/projects/pools'

ActiveHoursConfiguration

Name Description Value
autoStartEnableStatus Abilita o disabilita se Dev Box deve essere avviato automaticamente all'inizio dell'orario di attività. 'Disabled'
'Enabled'
daysOfWeekLimit Il numero massimo di giorni alla settimana in cui un utente può abilitare le funzionalità relative all'orario di attività. int
defaultDaysOfWeek I giorni della settimana in cui verranno attivate le funzioni dell'orario di attività. Questo serve come impostazione predefinita che può essere aggiornata da ogni singolo utente. Matrice di stringhe contenente uno dei seguenti elementi:
'Friday'
'Monday'
'Saturday'
'Sunday'
'Thursday'
'Tuesday'
'Wednesday'
defaultEndTimeHour L'ora di fine predefinita dell'orario di attività. int
defaultStartTimeHour Ora di inizio predefinita dell'orario di attività. int
defaultTimeZone ID fuso orario IANA predefinito dell'orario di attività. string
keepAwakeEnableStatus Abilita o disabilita se Dev Box deve essere mantenuto attivo durante l'orario di attività. 'Disabled'
'Enabled'

ImageReference

Name Description Value
id ID immagine o ID versione immagine. Quando viene specificato l'ID immagine, verrà usata la versione più recente. string

PoolDevBoxDefinition

Name Description Value
imageReference Informazioni di riferimento sulle immagini. ImageReference
sku SKU per Dev Boxes creato dal pool. Sku

PoolProperties

Name Description Value
activeHoursConfiguration Impostazioni di configurazione dell'orario di attività per le Dev Box create in questo pool. ActiveHoursConfiguration
devBoxDefinition Definizione dei computer creati da questo pool. Verrà ignorato se devBoxDefinitionType è Reference o non viene specificato. PoolDevBoxDefinition
devBoxDefinitionName Nome di una definizione di Dev Box nel progetto padre di questo pool. Verrà ignorato se devBoxDefinitionType è Value. string
devBoxDefinitionType Indica se il pool viene creato da una definizione di Dev Box esistente o se ne viene fornita direttamente una. 'Reference'
'Value'
devBoxTunnelEnableStatus Indica se Dev Box Tunnel è abilitato per un pool. 'Disabled'
'Enabled'
displayName Nome visualizzato del pool. string
licenseType Specifica il tipo di licenza che indica che il chiamante ha già acquisito le licenze per dev boxes che verranno create. 'Windows_Client'
localAdministrator Indica se i proprietari di Dev Boxes in questo pool vengono aggiunti come amministratori locali in Dev Box. 'Disabled'
'Enabled'
managedVirtualNetworkRegions Aree della rete virtuale gestita (obbligatoria quando managedNetworkType è gestito). string[]
networkConnectionName Nome di una connessione di rete nel progetto padre di questo pool. string
singleSignOnStatus Indica se Dev Boxes in questo pool vengono creati con l'accesso Single Sign-On abilitato. Richiede anche che l'accesso Single Sign-On sia abilitato nel tenant. 'Disabled'
'Enabled'
stopOnDisconnect Arresta in caso di disconnessione delle impostazioni di configurazione per Dev Boxes create in questo pool. StopOnDisconnectConfiguration
stopOnNoConnect Arresta senza impostazioni di configurazione di connessione per Dev Boxes creati in questo pool. StopOnNoConnectConfiguration
virtualNetworkType Indica se il pool usa una rete virtuale gestita da Microsoft o da una rete fornita dal cliente. 'Managed'
'Unmanaged'

Sku

Name Description Value
capacity Se lo SKU supporta l'aumento o l'aumento del numero di istanze, è necessario includere l'intero della capacità. Se non è possibile aumentare o ridurre il numero di istanze per la risorsa, potrebbe essere omesso. int
family Se il servizio ha generazioni diverse di hardware, per lo stesso SKU, è possibile acquisire qui. string
name Nome dello SKU. Ad esempio P3. Si tratta in genere di un codice lettera+numero stringa (obbligatorio)
size Dimensioni dello SKU. Quando il campo nome è la combinazione di livello e un altro valore, si tratta del codice autonomo. string
tier Questo campo deve essere implementato dal provider di risorse se il servizio ha più di un livello, ma non è necessario in un PUT. 'Basic'
'Free'
'Premium'
'Standard'

StopOnDisconnectConfiguration

Name Description Value
gracePeriodMinutes Tempo specificato in minuti di attesa prima di arrestare un Dev Box una volta rilevata la disconnessione. int
status Indica se la funzionalità per arrestare Dev Box alla disconnessione dopo che il periodo di tolleranza è scaduto. 'Disabled'
'Enabled'

StopOnNoConnectConfiguration

Name Description Value
gracePeriodMinutes Tempo specificato in minuti di attesa prima di arrestare dev Box se non viene stabilita alcuna connessione. int
status Consente alla funzionalità di arrestare un dev Box avviato quando non è stato connesso, una volta scaduto il periodo di tolleranza. 'Disabled'
'Enabled'

TrackedResourceTags

Name Description Value

Definizione di risorsa Terraform (provider AzAPI)

Il tipo di risorsa progetti/pool può essere distribuito con operazioni destinate a:

  • Gruppi di risorse Per un elenco delle proprietà modificate in ogni versione dell'API, vedi il registro modifiche.

Formato risorsa

Per creare una risorsa Microsoft.DevCenter/projects/pools, aggiungere il file Terraform seguente al modello.

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

Valori delle proprietà

Microsoft.DevCenter/projects/pools

Name Description Value
location Posizione geografica in cui risiede la risorsa stringa (obbligatorio)
name Nome della risorsa string

Constraints:
Lunghezza minima = 3
Lunghezza massima = 63
Pattern = ^[a-zA-Z0-9][a-zA-Z0-9-_.]{2,62}$ (obbligatorio)
parent_id ID della risorsa padre per questa risorsa. ID per la risorsa di tipo: progetti
properties Proprietà della piscina PoolProperties
tags Tag delle risorse Dizionario di nomi e valori di tag.
type Tipo di risorsa "Microsoft.DevCenter/projects/pools@2026-01-01-preview"

ActiveHoursConfiguration

Name Description Value
autoStartEnableStatus Abilita o disabilita se Dev Box deve essere avviato automaticamente all'inizio dell'orario di attività. 'Disabled'
'Enabled'
daysOfWeekLimit Il numero massimo di giorni alla settimana in cui un utente può abilitare le funzionalità relative all'orario di attività. int
defaultDaysOfWeek I giorni della settimana in cui verranno attivate le funzioni dell'orario di attività. Questo serve come impostazione predefinita che può essere aggiornata da ogni singolo utente. Matrice di stringhe contenente uno dei seguenti elementi:
'Friday'
'Monday'
'Saturday'
'Sunday'
'Thursday'
'Tuesday'
'Wednesday'
defaultEndTimeHour L'ora di fine predefinita dell'orario di attività. int
defaultStartTimeHour Ora di inizio predefinita dell'orario di attività. int
defaultTimeZone ID fuso orario IANA predefinito dell'orario di attività. string
keepAwakeEnableStatus Abilita o disabilita se Dev Box deve essere mantenuto attivo durante l'orario di attività. 'Disabled'
'Enabled'

ImageReference

Name Description Value
id ID immagine o ID versione immagine. Quando viene specificato l'ID immagine, verrà usata la versione più recente. string

PoolDevBoxDefinition

Name Description Value
imageReference Informazioni di riferimento sulle immagini. ImageReference
sku SKU per Dev Boxes creato dal pool. Sku

PoolProperties

Name Description Value
activeHoursConfiguration Impostazioni di configurazione dell'orario di attività per le Dev Box create in questo pool. ActiveHoursConfiguration
devBoxDefinition Definizione dei computer creati da questo pool. Verrà ignorato se devBoxDefinitionType è Reference o non viene specificato. PoolDevBoxDefinition
devBoxDefinitionName Nome di una definizione di Dev Box nel progetto padre di questo pool. Verrà ignorato se devBoxDefinitionType è Value. string
devBoxDefinitionType Indica se il pool viene creato da una definizione di Dev Box esistente o se ne viene fornita direttamente una. 'Reference'
'Value'
devBoxTunnelEnableStatus Indica se Dev Box Tunnel è abilitato per un pool. 'Disabled'
'Enabled'
displayName Nome visualizzato del pool. string
licenseType Specifica il tipo di licenza che indica che il chiamante ha già acquisito le licenze per dev boxes che verranno create. 'Windows_Client'
localAdministrator Indica se i proprietari di Dev Boxes in questo pool vengono aggiunti come amministratori locali in Dev Box. 'Disabled'
'Enabled'
managedVirtualNetworkRegions Aree della rete virtuale gestita (obbligatoria quando managedNetworkType è gestito). string[]
networkConnectionName Nome di una connessione di rete nel progetto padre di questo pool. string
singleSignOnStatus Indica se Dev Boxes in questo pool vengono creati con l'accesso Single Sign-On abilitato. Richiede anche che l'accesso Single Sign-On sia abilitato nel tenant. 'Disabled'
'Enabled'
stopOnDisconnect Arresta in caso di disconnessione delle impostazioni di configurazione per Dev Boxes create in questo pool. StopOnDisconnectConfiguration
stopOnNoConnect Arresta senza impostazioni di configurazione di connessione per Dev Boxes creati in questo pool. StopOnNoConnectConfiguration
virtualNetworkType Indica se il pool usa una rete virtuale gestita da Microsoft o da una rete fornita dal cliente. 'Managed'
'Unmanaged'

Sku

Name Description Value
capacity Se lo SKU supporta l'aumento o l'aumento del numero di istanze, è necessario includere l'intero della capacità. Se non è possibile aumentare o ridurre il numero di istanze per la risorsa, potrebbe essere omesso. int
family Se il servizio ha generazioni diverse di hardware, per lo stesso SKU, è possibile acquisire qui. string
name Nome dello SKU. Ad esempio P3. Si tratta in genere di un codice lettera+numero stringa (obbligatorio)
size Dimensioni dello SKU. Quando il campo nome è la combinazione di livello e un altro valore, si tratta del codice autonomo. string
tier Questo campo deve essere implementato dal provider di risorse se il servizio ha più di un livello, ma non è necessario in un PUT. 'Basic'
'Free'
'Premium'
'Standard'

StopOnDisconnectConfiguration

Name Description Value
gracePeriodMinutes Tempo specificato in minuti di attesa prima di arrestare un Dev Box una volta rilevata la disconnessione. int
status Indica se la funzionalità per arrestare Dev Box alla disconnessione dopo che il periodo di tolleranza è scaduto. 'Disabled'
'Enabled'

StopOnNoConnectConfiguration

Name Description Value
gracePeriodMinutes Tempo specificato in minuti di attesa prima di arrestare dev Box se non viene stabilita alcuna connessione. int
status Consente alla funzionalità di arrestare un dev Box avviato quando non è stato connesso, una volta scaduto il periodo di tolleranza. 'Disabled'
'Enabled'

TrackedResourceTags

Name Description Value
  • Last updated on