Microsoft.DevCenter 專案/集區

發行項
2025-05-14

Bicep 資源定義

專案/集區資源類型可以使用目標作業來部署：

資源群組 - 請參閱資源群組部署命令

如需每個 API 版本中已變更屬性的清單，請參閱變更記錄檔。

資源格式

若要建立 Microsoft.DevCenter/projects/pools 資源，請將下列 Bicep 新增至範本。

resource symbolicname 'Microsoft.DevCenter/projects/pools@2025-04-01-preview' = {
  parent: resourceSymbolicName
  location: 'string'
  name: 'string'
  properties: {
    activeHoursConfiguration: {
      autoStartEnableStatus: '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'
  }
}

屬性值

ActiveHoursConfiguration

名字	描述	價值
autoStartEnableStatus	啟用或停用開發方塊是否應在使用時間開始時自動啟動。	“已禁用” “已啟用”
defaultEndTimeHour	使用時段的預設結束時間	整數 (int)
defaultStartTimeHour	使用時間的預設開始時間。	整數 (int)
defaultTimeZone （預設時區）	使用時間的預設 IANA 時區識別碼。	字串
keepAwakeEnableStatus 保持喚醒啟用狀態	啟用或停用開發方塊是否應該在作用時間保持清醒。	“已禁用” “已啟用”

圖像引用

名字	描述	價值
識別碼	映射標識碼或映像版本標識碼。提供映像標識符時，將會使用其最新版本。	字串

Microsoft.DevCenter/projects/pools

名字	描述	價值
位置	資源所在的地理位置	字串（必要）
名字	資源名稱	字串約束：最小長度 = 3 最大長度 = 63 模式 = `^[a-zA-Z0-9][a-zA-Z0-9-_.]{2,62}$` （必要）
父母	在 Bicep 中，您可以指定子資源的父資源。只有在父資源外部宣告子資源時，才需要新增這個屬性。如需詳細資訊，請參閱父資源外部的子資源。	類型資源的符號名稱：專案
性能	集區屬性	PoolProperties （池屬性）
標籤	資源標籤	標記名稱和值的字典。請參閱範本中的標籤

PoolDevBox定義

名字	描述	價值
圖像引用	影像參考資訊。	圖像引用
SKU	從集區建立之開發方塊的 SKU。	SKU

PoolProperties （池屬性）

名字	描述	價值
activeHoursConfiguration	在此池中創建的 Dev Box 的使用時段設定設置。	ActiveHoursConfiguration
devBoxDefinition	從這個集區建立之機器的定義。如果 devBoxDefinitionType 是 Reference 或未提供，則會忽略。	PoolDevBox定義
devBoxDefinitionName	此集區父專案中的 Dev Box 定義名稱。如果 devBoxDefinitionType 為 Value，將會忽略。	字串
devBoxDefinitionType	指出集區是從現有的開發箱定義建立，還是直接提供集區。	'參考資料' “價值”
devBoxTunnelEnableStatus	指示是否為池啟用了Dev Box Tunnel。	“已禁用” “已啟用”
顯示名稱	集區的顯示名稱。	字串
許可類型	指定授權類型，指出呼叫端已取得即將建立之開發方塊的授權。	“Windows_Client”
localAdministrator （本地管理員）	指出此集區中的開發方塊擁有者是否新增為開發人員 Box 上的本機系統管理員。	“已禁用” “已啟用”
managedVirtualNetworkRegions	受控虛擬網路的區域（ManagedNetworkType 為 Managed 時需要）。	字串[]
networkConnectionName （網路連接名稱）	此集區父專案中的網路連線名稱	字串
singleSignOnStatus	指出是否在此集區中建立已啟用單一登錄的開發人員方塊。也需要在租用戶上啟用單一登錄。	“已禁用” “已啟用”
stopOnDisconnect	停止在此集區中建立之開發方塊的中斷聯機組態設定。	StopOnDisconnectConfiguration
stopOnNoConnect	停止在此集區中建立之開發方塊的聯機組態設定。	StopOnNoConnectConfiguration
virtualNetworkType （虛擬網络類型）	指出集區使用由 Microsoft 或客戶提供的網路所管理的虛擬網路。	“託管” “未託管”

SKU

名字	描述	價值
能力	如果 SKU 支援相應放大/縮小，則應該包含容量整數。如果資源無法相應放大/縮小，可能會省略此專案。	整數 (int)
家庭	如果服務有不同世代的硬體，針對相同的 SKU，則可以在這裡擷取。	字串
名字	SKU 的名稱。例如 P3。通常是字母+數位碼	字串（必要）
大小	SKU 大小。當名稱欄位是階層和其他一些值的組合時，這會是獨立程序代碼。	字串
層	如果服務有一個以上的層級，但 PUT 上不需要此欄位，則資源提供者必須實作此字段。	“基本” “免費” “高級” “標準”

StopOnDisconnectConfiguration

名字	描述	價值
gracePeriodMinutes	偵測到中斷連線之後，在停止開發方塊之前所要等候的指定時間。	整數 (int)
地位	啟用寬限期后，是否要在中斷連線時停止開發方塊的功能。	“已禁用” “已啟用”

StopOnNoConnectConfiguration

名字	描述	價值
gracePeriodMinutes	如果未建立任何連線，則會在停止開發方塊之前等候的指定時間。	整數 (int)
地位	啟用此功能在未連線到時停止啟動的開發方塊，一旦寬限期結束。	“已禁用” “已啟用”

TrackedResourceTags

名字	描述	價值

使用範例

Azure 快速入門範例

下列 Azure 快速入門範本包含用於部署此資源類型的 Bicep 範例。

Bicep 檔案	描述
設定開發箱服務	此範本會根據 Dev Box 快速入門指南（/azure/dev-box/quickstart-create-dev-box）建立所有 Dev Box 管理員資源。您可以檢視所有建立的資源，或直接移至 DevPortal.microsoft.com 來建立您的第一個開發方塊。
部署Dev Box服務	此範本提供了一種配置創建 Dev Box 所需的所有資源的方法。
使用內建映射部署 Dev Box Service	此範本提供使用內建映射部署Dev Box服務的方式。

ARM 樣本資源定義

專案/集區資源類型可以使用目標作業來部署：

資源群組 - 請參閱資源群組部署命令

如需每個 API 版本中已變更屬性的清單，請參閱變更記錄檔。

資源格式

若要建立 Microsoft.DevCenter/projects/pools 資源，請將下列 JSON 新增至範本。

{
  "type": "Microsoft.DevCenter/projects/pools",
  "apiVersion": "2025-04-01-preview",
  "name": "string",
  "location": "string",
  "properties": {
    "activeHoursConfiguration": {
      "autoStartEnableStatus": "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"
  }
}

屬性值

ActiveHoursConfiguration

名字	描述	價值
autoStartEnableStatus	啟用或停用開發方塊是否應在使用時間開始時自動啟動。	“已禁用” “已啟用”
defaultEndTimeHour	使用時段的預設結束時間	整數 (int)
defaultStartTimeHour	使用時間的預設開始時間。	整數 (int)
defaultTimeZone （預設時區）	使用時間的預設 IANA 時區識別碼。	字串
keepAwakeEnableStatus 保持喚醒啟用狀態	啟用或停用開發方塊是否應該在作用時間保持清醒。	“已禁用” “已啟用”

圖像引用

名字	描述	價值
識別碼	映射標識碼或映像版本標識碼。提供映像標識符時，將會使用其最新版本。	字串

Microsoft.DevCenter/projects/pools

名字	描述	價值
apiVersion	API 版本	“2025-04-01-預覽”
位置	資源所在的地理位置	字串（必要）
名字	資源名稱	字串約束：最小長度 = 3 最大長度 = 63 模式 = `^[a-zA-Z0-9][a-zA-Z0-9-_.]{2,62}$` （必要）
性能	集區屬性	PoolProperties （池屬性）
標籤	資源標籤	標記名稱和值的字典。請參閱範本中的標籤
類型	資源類型	“Microsoft.DevCenter/projects/pools”

PoolDevBox定義

名字	描述	價值
圖像引用	影像參考資訊。	圖像引用
SKU	從集區建立之開發方塊的 SKU。	SKU

PoolProperties （池屬性）

名字	描述	價值
activeHoursConfiguration	在此池中創建的 Dev Box 的使用時段設定設置。	ActiveHoursConfiguration
devBoxDefinition	從這個集區建立之機器的定義。如果 devBoxDefinitionType 是 Reference 或未提供，則會忽略。	PoolDevBox定義
devBoxDefinitionName	此集區父專案中的 Dev Box 定義名稱。如果 devBoxDefinitionType 為 Value，將會忽略。	字串
devBoxDefinitionType	指出集區是從現有的開發箱定義建立，還是直接提供集區。	'參考資料' “價值”
devBoxTunnelEnableStatus	指示是否為池啟用了Dev Box Tunnel。	“已禁用” “已啟用”
顯示名稱	集區的顯示名稱。	字串
許可類型	指定授權類型，指出呼叫端已取得即將建立之開發方塊的授權。	“Windows_Client”
localAdministrator （本地管理員）	指出此集區中的開發方塊擁有者是否新增為開發人員 Box 上的本機系統管理員。	“已禁用” “已啟用”
managedVirtualNetworkRegions	受控虛擬網路的區域（ManagedNetworkType 為 Managed 時需要）。	字串[]
networkConnectionName （網路連接名稱）	此集區父專案中的網路連線名稱	字串
singleSignOnStatus	指出是否在此集區中建立已啟用單一登錄的開發人員方塊。也需要在租用戶上啟用單一登錄。	“已禁用” “已啟用”
stopOnDisconnect	停止在此集區中建立之開發方塊的中斷聯機組態設定。	StopOnDisconnectConfiguration
stopOnNoConnect	停止在此集區中建立之開發方塊的聯機組態設定。	StopOnNoConnectConfiguration
virtualNetworkType （虛擬網络類型）	指出集區使用由 Microsoft 或客戶提供的網路所管理的虛擬網路。	“託管” “未託管”

SKU

名字	描述	價值
能力	如果 SKU 支援相應放大/縮小，則應該包含容量整數。如果資源無法相應放大/縮小，可能會省略此專案。	整數 (int)
家庭	如果服務有不同世代的硬體，針對相同的 SKU，則可以在這裡擷取。	字串
名字	SKU 的名稱。例如 P3。通常是字母+數位碼	字串（必要）
大小	SKU 大小。當名稱欄位是階層和其他一些值的組合時，這會是獨立程序代碼。	字串
層	如果服務有一個以上的層級，但 PUT 上不需要此欄位，則資源提供者必須實作此字段。	“基本” “免費” “高級” “標準”

StopOnDisconnectConfiguration

名字	描述	價值
gracePeriodMinutes	偵測到中斷連線之後，在停止開發方塊之前所要等候的指定時間。	整數 (int)
地位	啟用寬限期后，是否要在中斷連線時停止開發方塊的功能。	“已禁用” “已啟用”

StopOnNoConnectConfiguration

名字	描述	價值
gracePeriodMinutes	如果未建立任何連線，則會在停止開發方塊之前等候的指定時間。	整數 (int)
地位	啟用此功能在未連線到時停止啟動的開發方塊，一旦寬限期結束。	“已禁用” “已啟用”

TrackedResourceTags

名字	描述	價值

使用範例

Azure 快速入門範本

下列 Azure 快速入門範本部署此資源類型。

範本	描述
設定開發箱服務	此範本會根據 Dev Box 快速入門指南（/azure/dev-box/quickstart-create-dev-box）建立所有 Dev Box 管理員資源。您可以檢視所有建立的資源，或直接移至 DevPortal.microsoft.com 來建立您的第一個開發方塊。
部署Dev Box服務	此範本提供了一種配置創建 Dev Box 所需的所有資源的方法。
使用內建映射部署 Dev Box Service	此範本提供使用內建映射部署Dev Box服務的方式。

Terraform （AzAPI 提供者）資源定義

專案/集區資源類型可以使用目標作業來部署：

資源群組

如需每個 API 版本中已變更屬性的清單，請參閱變更記錄檔。

資源格式

若要建立 Microsoft.DevCenter/projects/pools 資源，請將下列 Terraform 新增至範本。

resource "azapi_resource" "symbolicname" {
  type = "Microsoft.DevCenter/projects/pools@2025-04-01-preview"
  name = "string"
  parent_id = "string"
  location = "string"
  tags = {
    {customized property} = "string"
  }
  body = {
    properties = {
      activeHoursConfiguration = {
        autoStartEnableStatus = "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"
    }
  }
}

屬性值

ActiveHoursConfiguration

名字	描述	價值
autoStartEnableStatus	啟用或停用開發方塊是否應在使用時間開始時自動啟動。	“已禁用” “已啟用”
defaultEndTimeHour	使用時段的預設結束時間	整數 (int)
defaultStartTimeHour	使用時間的預設開始時間。	整數 (int)
defaultTimeZone （預設時區）	使用時間的預設 IANA 時區識別碼。	字串
keepAwakeEnableStatus 保持喚醒啟用狀態	啟用或停用開發方塊是否應該在作用時間保持清醒。	“已禁用” “已啟用”

圖像引用

名字	描述	價值
識別碼	映射標識碼或映像版本標識碼。提供映像標識符時，將會使用其最新版本。	字串

Microsoft.DevCenter/projects/pools

名字	描述	價值
位置	資源所在的地理位置	字串（必要）
名字	資源名稱	字串約束：最小長度 = 3 最大長度 = 63 模式 = `^[a-zA-Z0-9][a-zA-Z0-9-_.]{2,62}$` （必要）
parent_id	此資源為父系之資源的標識碼。	類型的資源標識碼：專案
性能	集區屬性	PoolProperties （池屬性）
標籤	資源標籤	標記名稱和值的字典。
類型	資源類型	“Microsoft.DevCenter/projects/pools@2025-04-01-preview”

PoolDevBox定義

名字	描述	價值
圖像引用	影像參考資訊。	圖像引用
SKU	從集區建立之開發方塊的 SKU。	SKU

PoolProperties （池屬性）

名字	描述	價值
activeHoursConfiguration	在此池中創建的 Dev Box 的使用時段設定設置。	ActiveHoursConfiguration
devBoxDefinition	從這個集區建立之機器的定義。如果 devBoxDefinitionType 是 Reference 或未提供，則會忽略。	PoolDevBox定義
devBoxDefinitionName	此集區父專案中的 Dev Box 定義名稱。如果 devBoxDefinitionType 為 Value，將會忽略。	字串
devBoxDefinitionType	指出集區是從現有的開發箱定義建立，還是直接提供集區。	'參考資料' “價值”
devBoxTunnelEnableStatus	指示是否為池啟用了Dev Box Tunnel。	“已禁用” “已啟用”
顯示名稱	集區的顯示名稱。	字串
許可類型	指定授權類型，指出呼叫端已取得即將建立之開發方塊的授權。	“Windows_Client”
localAdministrator （本地管理員）	指出此集區中的開發方塊擁有者是否新增為開發人員 Box 上的本機系統管理員。	“已禁用” “已啟用”
managedVirtualNetworkRegions	受控虛擬網路的區域（ManagedNetworkType 為 Managed 時需要）。	字串[]
networkConnectionName （網路連接名稱）	此集區父專案中的網路連線名稱	字串
singleSignOnStatus	指出是否在此集區中建立已啟用單一登錄的開發人員方塊。也需要在租用戶上啟用單一登錄。	“已禁用” “已啟用”
stopOnDisconnect	停止在此集區中建立之開發方塊的中斷聯機組態設定。	StopOnDisconnectConfiguration
stopOnNoConnect	停止在此集區中建立之開發方塊的聯機組態設定。	StopOnNoConnectConfiguration
virtualNetworkType （虛擬網络類型）	指出集區使用由 Microsoft 或客戶提供的網路所管理的虛擬網路。	“託管” “未託管”

SKU

名字	描述	價值
能力	如果 SKU 支援相應放大/縮小，則應該包含容量整數。如果資源無法相應放大/縮小，可能會省略此專案。	整數 (int)
家庭	如果服務有不同世代的硬體，針對相同的 SKU，則可以在這裡擷取。	字串
名字	SKU 的名稱。例如 P3。通常是字母+數位碼	字串（必要）
大小	SKU 大小。當名稱欄位是階層和其他一些值的組合時，這會是獨立程序代碼。	字串
層	如果服務有一個以上的層級，但 PUT 上不需要此欄位，則資源提供者必須實作此字段。	“基本” “免費” “高級” “標準”

StopOnDisconnectConfiguration

名字	描述	價值
gracePeriodMinutes	偵測到中斷連線之後，在停止開發方塊之前所要等候的指定時間。	整數 (int)
地位	啟用寬限期后，是否要在中斷連線時停止開發方塊的功能。	“已禁用” “已啟用”

StopOnNoConnectConfiguration

名字	描述	價值
gracePeriodMinutes	如果未建立任何連線，則會在停止開發方塊之前等候的指定時間。	整數 (int)
地位	啟用此功能在未連線到時停止啟動的開發方塊，一旦寬限期結束。	“已禁用” “已啟用”

TrackedResourceTags

名字	描述	價值

共用方式為

Microsoft.DevCenter 專案/集區

Bicep 資源定義

資源格式

屬性值

ActiveHoursConfiguration

圖像引用

Microsoft.DevCenter/projects/pools

PoolDevBox定義

PoolProperties （池屬性）

SKU

StopOnDisconnectConfiguration

StopOnNoConnectConfiguration

TrackedResourceTags

使用範例

Azure 快速入門範例

ARM 樣本資源定義

資源格式

屬性值

ActiveHoursConfiguration

圖像引用

Microsoft.DevCenter/projects/pools

PoolDevBox定義

PoolProperties （池屬性）

SKU

StopOnDisconnectConfiguration

StopOnNoConnectConfiguration

TrackedResourceTags

使用範例

Azure 快速入門範本

Terraform （AzAPI 提供者） 資源定義

資源格式

屬性值

ActiveHoursConfiguration

圖像引用

Microsoft.DevCenter/projects/pools

PoolDevBox定義

PoolProperties （池屬性）

SKU

StopOnDisconnectConfiguration

StopOnNoConnectConfiguration

TrackedResourceTags

意見反應

其他資源

Terraform （AzAPI 提供者）資源定義