Freigeben über

Microsoft.DevCenter-Projekte/Pools 2025-02-01

Bicep-Ressourcendefinition

Der Ressourcentyp "Projekte/Pools" kann mit Vorgängen bereitgestellt werden, die auf Folgendes abzielen:

Eine Liste der geänderten Eigenschaften in jeder API-Version finden Sie unter Änderungsprotokoll.

Ressourcenformat

Um eine Microsoft.DevCenter/projects/pools-Ressource zu erstellen, fügen Sie Ihrer Vorlage die folgende Bicep hinzu.

resource symbolicname 'Microsoft.DevCenter/projects/pools@2025-02-01' = {
  parent: resourceSymbolicName
  location: 'string'
  name: 'string'
  properties: {
    devBoxDefinition: {
      imageReference: {
        id: 'string'
      }
      sku: {
        capacity: int
        family: 'string'
        name: 'string'
        size: 'string'
        tier: 'string'
      }
    }
    devBoxDefinitionName: 'string'
    devBoxDefinitionType: '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'
  }
}

Eigenschaftswerte

Microsoft.DevCenter/projects/pools

Name Description Value
location Der geografische Standort, an dem sich die Ressource befindet Zeichenfolge (erforderlich)
name Der Ressourcenname string

Constraints:
Min. Länge = 3
Max. Länge = 63
Pattern = ^[a-zA-Z0-9][a-zA-Z0-9-_.]{2,62}$ (erforderlich)
parent In Bicep können Sie die übergeordnete Ressource für eine untergeordnete Ressource angeben. Sie müssen diese Eigenschaft nur hinzufügen, wenn die untergeordnete Ressource außerhalb der übergeordneten Ressource deklariert wird.

Weitere Informationen finden Sie unter Untergeordnete Ressource außerhalb der übergeordneten Ressource.		 Symbolischer Name für Ressource des Typs: Projekte
properties Pool-Immobilien PoolProperties
tags Ressourcenetiketten Wörterbuch der Tagnamen und -werte. Siehe Tags in Vorlagen

ImageReference

Name Description Value
id Bild-ID oder Bildversions-ID. Wenn Bild-ID bereitgestellt wird, wird die neueste Version verwendet. string

PoolDevBoxDefinition

Name Description Value
imageReference Bildreferenzinformationen. ImageReference
sku Die SKU für Dev Boxes, die aus dem Pool erstellt wurden. Sku

PoolProperties

Name Description Value
devBoxDefinition Eine Definition der Computer, die aus diesem Pool erstellt werden. Wird ignoriert, wenn devBoxDefinitionType "Reference" ist oder nicht angegeben wird. PoolDevBoxDefinition
devBoxDefinitionName Name einer Dev Box-Definition im übergeordneten Projekt dieses Pools. Wird ignoriert, wenn devBoxDefinitionType "Value" ist. string
devBoxDefinitionType Gibt an, ob der Pool aus einer vorhandenen Dev Box-Definition erstellt oder direkt bereitgestellt wird. 'Reference'
'Value'
displayName Der Anzeigename des Pools. string
licenseType Gibt den Lizenztyp an, der angibt, dass der Aufrufer bereits Lizenzen für die Dev Boxes erworben hat, die erstellt werden. 'Windows_Client'
localAdministrator Gibt an, ob Besitzer von Dev Boxes in diesem Pool als lokale Administratoren im Dev Box hinzugefügt werden. 'Disabled'
'Enabled'
managedVirtualNetworkRegions Die Regionen des verwalteten virtuellen Netzwerks (erforderlich, wenn managedNetworkType verwaltet wird). string[]
networkConnectionName Name einer Netzwerkverbindung im übergeordneten Projekt dieses Pools string
singleSignOnStatus Gibt an, ob Dev Boxes in diesem Pool mit aktivierter Einmaligem Anmelden erstellt werden. Außerdem muss einmaliges Anmelden für den Mandanten aktiviert sein. 'Disabled'
'Enabled'
stopOnDisconnect Beenden Sie die Verbindung mit den Konfigurationseinstellungen für Dev Boxes, die in diesem Pool erstellt wurden. StopOnDisconnectConfiguration
stopOnNoConnect Beenden Sie keine Verbindungskonfigurationseinstellungen für Dev Boxes, die in diesem Pool erstellt wurden. StopOnNoConnectConfiguration
virtualNetworkType Gibt an, ob der Pool ein virtuelles Netzwerk verwendet, das von Microsoft oder einem vom Kunden bereitgestellten Netzwerk verwaltet wird. 'Managed'
'Unmanaged'

Sku

Name Description Value
capacity Wenn die SKU skalierungs-/in unterstützt, sollte die Ganze Kapazität eingeschlossen werden. Wenn eine Skalierung für die Ressource nicht möglich ist, wird dies möglicherweise weggelassen. int
family Wenn der Dienst über unterschiedliche Hardwaregenerationen verfügt, kann dies für dieselbe SKU hier erfasst werden. string
name Der Name der SKU. Z.B. P3. Es handelt sich in der Regel um einen Buchstaben+Zahlencode. Zeichenfolge (erforderlich)
size Die SKU-Größe. Wenn das Namensfeld die Kombination aus Ebene und einem anderen Wert ist, wäre dies der eigenständige Code. string
tier Dieses Feld muss vom Ressourcenanbieter implementiert werden, wenn der Dienst mehr als eine Ebene aufweist, für einen PUT jedoch nicht erforderlich ist. 'Basic'
'Free'
'Premium'
'Standard'

StopOnDisconnectConfiguration

Name Description Value
gracePeriodMinutes Die angegebene Zeit in Minuten, um zu warten, bevor ein Dev Box beendet wird, sobald die Verbindung erkannt wurde. int
status Gibt an, ob das Feature das Dev Box beim Trennen beenden soll, sobald die Nachfrist abgelaufen ist. 'Disabled'
'Enabled'

StopOnNoConnectConfiguration

Name Description Value
gracePeriodMinutes Die angegebene Zeit in Minuten, um zu warten, bevor ein Dev Box beendet wird, wenn keine Verbindung hergestellt wird. int
status Ermöglicht es dem Feature, ein gestartetes Dev Box zu beenden, wenn es nicht verbunden ist, sobald die Nachfrist abgelaufen ist. 'Disabled'
'Enabled'

TrackedResourceTags

Name Description Value

Verwendungsbeispiele

Azure-Schnellstartbeispiele

Die folgenden Azure-Schnellstartvorlagen Bicep-Beispiele für die Bereitstellung dieses Ressourcentyps enthalten.

Bicep-Datei Description
Konfigurieren des Dev Box-Diensts Diese Vorlage würde alle Dev Box-Administratorressourcen gemäß dev Box-Schnellstarthandbuch (/azure/dev-box/quickstart-create-dev-box) erstellen. Sie können alle erstellten Ressourcen anzeigen oder direkt zu DevPortal.microsoft.com wechseln, um Ihr erstes Dev Box zu erstellen.
Bereitstellen des Dev Box-Diensts Diese Vorlage bietet eine Möglichkeit, alle Ressourcen zu konfigurieren, die zum Erstellen einer Dev Box erforderlich sind.
Bereitstellen von Dev Box Service mit integriertem Image- Diese Vorlage bietet eine Möglichkeit, einen Dev Box-Dienst mit integriertem Image bereitzustellen.

ARM-Vorlagenressourcendefinition

Der Ressourcentyp "Projekte/Pools" kann mit Vorgängen bereitgestellt werden, die auf Folgendes abzielen:

Eine Liste der geänderten Eigenschaften in jeder API-Version finden Sie unter Änderungsprotokoll.

Ressourcenformat

Um eine Microsoft.DevCenter/projects/pools-Ressource zu erstellen, fügen Sie der Vorlage den folgenden JSON-Code hinzu.

{
  "type": "Microsoft.DevCenter/projects/pools",
  "apiVersion": "2025-02-01",
  "name": "string",
  "location": "string",
  "properties": {
    "devBoxDefinition": {
      "imageReference": {
        "id": "string"
      },
      "sku": {
        "capacity": "int",
        "family": "string",
        "name": "string",
        "size": "string",
        "tier": "string"
      }
    },
    "devBoxDefinitionName": "string",
    "devBoxDefinitionType": "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"
  }
}

Eigenschaftswerte

Microsoft.DevCenter/projects/pools

Name Description Value
apiVersion Die API-Version '2025-02-01'
location Der geografische Standort, an dem sich die Ressource befindet Zeichenfolge (erforderlich)
name Der Ressourcenname string

Constraints:
Min. Länge = 3
Max. Länge = 63
Pattern = ^[a-zA-Z0-9][a-zA-Z0-9-_.]{2,62}$ (erforderlich)
properties Pool-Immobilien PoolProperties
tags Ressourcenetiketten Wörterbuch der Tagnamen und -werte. Siehe Tags in Vorlagen
type Der Ressourcentyp 'Microsoft.DevCenter/projects/pools'

ImageReference

Name Description Value
id Bild-ID oder Bildversions-ID. Wenn Bild-ID bereitgestellt wird, wird die neueste Version verwendet. string

PoolDevBoxDefinition

Name Description Value
imageReference Bildreferenzinformationen. ImageReference
sku Die SKU für Dev Boxes, die aus dem Pool erstellt wurden. Sku

PoolProperties

Name Description Value
devBoxDefinition Eine Definition der Computer, die aus diesem Pool erstellt werden. Wird ignoriert, wenn devBoxDefinitionType "Reference" ist oder nicht angegeben wird. PoolDevBoxDefinition
devBoxDefinitionName Name einer Dev Box-Definition im übergeordneten Projekt dieses Pools. Wird ignoriert, wenn devBoxDefinitionType "Value" ist. string
devBoxDefinitionType Gibt an, ob der Pool aus einer vorhandenen Dev Box-Definition erstellt oder direkt bereitgestellt wird. 'Reference'
'Value'
displayName Der Anzeigename des Pools. string
licenseType Gibt den Lizenztyp an, der angibt, dass der Aufrufer bereits Lizenzen für die Dev Boxes erworben hat, die erstellt werden. 'Windows_Client'
localAdministrator Gibt an, ob Besitzer von Dev Boxes in diesem Pool als lokale Administratoren im Dev Box hinzugefügt werden. 'Disabled'
'Enabled'
managedVirtualNetworkRegions Die Regionen des verwalteten virtuellen Netzwerks (erforderlich, wenn managedNetworkType verwaltet wird). string[]
networkConnectionName Name einer Netzwerkverbindung im übergeordneten Projekt dieses Pools string
singleSignOnStatus Gibt an, ob Dev Boxes in diesem Pool mit aktivierter Einmaligem Anmelden erstellt werden. Außerdem muss einmaliges Anmelden für den Mandanten aktiviert sein. 'Disabled'
'Enabled'
stopOnDisconnect Beenden Sie die Verbindung mit den Konfigurationseinstellungen für Dev Boxes, die in diesem Pool erstellt wurden. StopOnDisconnectConfiguration
stopOnNoConnect Beenden Sie keine Verbindungskonfigurationseinstellungen für Dev Boxes, die in diesem Pool erstellt wurden. StopOnNoConnectConfiguration
virtualNetworkType Gibt an, ob der Pool ein virtuelles Netzwerk verwendet, das von Microsoft oder einem vom Kunden bereitgestellten Netzwerk verwaltet wird. 'Managed'
'Unmanaged'

Sku

Name Description Value
capacity Wenn die SKU skalierungs-/in unterstützt, sollte die Ganze Kapazität eingeschlossen werden. Wenn eine Skalierung für die Ressource nicht möglich ist, wird dies möglicherweise weggelassen. int
family Wenn der Dienst über unterschiedliche Hardwaregenerationen verfügt, kann dies für dieselbe SKU hier erfasst werden. string
name Der Name der SKU. Z.B. P3. Es handelt sich in der Regel um einen Buchstaben+Zahlencode. Zeichenfolge (erforderlich)
size Die SKU-Größe. Wenn das Namensfeld die Kombination aus Ebene und einem anderen Wert ist, wäre dies der eigenständige Code. string
tier Dieses Feld muss vom Ressourcenanbieter implementiert werden, wenn der Dienst mehr als eine Ebene aufweist, für einen PUT jedoch nicht erforderlich ist. 'Basic'
'Free'
'Premium'
'Standard'

StopOnDisconnectConfiguration

Name Description Value
gracePeriodMinutes Die angegebene Zeit in Minuten, um zu warten, bevor ein Dev Box beendet wird, sobald die Verbindung erkannt wurde. int
status Gibt an, ob das Feature das Dev Box beim Trennen beenden soll, sobald die Nachfrist abgelaufen ist. 'Disabled'
'Enabled'

StopOnNoConnectConfiguration

Name Description Value
gracePeriodMinutes Die angegebene Zeit in Minuten, um zu warten, bevor ein Dev Box beendet wird, wenn keine Verbindung hergestellt wird. int
status Ermöglicht es dem Feature, ein gestartetes Dev Box zu beenden, wenn es nicht verbunden ist, sobald die Nachfrist abgelaufen ist. 'Disabled'
'Enabled'

TrackedResourceTags

Name Description Value

Verwendungsbeispiele

Azure-Schnellstartvorlagen

Die folgenden Azure-Schnellstartvorlagen diesen Ressourcentyp bereitstellen.

Template Description
Konfigurieren des Dev Box-Diensts

Bereitstellen in Azure 		Diese Vorlage würde alle Dev Box-Administratorressourcen gemäß dev Box-Schnellstarthandbuch (/azure/dev-box/quickstart-create-dev-box) erstellen. Sie können alle erstellten Ressourcen anzeigen oder direkt zu DevPortal.microsoft.com wechseln, um Ihr erstes Dev Box zu erstellen.
Bereitstellen des Dev Box-Diensts

Bereitstellen in Azure 		Diese Vorlage bietet eine Möglichkeit, alle Ressourcen zu konfigurieren, die zum Erstellen einer Dev Box erforderlich sind.
Bereitstellen von Dev Box Service mit integriertem Image-

Bereitstellen in Azure 		Diese Vorlage bietet eine Möglichkeit, einen Dev Box-Dienst mit integriertem Image bereitzustellen.

Terraform -Ressourcendefinition (AzAPI-Anbieter)

Der Ressourcentyp "Projekte/Pools" kann mit Vorgängen bereitgestellt werden, die auf Folgendes abzielen:

Eine Liste der geänderten Eigenschaften in jeder API-Version finden Sie unter Änderungsprotokoll.

Ressourcenformat

Um eine Microsoft.DevCenter/projects/pools-Ressource zu erstellen, fügen Sie Ihrer Vorlage die folgende Terraform hinzu.

resource "azapi_resource" "symbolicname" {
  type = "Microsoft.DevCenter/projects/pools@2025-02-01"
  name = "string"
  parent_id = "string"
  location = "string"
  tags = {
    {customized property} = "string"
  }
  body = {
    properties = {
      devBoxDefinition = {
        imageReference = {
          id = "string"
        }
        sku = {
          capacity = int
          family = "string"
          name = "string"
          size = "string"
          tier = "string"
        }
      }
      devBoxDefinitionName = "string"
      devBoxDefinitionType = "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"
    }
  }
}

Eigenschaftswerte

Microsoft.DevCenter/projects/pools

Name Description Value
location Der geografische Standort, an dem sich die Ressource befindet Zeichenfolge (erforderlich)
name Der Ressourcenname string

Constraints:
Min. Länge = 3
Max. Länge = 63
Pattern = ^[a-zA-Z0-9][a-zA-Z0-9-_.]{2,62}$ (erforderlich)
parent_id Die ID der Ressource, die das übergeordnete Element für diese Ressource ist. ID für Ressource vom Typ: Projekte
properties Pool-Immobilien PoolProperties
tags Ressourcenetiketten Wörterbuch der Tagnamen und -werte.
type Der Ressourcentyp "Microsoft.DevCenter/projects/pools@2025-02-01"

ImageReference

Name Description Value
id Bild-ID oder Bildversions-ID. Wenn Bild-ID bereitgestellt wird, wird die neueste Version verwendet. string

PoolDevBoxDefinition

Name Description Value
imageReference Bildreferenzinformationen. ImageReference
sku Die SKU für Dev Boxes, die aus dem Pool erstellt wurden. Sku

PoolProperties

Name Description Value
devBoxDefinition Eine Definition der Computer, die aus diesem Pool erstellt werden. Wird ignoriert, wenn devBoxDefinitionType "Reference" ist oder nicht angegeben wird. PoolDevBoxDefinition
devBoxDefinitionName Name einer Dev Box-Definition im übergeordneten Projekt dieses Pools. Wird ignoriert, wenn devBoxDefinitionType "Value" ist. string
devBoxDefinitionType Gibt an, ob der Pool aus einer vorhandenen Dev Box-Definition erstellt oder direkt bereitgestellt wird. 'Reference'
'Value'
displayName Der Anzeigename des Pools. string
licenseType Gibt den Lizenztyp an, der angibt, dass der Aufrufer bereits Lizenzen für die Dev Boxes erworben hat, die erstellt werden. 'Windows_Client'
localAdministrator Gibt an, ob Besitzer von Dev Boxes in diesem Pool als lokale Administratoren im Dev Box hinzugefügt werden. 'Disabled'
'Enabled'
managedVirtualNetworkRegions Die Regionen des verwalteten virtuellen Netzwerks (erforderlich, wenn managedNetworkType verwaltet wird). string[]
networkConnectionName Name einer Netzwerkverbindung im übergeordneten Projekt dieses Pools string
singleSignOnStatus Gibt an, ob Dev Boxes in diesem Pool mit aktivierter Einmaligem Anmelden erstellt werden. Außerdem muss einmaliges Anmelden für den Mandanten aktiviert sein. 'Disabled'
'Enabled'
stopOnDisconnect Beenden Sie die Verbindung mit den Konfigurationseinstellungen für Dev Boxes, die in diesem Pool erstellt wurden. StopOnDisconnectConfiguration
stopOnNoConnect Beenden Sie keine Verbindungskonfigurationseinstellungen für Dev Boxes, die in diesem Pool erstellt wurden. StopOnNoConnectConfiguration
virtualNetworkType Gibt an, ob der Pool ein virtuelles Netzwerk verwendet, das von Microsoft oder einem vom Kunden bereitgestellten Netzwerk verwaltet wird. 'Managed'
'Unmanaged'

Sku

Name Description Value
capacity Wenn die SKU skalierungs-/in unterstützt, sollte die Ganze Kapazität eingeschlossen werden. Wenn eine Skalierung für die Ressource nicht möglich ist, wird dies möglicherweise weggelassen. int
family Wenn der Dienst über unterschiedliche Hardwaregenerationen verfügt, kann dies für dieselbe SKU hier erfasst werden. string
name Der Name der SKU. Z.B. P3. Es handelt sich in der Regel um einen Buchstaben+Zahlencode. Zeichenfolge (erforderlich)
size Die SKU-Größe. Wenn das Namensfeld die Kombination aus Ebene und einem anderen Wert ist, wäre dies der eigenständige Code. string
tier Dieses Feld muss vom Ressourcenanbieter implementiert werden, wenn der Dienst mehr als eine Ebene aufweist, für einen PUT jedoch nicht erforderlich ist. 'Basic'
'Free'
'Premium'
'Standard'

StopOnDisconnectConfiguration

Name Description Value
gracePeriodMinutes Die angegebene Zeit in Minuten, um zu warten, bevor ein Dev Box beendet wird, sobald die Verbindung erkannt wurde. int
status Gibt an, ob das Feature das Dev Box beim Trennen beenden soll, sobald die Nachfrist abgelaufen ist. 'Disabled'
'Enabled'

StopOnNoConnectConfiguration

Name Description Value
gracePeriodMinutes Die angegebene Zeit in Minuten, um zu warten, bevor ein Dev Box beendet wird, wenn keine Verbindung hergestellt wird. int
status Ermöglicht es dem Feature, ein gestartetes Dev Box zu beenden, wenn es nicht verbunden ist, sobald die Nachfrist abgelaufen ist. 'Disabled'
'Enabled'

TrackedResourceTags

Name Description Value
  • Last updated on