Compartilhar via


Microsoft.DevCenter networkConnections

Definição de recurso do Bicep

O tipo de recurso networkConnections pode ser implantado com operações de destino:

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

Formato do recurso

Para criar um recurso Microsoft.DevCenter/networkConnections, adicione o seguinte Bicep ao modelo.

resource symbolicname 'Microsoft.DevCenter/networkConnections@2026-01-01-preview' = {
  location: 'string'
  name: 'string'
  properties: {
    domainJoinType: 'string'
    domainName: 'string'
    domainPassword: 'string'
    domainUsername: 'string'
    networkingResourceGroupName: 'string'
    organizationUnit: 'string'
    subnetId: 'string'
  }
  tags: {
    {customized property}: 'string'
  }
}

Valores de propriedade

Microsoft.DevCenter/networkConnections

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)
properties Propriedades de uma conexão de rede NetworkProperties
tags Etiquetas de recursos Dicionário de nomes e valores de marca. Consulte Marcas em modelos

NetworkProperties

Name Description Value
domainJoinType Tipo de junção do AAD. 'AzureADJoin'
'HybridAzureADJoin'
'Nenhum' (obrigatório)
domainName Nome de domínio do Active Directory. cadeia
domainPassword A senha da conta usada para ingressar no domínio. string

Constraints:
Valor sensível. Passe como um parâmetro seguro.
domainUsername O nome de usuário de uma conta do Active Directory (conta de usuário ou serviço) que tem permissões para criar objetos de computador no Active Directory. Formato necessário: admin@contoso.com. cadeia
networkingResourceGroupName O nome do grupo de recursos em que as NICs serão colocadas. cadeia
organizationUnit Unidade organizacional (UO) de domínio do Active Directory. cadeia
subnetId A sub-rede à qual anexar Máquinas Virtuais. cadeia

TrackedResourceTags

Name Description Value

Exemplos de uso

Exemplos do Bicep

Um exemplo básico de implantação da Conexão de Rede do Centro de Desenvolvimento.

param resourceName string = 'acctest0001'
param location string = 'westeurope'

resource networkConnection 'Microsoft.DevCenter/networkConnections@2023-04-01' = {
  name: resourceName
  location: location
  properties: {
    domainJoinType: 'AzureADJoin'
    subnetId: subnet.id
  }
}

resource virtualNetwork 'Microsoft.Network/virtualNetworks@2022-07-01' = {
  name: resourceName
  location: location
  properties: {
    addressSpace: {
      addressPrefixes: [
        '10.0.0.0/16'
      ]
    }
  }
}

resource subnet 'Microsoft.Network/virtualNetworks/subnets@2022-07-01' = {
  parent: virtualNetwork
  name: resourceName
  properties: {
    addressPrefix: '10.0.2.0/24'
  }
}

Módulos verificados do Azure

O módulos verificados do Azure a seguir pode ser usado para implantar esse tipo de recurso.

Módulo Description
Conexão de rede do Centro de Desenvolvimento Módulo de recursos do AVM para conexão de rede do Centro de Desenvolvimento

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 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 networkConnections pode ser implantado com operações de destino:

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

Formato do recurso

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

{
  "type": "Microsoft.DevCenter/networkConnections",
  "apiVersion": "2026-01-01-preview",
  "name": "string",
  "location": "string",
  "properties": {
    "domainJoinType": "string",
    "domainName": "string",
    "domainPassword": "string",
    "domainUsername": "string",
    "networkingResourceGroupName": "string",
    "organizationUnit": "string",
    "subnetId": "string"
  },
  "tags": {
    "{customized property}": "string"
  }
}

Valores de propriedade

Microsoft.DevCenter/networkConnections

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 de uma conexão de rede NetworkProperties
tags Etiquetas de recursos Dicionário de nomes e valores de marca. Consulte Marcas em modelos
tipo O tipo de recurso 'Microsoft.DevCenter/networkConnections'

NetworkProperties

Name Description Value
domainJoinType Tipo de junção do AAD. 'AzureADJoin'
'HybridAzureADJoin'
'Nenhum' (obrigatório)
domainName Nome de domínio do Active Directory. cadeia
domainPassword A senha da conta usada para ingressar no domínio. string

Constraints:
Valor sensível. Passe como um parâmetro seguro.
domainUsername O nome de usuário de uma conta do Active Directory (conta de usuário ou serviço) que tem permissões para criar objetos de computador no Active Directory. Formato necessário: admin@contoso.com. cadeia
networkingResourceGroupName O nome do grupo de recursos em que as NICs serão colocadas. cadeia
organizationUnit Unidade organizacional (UO) de domínio do Active Directory. cadeia
subnetId A sub-rede à qual anexar Máquinas Virtuais. cadeia

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 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 networkConnections pode ser implantado com operações de destino:

  • Grupos de recursos

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

Formato do recurso

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

resource "azapi_resource" "symbolicname" {
  type = "Microsoft.DevCenter/networkConnections@2026-01-01-preview"
  name = "string"
  parent_id = "string"
  location = "string"
  tags = {
    {customized property} = "string"
  }
  body = {
    properties = {
      domainJoinType = "string"
      domainName = "string"
      domainPassword = "string"
      domainUsername = "string"
      networkingResourceGroupName = "string"
      organizationUnit = "string"
      subnetId = "string"
    }
  }
}

Valores de propriedade

Microsoft.DevCenter/networkConnections

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)
properties Propriedades de uma conexão de rede NetworkProperties
tags Etiquetas de recursos Dicionário de nomes e valores de marca.
tipo O tipo de recurso "Microsoft.DevCenter/networkConnections@2026-01-01-preview"

NetworkProperties

Name Description Value
domainJoinType Tipo de junção do AAD. 'AzureADJoin'
'HybridAzureADJoin'
'Nenhum' (obrigatório)
domainName Nome de domínio do Active Directory. cadeia
domainPassword A senha da conta usada para ingressar no domínio. string

Constraints:
Valor sensível. Passe como um parâmetro seguro.
domainUsername O nome de usuário de uma conta do Active Directory (conta de usuário ou serviço) que tem permissões para criar objetos de computador no Active Directory. Formato necessário: admin@contoso.com. cadeia
networkingResourceGroupName O nome do grupo de recursos em que as NICs serão colocadas. cadeia
organizationUnit Unidade organizacional (UO) de domínio do Active Directory. cadeia
subnetId A sub-rede à qual anexar Máquinas Virtuais. cadeia

TrackedResourceTags

Name Description Value

Exemplos de uso

Exemplos do Terraform

Um exemplo básico de implantação da Conexão de Rede do Centro de Desenvolvimento.

terraform {
  required_providers {
    azapi = {
      source = "Azure/azapi"
    }
  }
}

provider "azapi" {
  skip_provider_registration = false
}

variable "resource_name" {
  type    = string
  default = "acctest0001"
}

variable "location" {
  type    = string
  default = "westeurope"
}

resource "azapi_resource" "resourceGroup" {
  type     = "Microsoft.Resources/resourceGroups@2020-06-01"
  name     = var.resource_name
  location = var.location
}

resource "azapi_resource" "virtualNetwork" {
  type      = "Microsoft.Network/virtualNetworks@2022-07-01"
  parent_id = azapi_resource.resourceGroup.id
  name      = var.resource_name
  location  = var.location
  body = {
    properties = {
      addressSpace = {
        addressPrefixes = [
          "10.0.0.0/16",
        ]
      }
    }
  }
  schema_validation_enabled = false
  response_export_values    = ["*"]
  lifecycle {
    ignore_changes = [body.properties.subnets]
  }
}

resource "azapi_resource" "subnet" {
  type      = "Microsoft.Network/virtualNetworks/subnets@2022-07-01"
  parent_id = azapi_resource.virtualNetwork.id
  name      = var.resource_name
  body = {
    properties = {
      addressPrefix = "10.0.2.0/24"
    }
  }
  schema_validation_enabled = false
  response_export_values    = ["*"]
}

resource "azapi_resource" "networkConnection" {
  type      = "Microsoft.DevCenter/networkConnections@2023-04-01"
  parent_id = azapi_resource.resourceGroup.id
  name      = var.resource_name
  location  = var.location
  body = {
    properties = {
      domainJoinType = "AzureADJoin"
      subnetId       = azapi_resource.subnet.id
    }
  }
  schema_validation_enabled = false
  response_export_values    = ["*"]
}