Udostępnij za pośrednictwem


Microsoft.DevCenter networkConnections

Definicja zasobu Bicep

Typ zasobu networkConnections można wdrożyć przy użyciu operacji docelowych:

Aby uzyskać listę zmienionych właściwości w każdej wersji interfejsu API, zobacz dziennika zmian.

Format zasobu

Aby utworzyć zasób Microsoft.DevCenter/networkConnections, dodaj następujący kod Bicep do szablonu.

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

Wartości właściwości

Microsoft.DevCenter/networkConnections

Name Description Value
lokalizacja Lokalizacja geograficzna, w której znajduje się zasób ciąg (wymagany)
name Nazwa zasobu string

Constraints:
Minimalna długość = 3
Maksymalna długość = 63
Wzorzec = ^[a-zA-Z0-9][a-zA-Z0-9-_.]{2,62}$ (wymagane)
properties Właściwości połączenia sieciowego NetworkProperties
tags Tagi zasobów Słownik nazw tagów i wartości. Zobacz tagi w szablonach

NetworkProperties

Name Description Value
domainJoinType Typ sprzężenia usługi AAD. 'AzureADJoin'
'HybridAzureADJoin'
"Brak" (wymagane)
domainName Nazwa domeny usługi Active Directory. ciąg
domainPassword Hasło do konta użytego do dołączenia do domeny. string

Constraints:
Wartość wrażliwa. Przekaż jako bezpieczny parametr.
domainUsername Nazwa użytkownika konta usługi Active Directory (konta użytkownika lub usługi), które ma uprawnienia do tworzenia obiektów komputerów w usłudze Active Directory. Wymagany format: admin@contoso.com. ciąg
networkingResourceGroupName Nazwa grupy zasobów, w której zostaną umieszczone karty sieciowe. ciąg
organizationUnit Jednostka organizacyjna domeny usługi Active Directory (OU). ciąg
subnetId Podsieć, do której mają być dołączane maszyny wirtualne. ciąg

TrackedResourceTags

Name Description Value

Przykłady użycia

Przykłady Bicep

Podstawowy przykład wdrażania połączenia sieciowego w Centrum deweloperów.

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

Moduły zweryfikowane na platformie Azure

Następujące moduły zweryfikowane platformy Azure mogą służyć do wdrażania tego typu zasobu.

Moduł Description
Połączenie sieciowe z Centrum deweloperów Moduł zasobów AVM dla połączenia sieciowego z centrum deweloperów

Przykłady szybkiego startu platformy Azure

Poniższe szablony szybkiego startu platformy Azure zawierają przykłady Bicep na potrzeby wdrażania tego typu zasobu.

Plik Bicep Description
Konfigurowanie usługi Dev Box Ten szablon umożliwia utworzenie wszystkich zasobów administracyjnych usługi Dev Box zgodnie z przewodnikiem Szybki start dotyczącym usługi Dev Box (/azure/dev-box/quickstart-create-dev-box). Możesz wyświetlić wszystkie utworzone zasoby lub bezpośrednio przejść do DevPortal.microsoft.com, aby utworzyć pierwsze rozwiązanie Dev Box.
wdrażanie usługi Dev Box Service z wbudowanym obrazem Ten szablon umożliwia wdrożenie usługi Dev Box z wbudowanym obrazem.

Definicja zasobu szablonu usługi ARM

Typ zasobu networkConnections można wdrożyć przy użyciu operacji docelowych:

Aby uzyskać listę zmienionych właściwości w każdej wersji interfejsu API, zobacz dziennika zmian.

Format zasobu

Aby utworzyć zasób Microsoft.DevCenter/networkConnections, dodaj następujący kod JSON do szablonu.

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

Wartości właściwości

Microsoft.DevCenter/networkConnections

Name Description Value
apiVersion Wersja interfejsu API 'Zapowiedź 2026-01-01'
lokalizacja Lokalizacja geograficzna, w której znajduje się zasób ciąg (wymagany)
name Nazwa zasobu string

Constraints:
Minimalna długość = 3
Maksymalna długość = 63
Wzorzec = ^[a-zA-Z0-9][a-zA-Z0-9-_.]{2,62}$ (wymagane)
properties Właściwości połączenia sieciowego NetworkProperties
tags Tagi zasobów Słownik nazw tagów i wartości. Zobacz tagi w szablonach
typ Typ zasobu 'Microsoft.DevCenter/networkConnections'

NetworkProperties

Name Description Value
domainJoinType Typ sprzężenia usługi AAD. 'AzureADJoin'
'HybridAzureADJoin'
"Brak" (wymagane)
domainName Nazwa domeny usługi Active Directory. ciąg
domainPassword Hasło do konta użytego do dołączenia do domeny. string

Constraints:
Wartość wrażliwa. Przekaż jako bezpieczny parametr.
domainUsername Nazwa użytkownika konta usługi Active Directory (konta użytkownika lub usługi), które ma uprawnienia do tworzenia obiektów komputerów w usłudze Active Directory. Wymagany format: admin@contoso.com. ciąg
networkingResourceGroupName Nazwa grupy zasobów, w której zostaną umieszczone karty sieciowe. ciąg
organizationUnit Jednostka organizacyjna domeny usługi Active Directory (OU). ciąg
subnetId Podsieć, do której mają być dołączane maszyny wirtualne. ciąg

TrackedResourceTags

Name Description Value

Przykłady użycia

Szablony szybkiego startu platformy Azure

Następujące szablony szybkiego startu platformy Azure wdrożyć ten typ zasobu.

Template Description
Konfigurowanie usługi Dev Box

wdrażanie w usłudze Azure
Ten szablon umożliwia utworzenie wszystkich zasobów administracyjnych usługi Dev Box zgodnie z przewodnikiem Szybki start dotyczącym usługi Dev Box (/azure/dev-box/quickstart-create-dev-box). Możesz wyświetlić wszystkie utworzone zasoby lub bezpośrednio przejść do DevPortal.microsoft.com, aby utworzyć pierwsze rozwiązanie Dev Box.
wdrażanie usługi Dev Box Service z wbudowanym obrazem

wdrażanie w usłudze Azure
Ten szablon umożliwia wdrożenie usługi Dev Box z wbudowanym obrazem.

Definicja zasobu narzędzia Terraform (dostawcy AzAPI)

Typ zasobu networkConnections można wdrożyć przy użyciu operacji docelowych:

  • Grupy zasobów

Aby uzyskać listę zmienionych właściwości w każdej wersji interfejsu API, zobacz dziennika zmian.

Format zasobu

Aby utworzyć zasób Microsoft.DevCenter/networkConnections, dodaj następujący program Terraform do szablonu.

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

Wartości właściwości

Microsoft.DevCenter/networkConnections

Name Description Value
lokalizacja Lokalizacja geograficzna, w której znajduje się zasób ciąg (wymagany)
name Nazwa zasobu string

Constraints:
Minimalna długość = 3
Maksymalna długość = 63
Wzorzec = ^[a-zA-Z0-9][a-zA-Z0-9-_.]{2,62}$ (wymagane)
properties Właściwości połączenia sieciowego NetworkProperties
tags Tagi zasobów Słownik nazw tagów i wartości.
typ Typ zasobu "Microsoft.DevCenter/networkConnections@2026-01-01-preview"

NetworkProperties

Name Description Value
domainJoinType Typ sprzężenia usługi AAD. 'AzureADJoin'
'HybridAzureADJoin'
"Brak" (wymagane)
domainName Nazwa domeny usługi Active Directory. ciąg
domainPassword Hasło do konta użytego do dołączenia do domeny. string

Constraints:
Wartość wrażliwa. Przekaż jako bezpieczny parametr.
domainUsername Nazwa użytkownika konta usługi Active Directory (konta użytkownika lub usługi), które ma uprawnienia do tworzenia obiektów komputerów w usłudze Active Directory. Wymagany format: admin@contoso.com. ciąg
networkingResourceGroupName Nazwa grupy zasobów, w której zostaną umieszczone karty sieciowe. ciąg
organizationUnit Jednostka organizacyjna domeny usługi Active Directory (OU). ciąg
subnetId Podsieć, do której mają być dołączane maszyny wirtualne. ciąg

TrackedResourceTags

Name Description Value

Przykłady użycia

Przykłady programu Terraform

Podstawowy przykład wdrażania połączenia sieciowego w Centrum deweloperów.

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    = ["*"]
}