Microsoft.Network dnsForwardingRulesets/forwardingRules

Bicep-resourcedefinitie

Het resourcetype dnsForwardingRulesets/forwardingRules kan worden geïmplementeerd met bewerkingen die gericht zijn op:

Zie logboek wijzigenvoor een lijst met gewijzigde eigenschappen in elke API-versie.

Resource-indeling

Als u een Resource Microsoft.Network/dnsForwardingRulesets/forwardingRules wilt maken, voegt u de volgende Bicep toe aan uw sjabloon.

resource symbolicname 'Microsoft.Network/dnsForwardingRulesets/forwardingRules@2025-10-01-preview' = {
  parent: resourceSymbolicName
  name: 'string'
  properties: {
    domainName: 'string'
    forwardingRuleState: 'string'
    metadata: {
      {customized property}: 'string'
    }
    targetDnsServers: [
      {
        ipAddress: 'string'
        port: int
      }
    ]
  }
}

Eigenschapswaarden

Microsoft.Network/dnsForwardingRulesets/forwardingRules

Naam Beschrijving Waarde
naam De resourcenaam tekenreeks (vereist)
ouder In Bicep kunt u de bovenliggende resource voor een onderliggende resource opgeven. U hoeft deze eigenschap alleen toe te voegen wanneer de onderliggende resource buiten de bovenliggende resource wordt gedeclareerd.

Zie onderliggende resource buiten de bovenliggende resourcevoor meer informatie.
Symbolische naam voor resource van het type: dnsForwardingRulesets
Eigenschappen Eigenschappen van de doorstuurregel. ForwardingRuleProperties (vereist)

ForwardingRuleProperties

Naam Beschrijving Waarde
domeinnaam De domeinnaam voor de doorstuurregel. tekenreeks (vereist)
doorsturenRegelStaat De status van de doorstuurregel. 'Uitgeschakeld'
'Ingeschakeld'
metagegevens Metagegevens die zijn gekoppeld aan de doorstuurregel. ForwardingRulePropertiesMetadata-
targetDnsServers DNS-servers om de DNS-query door te sturen naar. TargetDnsServer[] (vereist)

Metagegevens van ForwardingRuleProperties

Naam Beschrijving Waarde

DoelDnsServer

Naam Beschrijving Waarde
IP-adres IP-adres van DNS-server. tekenreeks (vereist)
haven DNS-serverpoort. Int

Gebruiksvoorbeelden

Bicep-voorbeelden

Een eenvoudig voorbeeld van het implementeren van Private DNS Resolver Forwarding Rule.

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

resource dnsForwardingRuleset 'Microsoft.Network/dnsForwardingRulesets@2022-07-01' = {
  name: resourceName
  location: location
  properties: {
    dnsResolverOutboundEndpoints: [
      {
        id: outboundEndpoint.id
      }
    ]
  }
}

resource dnsResolver 'Microsoft.Network/dnsResolvers@2022-07-01' = {
  name: resourceName
  location: location
  properties: {
    virtualNetwork: {
      id: virtualNetwork.id
    }
  }
}

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

resource forwardingRule 'Microsoft.Network/dnsForwardingRulesets/forwardingRules@2022-07-01' = {
  parent: dnsForwardingRuleset
  name: resourceName
  properties: {
    domainName: 'onprem.local.'
    forwardingRuleState: 'Enabled'
    metadata: null
    targetDnsServers: [
      {
        ipAddress: '10.10.0.1'
        port: 53
      }
    ]
  }
}

resource outboundEndpoint 'Microsoft.Network/dnsResolvers/outboundEndpoints@2022-07-01' = {
  parent: dnsResolver
  name: resourceName
  location: location
  properties: {
    subnet: {
      id: subnet.id
    }
  }
}

resource subnet 'Microsoft.Network/virtualNetworks/subnets@2022-07-01' = {
  parent: virtualNetwork
  name: 'outbounddns'
  properties: {
    addressPrefix: '10.0.0.64/28'
    delegations: [
      {
        name: 'Microsoft.Network.dnsResolvers'
        properties: {
          serviceName: 'Microsoft.Network/dnsResolvers'
        }
      }
    ]
    privateEndpointNetworkPolicies: 'Enabled'
    privateLinkServiceNetworkPolicies: 'Enabled'
    serviceEndpointPolicies: []
    serviceEndpoints: []
  }
}

Azure-snelstartvoorbeelden

De volgende Azure-quickstartsjablonen bicep-voorbeelden bevatten voor het implementeren van dit resourcetype.

Bicep-bestand Beschrijving
privé-resolver van Azure DNS Met deze sjabloon wordt azure DNS Private Resolver in een virtueel netwerk voorzien van de vereiste regelset en regels voor doorsturen. Er wordt een nieuw virtueel netwerk met twee subnetten gemaakt en azure DNS Private Resolver geïmplementeerd in dit VNET.

Resourcedefinitie van ARM-sjabloon

Het resourcetype dnsForwardingRulesets/forwardingRules kan worden geïmplementeerd met bewerkingen die gericht zijn op:

Zie logboek wijzigenvoor een lijst met gewijzigde eigenschappen in elke API-versie.

Resource-indeling

Als u een Resource Microsoft.Network/dnsForwardingRulesets/forwardingRules wilt maken, voegt u de volgende JSON toe aan uw sjabloon.

{
  "type": "Microsoft.Network/dnsForwardingRulesets/forwardingRules",
  "apiVersion": "2025-10-01-preview",
  "name": "string",
  "properties": {
    "domainName": "string",
    "forwardingRuleState": "string",
    "metadata": {
      "{customized property}": "string"
    },
    "targetDnsServers": [
      {
        "ipAddress": "string",
        "port": "int"
      }
    ]
  }
}

Eigenschapswaarden

Microsoft.Network/dnsForwardingRulesets/forwardingRules

Naam Beschrijving Waarde
apiVersion De API-versie '2025-10-01-voorbeschouwing'
naam De resourcenaam tekenreeks (vereist)
Eigenschappen Eigenschappen van de doorstuurregel. ForwardingRuleProperties (vereist)
soort Het resourcetype 'Microsoft.Network/dnsForwardingRulesets/forwardingRules'

ForwardingRuleProperties

Naam Beschrijving Waarde
domeinnaam De domeinnaam voor de doorstuurregel. tekenreeks (vereist)
doorsturenRegelStaat De status van de doorstuurregel. 'Uitgeschakeld'
'Ingeschakeld'
metagegevens Metagegevens die zijn gekoppeld aan de doorstuurregel. ForwardingRulePropertiesMetadata-
targetDnsServers DNS-servers om de DNS-query door te sturen naar. TargetDnsServer[] (vereist)

Metagegevens van ForwardingRuleProperties

Naam Beschrijving Waarde

DoelDnsServer

Naam Beschrijving Waarde
IP-adres IP-adres van DNS-server. tekenreeks (vereist)
haven DNS-serverpoort. Int

Gebruiksvoorbeelden

Azure-snelstartsjablonen

De volgende Azure-quickstartsjablonen dit resourcetype implementeren.

Sjabloon Beschrijving
privé-resolver van Azure DNS

implementeren in Azure
Met deze sjabloon wordt azure DNS Private Resolver in een virtueel netwerk voorzien van de vereiste regelset en regels voor doorsturen. Er wordt een nieuw virtueel netwerk met twee subnetten gemaakt en azure DNS Private Resolver geïmplementeerd in dit VNET.

Resourcedefinitie van Terraform (AzAPI-provider)

Het resourcetype dnsForwardingRulesets/forwardingRules kan worden geïmplementeerd met bewerkingen die gericht zijn op:

  • Resourcegroepen

Zie logboek wijzigenvoor een lijst met gewijzigde eigenschappen in elke API-versie.

Resource-indeling

Als u een Resource Microsoft.Network/dnsForwardingRulesets/forwardingRules wilt maken, voegt u de volgende Terraform toe aan uw sjabloon.

resource "azapi_resource" "symbolicname" {
  type = "Microsoft.Network/dnsForwardingRulesets/forwardingRules@2025-10-01-preview"
  name = "string"
  parent_id = "string"
  body = {
    properties = {
      domainName = "string"
      forwardingRuleState = "string"
      metadata = {
        {customized property} = "string"
      }
      targetDnsServers = [
        {
          ipAddress = "string"
          port = int
        }
      ]
    }
  }
}

Eigenschapswaarden

Microsoft.Network/dnsForwardingRulesets/forwardingRules

Naam Beschrijving Waarde
naam De resourcenaam tekenreeks (vereist)
ouder_id De id van de resource die het bovenliggende item voor deze resource is. Id voor resource van het type: dnsForwardingRulesets
Eigenschappen Eigenschappen van de doorstuurregel. ForwardingRuleProperties (vereist)
soort Het resourcetype "Microsoft.Network/dnsForwardingRulesets/forwardingRules@2025-10-01-preview"

ForwardingRuleProperties

Naam Beschrijving Waarde
domeinnaam De domeinnaam voor de doorstuurregel. tekenreeks (vereist)
doorsturenRegelStaat De status van de doorstuurregel. 'Uitgeschakeld'
'Ingeschakeld'
metagegevens Metagegevens die zijn gekoppeld aan de doorstuurregel. ForwardingRulePropertiesMetadata-
targetDnsServers DNS-servers om de DNS-query door te sturen naar. TargetDnsServer[] (vereist)

Metagegevens van ForwardingRuleProperties

Naam Beschrijving Waarde

DoelDnsServer

Naam Beschrijving Waarde
IP-adres IP-adres van DNS-server. tekenreeks (vereist)
haven DNS-serverpoort. Int

Gebruiksvoorbeelden

Terraform-monsters

Een eenvoudig voorbeeld van het implementeren van Private DNS Resolver Forwarding Rule.

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",
        ]
      }
      dhcpOptions = {
        dnsServers = [
        ]
      }
      subnets = [
      ]
    }
  }
  schema_validation_enabled = false
  response_export_values    = ["*"]
  lifecycle {
    ignore_changes = [body.properties.subnets]
  }
}

resource "azapi_resource" "dnsResolver" {
  type      = "Microsoft.Network/dnsResolvers@2022-07-01"
  parent_id = azapi_resource.resourceGroup.id
  name      = var.resource_name
  location  = var.location
  body = {
    properties = {
      virtualNetwork = {
        id = azapi_resource.virtualNetwork.id
      }
    }

  }
  schema_validation_enabled = false
  response_export_values    = ["*"]
}

resource "azapi_resource" "subnet" {
  type      = "Microsoft.Network/virtualNetworks/subnets@2022-07-01"
  parent_id = azapi_resource.virtualNetwork.id
  name      = "outbounddns"
  body = {
    properties = {
      addressPrefix = "10.0.0.64/28"
      delegations = [
        {
          name = "Microsoft.Network.dnsResolvers"
          properties = {
            serviceName = "Microsoft.Network/dnsResolvers"
          }
        },
      ]
      privateEndpointNetworkPolicies    = "Enabled"
      privateLinkServiceNetworkPolicies = "Enabled"
      serviceEndpointPolicies = [
      ]
      serviceEndpoints = [
      ]
    }
  }
  schema_validation_enabled = false
  response_export_values    = ["*"]
}

resource "azapi_resource" "outboundEndpoint" {
  type      = "Microsoft.Network/dnsResolvers/outboundEndpoints@2022-07-01"
  parent_id = azapi_resource.dnsResolver.id
  name      = var.resource_name
  location  = var.location
  body = {
    properties = {
      subnet = {
        id = azapi_resource.subnet.id
      }
    }

  }
  schema_validation_enabled = false
  response_export_values    = ["*"]
}

resource "azapi_resource" "dnsForwardingRuleset" {
  type      = "Microsoft.Network/dnsForwardingRulesets@2022-07-01"
  parent_id = azapi_resource.resourceGroup.id
  name      = var.resource_name
  location  = var.location
  body = {
    properties = {
      dnsResolverOutboundEndpoints = [
        {
          id = azapi_resource.outboundEndpoint.id
        },
      ]
    }

  }
  schema_validation_enabled = false
  response_export_values    = ["*"]
}

resource "azapi_resource" "forwardingRule" {
  type      = "Microsoft.Network/dnsForwardingRulesets/forwardingRules@2022-07-01"
  parent_id = azapi_resource.dnsForwardingRuleset.id
  name      = var.resource_name
  body = {
    properties = {
      domainName          = "onprem.local."
      forwardingRuleState = "Enabled"
      metadata            = null
      targetDnsServers = [
        {
          ipAddress = "10.10.0.1"
          port      = 53
        },
      ]
    }
  }
  schema_validation_enabled = false
  response_export_values    = ["*"]
}