Microsoft.Network virtualNetworkGateways 2019-11-01

• 最新
• 2024-03-01
• 2024-01-01
• 2023-11-01
• 2023-09-01
• 2023-06-01
• 2023-05-01
• 2023-04-01
• 2023-02-01
• 2022-11-01
• 2022-09-01
• 2022-07-01
• 2022-05-01
• 2022-01-01
• 2021-08-01
• 2021-05-01
• 2021-03-01
• 2021-02-01
• 2020-11-01
• 2020-08-01
• 2020-07-01
• 2020-06-01
• 2020-05-01
• 2020-04-01
• 2020-03-01
• 2019-12-01
• 2019-11-01
• 2019-09-01
• 2019-08-01
• 2019-07-01
• 2019-06-01
• 2019-04-01
• 2019-02-01
• 2018-12-01
• 2018-11-01
• 2018-10-01
• 2018-08-01
• 2018-07-01
• 2018-06-01
• 2018-04-01
• 2018-02-01
• 2018-01-01
• 2017-11-01
• 2017-10-01
• 2017-09-01
• 2017-08-01
• 2017-06-01
• 2017-03-30
• 2017-03-01
• 2016-12-01
• 2016-09-01
• 2016-06-01
• 2016-03-30
• 2015-06-15
• 2015-05-01-preview

Bicep 資源定義

virtualNetworkGateways 資源類型可以使用目標作業來部署：

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

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

資源格式

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

resource symbolicname 'Microsoft.Network/virtualNetworkGateways@2019-11-01' = {
  location: 'string'
  name: 'string'
  properties: {
    activeActive: bool
    bgpSettings: {
      asn: int
      bgpPeeringAddress: 'string'
      peerWeight: int
    }
    customRoutes: {
      addressPrefixes: [
        'string'
      ]
    }
    enableBgp: bool
    enableDnsForwarding: bool
    gatewayDefaultSite: {
      id: 'string'
    }
    gatewayType: 'string'
    ipConfigurations: [
      {
        id: 'string'
        name: 'string'
        properties: {
          privateIPAllocationMethod: 'string'
          publicIPAddress: {
            id: 'string'
          }
          subnet: {
            id: 'string'
          }
        }
      }
    ]
    sku: {
      name: 'string'
      tier: 'string'
    }
    vpnClientConfiguration: {
      aadAudience: 'string'
      aadIssuer: 'string'
      aadTenant: 'string'
      radiusServerAddress: 'string'
      radiusServerSecret: 'string'
      vpnClientAddressPool: {
        addressPrefixes: [
          'string'
        ]
      }
      vpnClientIpsecPolicies: [
        {
          dhGroup: 'string'
          ikeEncryption: 'string'
          ikeIntegrity: 'string'
          ipsecEncryption: 'string'
          ipsecIntegrity: 'string'
          pfsGroup: 'string'
          saDataSizeKilobytes: int
          saLifeTimeSeconds: int
        }
      ]
      vpnClientProtocols: [
        'string'
      ]
      vpnClientRevokedCertificates: [
        {
          id: 'string'
          name: 'string'
          properties: {
            thumbprint: 'string'
          }
        }
      ]
      vpnClientRootCertificates: [
        {
          id: 'string'
          name: 'string'
          properties: {
            publicCertData: 'string'
          }
        }
      ]
    }
    vpnGatewayGeneration: 'string'
    vpnType: 'string'
  }
  tags: {
    {customized property}: 'string'
  }
}

屬性值

AddressSpace

名字	描述	價值
addressPrefixes	以 CIDR 表示法保留給此虛擬網路的位址區塊清單。	string[]

BgpSettings

名字	描述	價值
asn	BGP 喇叭的 ASN。	int
bgpPeeringAddress	這個 BGP 說話者的 BGP 對等互連位址和 BGP 識別碼。	字串
peerWeight	新增至此 BGP 喇叭所學習路由的權數。	int

IpsecPolicy

名字	描述	價值
dhGroup	在 IKE 階段 1 中用於初始 SA 的 DH 群組。	'DHGroup1' 'DHGroup14' 'DHGroup2' 'DHGroup2048' 'DHGroup24' 'ECP256' 'ECP384' 'None' （必要）
ikeEncryption	IKE 加密演算法 （IKE 階段 2）。	'AES128' 'AES192' 'AES256' 'DES' 'DES3' 'GCMAES128' 'GCMAES256' （必要）
ikeIntegrity	IKE 完整性演算法 （IKE 階段 2）。	'GCMAES128' 'GCMAES256' 'MD5' 'SHA1' 'SHA256' 'SHA384' （必要）
ipsecEncryption	IPSec 加密演算法 （IKE 階段 1）。	'AES128' 'AES192' 'AES256' 'DES' 'DES3' 'GCMAES128' 'GCMAES192' 'GCMAES256' 'None' （必要）
ipsecIntegrity	IPSec 完整性演算法 （IKE 階段 1）。	'GCMAES128' 'GCMAES192' 'GCMAES256' 'MD5' 'SHA1' 'SHA256' （必要）
pfsGroup	IKE 階段 2 中用於新子 SA 的 Pfs 群組。	'ECP256' 'ECP384' 'None' 'PFS1' 'PFS14' 'PFS2' 'PFS2048' 'PFS24' 'PFSMM' （必要）
saDataSizeKilobytes	IPSec 安全性關聯 （也稱為快速模式或階段 2 SA） 承載大小 KB，適用於站對站 VPN 通道。	int （必要）
saLifeTimeSeconds	IPSec 安全性關聯 （也稱為快速模式或階段 2 SA） 存留期，以秒為單位，用於站對站 VPN 通道。	int （必要）

Microsoft.Network/virtualNetworkGateways

名字	描述	價值
位置	資源位置。	字串
名字	資源名稱	字串 （必要）
性能	虛擬網路閘道的屬性。	VirtualNetworkGatewayPropertiesFormat （必要）
標籤	資源標籤	標記名稱和值的字典。 請參閱範本中的 標籤

ResourceTags

名字	描述	價值

SubResource

名字	描述	價值
id	資源標識碼。	字串

VirtualNetworkGatewayIPConfiguration

名字	描述	價值
id	資源標識碼。	字串
名字	資源群組內唯一的資源名稱。 此名稱可用來存取資源。	字串
性能	虛擬網路閘道IP組態的屬性。	VirtualNetworkGatewayIPConfigurationPropertiesFormat

VirtualNetworkGatewayIPConfigurationPropertiesFormat

名字	描述	價值
privateIPAllocationMethod	私人IP位址配置方法。	'Dynamic' 'Static'
publicIPAddress	公用IP資源的參考。	SubResource
子	子網資源的參考。	SubResource

VirtualNetworkGatewayPropertiesFormat

名字	描述	價值
activeActive	ActiveActive 旗標。	bool
bgpSettings	虛擬網路閘道的 BGP 喇叭設定。	BgpSettings
customRoutes	位址空間資源的參考，代表客戶針對虛擬網路網關和 VpnClient 所指定的自定義路由地址空間。	AddressSpace
enableBgp	是否為此虛擬網路閘道啟用 BGP。	bool
enableDnsForwarding	是否啟用 DNS 轉送。	bool
gatewayDefaultSite	LocalNetworkGateway 資源的參考，代表具有預設路由的局域網路網站。 如果移除現有的默認網站設定，請指派 Null 值。	SubResource
gatewayType	此虛擬網路閘道的類型。	'ExpressRoute' 'Vpn'
ipConfigurations	虛擬網路閘道的IP組態。	VirtualNetworkGatewayIPConfiguration[]
sku	VirtualNetworkGatewaySku 資源的參考，代表為虛擬網路網關選取的 SKU。	VirtualNetworkGatewaySku
vpnClientConfiguration	代表 P2S VpnClient 組態之 VpnClientConfiguration 資源的參考。	VpnClientConfiguration
vpnGatewayGeneration	此 VirtualNetworkGateway 的世代。 如果 gatewayType 不是 VPN，則必須是 None。	'Generation1' 'Generation2' 'None'
vpnType	此虛擬網路閘道的類型。	'PolicyBased' 'RouteBased'

VirtualNetworkGatewaySku

名字	描述	價值
名字	閘道 SKU 名稱。	'Basic' 'ErGw1AZ' 'ErGw2AZ' 'ErGw3AZ' 'HighPerformance' 'Standard' 'UltraPerformance' 'VpnGw1' 'VpnGw1AZ' 'VpnGw2' 'VpnGw2AZ' 'VpnGw3' 'VpnGw3AZ' 'VpnGw4' 'VpnGw4AZ' 'VpnGw5' 'VpnGw5AZ'
層	閘道 SKU 層。	'Basic' 'ErGw1AZ' 'ErGw2AZ' 'ErGw3AZ' 'HighPerformance' 'Standard' 'UltraPerformance' 'VpnGw1' 'VpnGw1AZ' 'VpnGw2' 'VpnGw2AZ' 'VpnGw3' 'VpnGw3AZ' 'VpnGw4' 'VpnGw4AZ' 'VpnGw5' 'VpnGw5AZ'

VpnClientConfiguration

名字	描述	價值
aadAudience	用於 AAD 驗證之 Vpn 用戶端連線的 VirtualNetworkGateway 資源的 AADAudience 屬性。	字串
aadIssuer	用於 AAD 驗證之 Vpn 用戶端連線的 VirtualNetworkGateway 資源的 AADIssuer 屬性。	字串
aadTenant	用於 AAD 驗證之 Vpn 用戶端連線的 VirtualNetworkGateway 資源的 AADTenant 屬性。	字串
radiusServerAddress	VPN 用戶端連線 VirtualNetworkGateway 資源的 radius 伺服器地址屬性。	字串
radiusServerSecret	Vpn 用戶端連線的 VirtualNetworkGateway 資源的 radius 秘密屬性。	字串
vpnClientAddressPool	地址空間資源的參考，代表 P2S VpnClient 的地址空間。	AddressSpace
vpnClientIpsecPolicies	虛擬網路閘道 P2S 用戶端的 VpnClientIpsecPolicies。	IpsecPolicy[]
vpnClientProtocols	虛擬網路閘道的 VpnClientProtocols。	包含任何的字串數組： 'IkeV2' 'OpenVPN' 'SSTP'
vpnClientRevokedCertificates	虛擬網路閘道的 VpnClientRevokedCertificate。	VpnClientRevokedCertificate[]
vpnClientRootCertificates	虛擬網路閘道的 VpnClientRootCertificate。	VpnClientRootCertificate[]

VpnClientRevokedCertificate

名字	描述	價值
id	資源標識碼。	字串
名字	資源群組內唯一的資源名稱。 此名稱可用來存取資源。	字串
性能	VPN 用戶端撤銷憑證的屬性。	VpnClientRevokedCertificatePropertiesFormat

VpnClientRevokedCertificatePropertiesFormat

名字	描述	價值
指紋	撤銷的 VPN 用戶端憑證指紋。	字串

VpnClientRootCertificate

名字	描述	價值
id	資源標識碼。	字串
名字	資源群組內唯一的資源名稱。 此名稱可用來存取資源。	字串
性能	vpn 用戶端跟證書的屬性。	VpnClientRootCertificatePropertiesFormat （必要）

VpnClientRootCertificatePropertiesFormat

名字	描述	價值
publicCertData	憑證公用數據。	字串 （必要）

快速入門範例

下列快速入門範例會部署此資源類型。

Bicep 檔案	描述
建立 BGP VNET 對 VNET 連線	此範本可讓您使用虛擬網路閘道和 BGP 連線兩個 VNET
使用 Azure AD 建立點對站閘道	此範本會部署使用 Azure Active Directory 點對站聯機設定的 VPN 虛擬網路閘道
使用私人對等互連和 Azure VNet ExpressRoute 線路	此範本會設定 ExpressRoute Microsoft對等互連、部署具有 Expressroute 閘道的 Azure VNet，並將 VNet 連結到 ExpressRoute 線路
使用 BGP 使用主動 VPN 閘道 站對站 VPN VPN	此範本可讓您在具有 VPN 閘道的兩個 VNet 之間部署站對站 VPN，以使用 BGP 設定主動-主動。 每個 Azure VPN 閘道都會解析遠端對等的 FQDN，以判斷遠端 VPN 閘道的公用 IP。 範本會在具有可用性區域的 Azure 區域中如預期般執行。
使用 Azure 防火牆作為中樞 & 輪輻拓撲中的 DNS Proxy	此範例示範如何使用 Azure 防火牆在 Azure 中部署中樞輪輻拓撲。 中樞虛擬網路可作為透過虛擬網路對等互連連線到中樞虛擬網路之許多輪輻虛擬網路的中央點。

ARM 樣本資源定義

virtualNetworkGateways 資源類型可以使用目標作業來部署：

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

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

資源格式

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

{
  "type": "Microsoft.Network/virtualNetworkGateways",
  "apiVersion": "2019-11-01",
  "name": "string",
  "location": "string",
  "properties": {
    "activeActive": "bool",
    "bgpSettings": {
      "asn": "int",
      "bgpPeeringAddress": "string",
      "peerWeight": "int"
    },
    "customRoutes": {
      "addressPrefixes": [ "string" ]
    },
    "enableBgp": "bool",
    "enableDnsForwarding": "bool",
    "gatewayDefaultSite": {
      "id": "string"
    },
    "gatewayType": "string",
    "ipConfigurations": [
      {
        "id": "string",
        "name": "string",
        "properties": {
          "privateIPAllocationMethod": "string",
          "publicIPAddress": {
            "id": "string"
          },
          "subnet": {
            "id": "string"
          }
        }
      }
    ],
    "sku": {
      "name": "string",
      "tier": "string"
    },
    "vpnClientConfiguration": {
      "aadAudience": "string",
      "aadIssuer": "string",
      "aadTenant": "string",
      "radiusServerAddress": "string",
      "radiusServerSecret": "string",
      "vpnClientAddressPool": {
        "addressPrefixes": [ "string" ]
      },
      "vpnClientIpsecPolicies": [
        {
          "dhGroup": "string",
          "ikeEncryption": "string",
          "ikeIntegrity": "string",
          "ipsecEncryption": "string",
          "ipsecIntegrity": "string",
          "pfsGroup": "string",
          "saDataSizeKilobytes": "int",
          "saLifeTimeSeconds": "int"
        }
      ],
      "vpnClientProtocols": [ "string" ],
      "vpnClientRevokedCertificates": [
        {
          "id": "string",
          "name": "string",
          "properties": {
            "thumbprint": "string"
          }
        }
      ],
      "vpnClientRootCertificates": [
        {
          "id": "string",
          "name": "string",
          "properties": {
            "publicCertData": "string"
          }
        }
      ]
    },
    "vpnGatewayGeneration": "string",
    "vpnType": "string"
  },
  "tags": {
    "{customized property}": "string"
  }
}

屬性值

AddressSpace

名字	描述	價值
addressPrefixes	以 CIDR 表示法保留給此虛擬網路的位址區塊清單。	string[]

BgpSettings

名字	描述	價值
asn	BGP 喇叭的 ASN。	int
bgpPeeringAddress	這個 BGP 說話者的 BGP 對等互連位址和 BGP 識別碼。	字串
peerWeight	新增至此 BGP 喇叭所學習路由的權數。	int

IpsecPolicy

名字	描述	價值
dhGroup	在 IKE 階段 1 中用於初始 SA 的 DH 群組。	'DHGroup1' 'DHGroup14' 'DHGroup2' 'DHGroup2048' 'DHGroup24' 'ECP256' 'ECP384' 'None' （必要）
ikeEncryption	IKE 加密演算法 （IKE 階段 2）。	'AES128' 'AES192' 'AES256' 'DES' 'DES3' 'GCMAES128' 'GCMAES256' （必要）
ikeIntegrity	IKE 完整性演算法 （IKE 階段 2）。	'GCMAES128' 'GCMAES256' 'MD5' 'SHA1' 'SHA256' 'SHA384' （必要）
ipsecEncryption	IPSec 加密演算法 （IKE 階段 1）。	'AES128' 'AES192' 'AES256' 'DES' 'DES3' 'GCMAES128' 'GCMAES192' 'GCMAES256' 'None' （必要）
ipsecIntegrity	IPSec 完整性演算法 （IKE 階段 1）。	'GCMAES128' 'GCMAES192' 'GCMAES256' 'MD5' 'SHA1' 'SHA256' （必要）
pfsGroup	IKE 階段 2 中用於新子 SA 的 Pfs 群組。	'ECP256' 'ECP384' 'None' 'PFS1' 'PFS14' 'PFS2' 'PFS2048' 'PFS24' 'PFSMM' （必要）
saDataSizeKilobytes	IPSec 安全性關聯 （也稱為快速模式或階段 2 SA） 承載大小 KB，適用於站對站 VPN 通道。	int （必要）
saLifeTimeSeconds	IPSec 安全性關聯 （也稱為快速模式或階段 2 SA） 存留期，以秒為單位，用於站對站 VPN 通道。	int （必要）

Microsoft.Network/virtualNetworkGateways

名字	描述	價值
apiVersion	API 版本	'2019-11-01'
位置	資源位置。	字串
名字	資源名稱	字串 （必要）
性能	虛擬網路閘道的屬性。	VirtualNetworkGatewayPropertiesFormat （必要）
標籤	資源標籤	標記名稱和值的字典。 請參閱範本中的 標籤
類型	資源類型	'Microsoft.Network/virtualNetworkGateways'

ResourceTags

名字	描述	價值

SubResource

名字	描述	價值
id	資源標識碼。	字串

VirtualNetworkGatewayIPConfiguration

名字	描述	價值
id	資源標識碼。	字串
名字	資源群組內唯一的資源名稱。 此名稱可用來存取資源。	字串
性能	虛擬網路閘道IP組態的屬性。	VirtualNetworkGatewayIPConfigurationPropertiesFormat

VirtualNetworkGatewayIPConfigurationPropertiesFormat

名字	描述	價值
privateIPAllocationMethod	私人IP位址配置方法。	'Dynamic' 'Static'
publicIPAddress	公用IP資源的參考。	SubResource
子	子網資源的參考。	SubResource

VirtualNetworkGatewayPropertiesFormat

名字	描述	價值
activeActive	ActiveActive 旗標。	bool
bgpSettings	虛擬網路閘道的 BGP 喇叭設定。	BgpSettings
customRoutes	位址空間資源的參考，代表客戶針對虛擬網路網關和 VpnClient 所指定的自定義路由地址空間。	AddressSpace
enableBgp	是否為此虛擬網路閘道啟用 BGP。	bool
enableDnsForwarding	是否啟用 DNS 轉送。	bool
gatewayDefaultSite	LocalNetworkGateway 資源的參考，代表具有預設路由的局域網路網站。 如果移除現有的默認網站設定，請指派 Null 值。	SubResource
gatewayType	此虛擬網路閘道的類型。	'ExpressRoute' 'Vpn'
ipConfigurations	虛擬網路閘道的IP組態。	VirtualNetworkGatewayIPConfiguration[]
sku	VirtualNetworkGatewaySku 資源的參考，代表為虛擬網路網關選取的 SKU。	VirtualNetworkGatewaySku
vpnClientConfiguration	代表 P2S VpnClient 組態之 VpnClientConfiguration 資源的參考。	VpnClientConfiguration
vpnGatewayGeneration	此 VirtualNetworkGateway 的世代。 如果 gatewayType 不是 VPN，則必須是 None。	'Generation1' 'Generation2' 'None'
vpnType	此虛擬網路閘道的類型。	'PolicyBased' 'RouteBased'

VirtualNetworkGatewaySku

名字	描述	價值
名字	閘道 SKU 名稱。	'Basic' 'ErGw1AZ' 'ErGw2AZ' 'ErGw3AZ' 'HighPerformance' 'Standard' 'UltraPerformance' 'VpnGw1' 'VpnGw1AZ' 'VpnGw2' 'VpnGw2AZ' 'VpnGw3' 'VpnGw3AZ' 'VpnGw4' 'VpnGw4AZ' 'VpnGw5' 'VpnGw5AZ'
層	閘道 SKU 層。	'Basic' 'ErGw1AZ' 'ErGw2AZ' 'ErGw3AZ' 'HighPerformance' 'Standard' 'UltraPerformance' 'VpnGw1' 'VpnGw1AZ' 'VpnGw2' 'VpnGw2AZ' 'VpnGw3' 'VpnGw3AZ' 'VpnGw4' 'VpnGw4AZ' 'VpnGw5' 'VpnGw5AZ'

VpnClientConfiguration

名字	描述	價值
aadAudience	用於 AAD 驗證之 Vpn 用戶端連線的 VirtualNetworkGateway 資源的 AADAudience 屬性。	字串
aadIssuer	用於 AAD 驗證之 Vpn 用戶端連線的 VirtualNetworkGateway 資源的 AADIssuer 屬性。	字串
aadTenant	用於 AAD 驗證之 Vpn 用戶端連線的 VirtualNetworkGateway 資源的 AADTenant 屬性。	字串
radiusServerAddress	VPN 用戶端連線 VirtualNetworkGateway 資源的 radius 伺服器地址屬性。	字串
radiusServerSecret	Vpn 用戶端連線的 VirtualNetworkGateway 資源的 radius 秘密屬性。	字串
vpnClientAddressPool	地址空間資源的參考，代表 P2S VpnClient 的地址空間。	AddressSpace
vpnClientIpsecPolicies	虛擬網路閘道 P2S 用戶端的 VpnClientIpsecPolicies。	IpsecPolicy[]
vpnClientProtocols	虛擬網路閘道的 VpnClientProtocols。	包含任何的字串數組： 'IkeV2' 'OpenVPN' 'SSTP'
vpnClientRevokedCertificates	虛擬網路閘道的 VpnClientRevokedCertificate。	VpnClientRevokedCertificate[]
vpnClientRootCertificates	虛擬網路閘道的 VpnClientRootCertificate。	VpnClientRootCertificate[]

VpnClientRevokedCertificate

名字	描述	價值
id	資源標識碼。	字串
名字	資源群組內唯一的資源名稱。 此名稱可用來存取資源。	字串
性能	VPN 用戶端撤銷憑證的屬性。	VpnClientRevokedCertificatePropertiesFormat

VpnClientRevokedCertificatePropertiesFormat

名字	描述	價值
指紋	撤銷的 VPN 用戶端憑證指紋。	字串

VpnClientRootCertificate

名字	描述	價值
id	資源標識碼。	字串
名字	資源群組內唯一的資源名稱。 此名稱可用來存取資源。	字串
性能	vpn 用戶端跟證書的屬性。	VpnClientRootCertificatePropertiesFormat （必要）

VpnClientRootCertificatePropertiesFormat

名字	描述	價值
publicCertData	憑證公用數據。	字串 （必要）

快速入門範本

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

範本	描述
使用 Azure SQL 後端 App Service 環境	此範本會建立具有 Azure SQL 後端的 App Service 環境，以及私人端點，以及通常用於私人/隔離環境中的相關聯資源。
BOSH CF 跨區域	此範本可協助您設定在 Azure 上兩個區域部署 BOSH 和 Cloud Foundry 所需的資源。
將 ExpressRoute 線路連線至 VNET	此範本會建立 VNET、ExpresRoute 閘道，以及已設定 AzurePrivatePeering 的已佈建和已啟用 ExpressRoute 線路的連線。
建立 BGP VNET 對 VNET 連線	此範本可讓您使用虛擬網路閘道和 BGP 連線兩個 VNET
使用 P2S VPN 和 IIS 建立 DevTest 環境	此範本會在 Windows 伺服器上建立具有點對站 VPN 和 IIS 的簡單 DevTest 環境，這是開始使用的絕佳方式。
建立點對站網關	此範本可讓您使用 VirtualNetworkGateways 建立點對站連線
使用 Azure AD 建立點對站閘道	此範本會部署使用 Azure Active Directory 點對站聯機設定的 VPN 虛擬網路閘道
建立站對站 VPN 連線	此範本可讓您使用虛擬網路閘道建立站對站 VPN 連線
使用 VM 建立站對站 VPN 連線	此範本可讓您使用虛擬網路閘道建立站對站 VPN 連線
跨兩個區域建立 VNET 對 VNET 連線	此範本可讓您使用虛擬網路閘道連接不同區域中的兩個 VNET
建立已設定點對站連線的 SQL MI	部署針對新虛擬網路內點對站連線所設定的 Azure Sql Database 受控實例 （SQL MI） 和虛擬網路網關。
建立三個 vNet 來示範可轉移的 BGP 連線	此範本會部署三個使用虛擬網路閘道和已啟用 BGP 連線的 vNet
建立具有兩個子網、局域網路和閘道 的 VNet	此範本會建立 VNet、2 個子網和閘道
部署中樞和輪輻拓撲沙盒	此範本會建立基本的中樞和輪輻拓撲設定。 它會建立具有 DMZ、管理、共用和閘道子網的中樞 VNet（選擇性），其中兩個輪輻 VNet（開發和生產環境）包含每個工作負載子網。 它也會在中樞的管理子網上部署 Windows Jump-Host，並在中樞與兩個輪輻之間建立 VNet 對等互連。
部署 HBase 異地復寫	此範本可讓您使用 VPN vnet 對 vnet 連線，在兩個不同的區域中設定 HBase 複寫的 Azure 環境。
使用私人對等互連和 Azure VNet ExpressRoute 線路	此範本會設定 ExpressRoute Microsoft對等互連、部署具有 Expressroute 閘道的 Azure VNet，並將 VNet 連結到 ExpressRoute 線路
將現有的 Azure VNET 擴充至多 VNET 組態	此範本可讓您使用 VNET 對 VNET 閘道，將現有的單一 VNET 環境延伸至跨兩個資料中心區域延伸的多 VNET 環境
使用 BGP 使用主動 VPN 閘道 站對站 VPN VPN	此範本可讓您在具有 VPN 閘道的兩個 VNet 之間部署站對站 VPN，以使用 BGP 設定主動-主動。 每個 Azure VPN 閘道都會解析遠端對等的 FQDN，以判斷遠端 VPN 閘道的公用 IP。 範本會在具有可用性區域的 Azure 區域中如預期般執行。
使用 Azure 防火牆作為中樞 & 輪輻拓撲中的 DNS Proxy	此範例示範如何使用 Azure 防火牆在 Azure 中部署中樞輪輻拓撲。 中樞虛擬網路可作為透過虛擬網路對等互連連線到中樞虛擬網路之許多輪輻虛擬網路的中央點。

Terraform （AzAPI 提供者） 資源定義

virtualNetworkGateways 資源類型可以使用目標作業來部署：

• 資源群組

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

資源格式

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

resource "azapi_resource" "symbolicname" {
  type = "Microsoft.Network/virtualNetworkGateways@2019-11-01"
  name = "string"
  location = "string"
  body = jsonencode({
    properties = {
      activeActive = bool
      bgpSettings = {
        asn = int
        bgpPeeringAddress = "string"
        peerWeight = int
      }
      customRoutes = {
        addressPrefixes = [
          "string"
        ]
      }
      enableBgp = bool
      enableDnsForwarding = bool
      gatewayDefaultSite = {
        id = "string"
      }
      gatewayType = "string"
      ipConfigurations = [
        {
          id = "string"
          name = "string"
          properties = {
            privateIPAllocationMethod = "string"
            publicIPAddress = {
              id = "string"
            }
            subnet = {
              id = "string"
            }
          }
        }
      ]
      sku = {
        name = "string"
        tier = "string"
      }
      vpnClientConfiguration = {
        aadAudience = "string"
        aadIssuer = "string"
        aadTenant = "string"
        radiusServerAddress = "string"
        radiusServerSecret = "string"
        vpnClientAddressPool = {
          addressPrefixes = [
            "string"
          ]
        }
        vpnClientIpsecPolicies = [
          {
            dhGroup = "string"
            ikeEncryption = "string"
            ikeIntegrity = "string"
            ipsecEncryption = "string"
            ipsecIntegrity = "string"
            pfsGroup = "string"
            saDataSizeKilobytes = int
            saLifeTimeSeconds = int
          }
        ]
        vpnClientProtocols = [
          "string"
        ]
        vpnClientRevokedCertificates = [
          {
            id = "string"
            name = "string"
            properties = {
              thumbprint = "string"
            }
          }
        ]
        vpnClientRootCertificates = [
          {
            id = "string"
            name = "string"
            properties = {
              publicCertData = "string"
            }
          }
        ]
      }
      vpnGatewayGeneration = "string"
      vpnType = "string"
    }
  })
  tags = {
    {customized property} = "string"
  }
}

屬性值

AddressSpace

名字	描述	價值
addressPrefixes	以 CIDR 表示法保留給此虛擬網路的位址區塊清單。	string[]

BgpSettings

名字	描述	價值
asn	BGP 喇叭的 ASN。	int
bgpPeeringAddress	這個 BGP 說話者的 BGP 對等互連位址和 BGP 識別碼。	字串
peerWeight	新增至此 BGP 喇叭所學習路由的權數。	int

IpsecPolicy

名字	描述	價值
dhGroup	在 IKE 階段 1 中用於初始 SA 的 DH 群組。	'DHGroup1' 'DHGroup14' 'DHGroup2' 'DHGroup2048' 'DHGroup24' 'ECP256' 'ECP384' 'None' （必要）
ikeEncryption	IKE 加密演算法 （IKE 階段 2）。	'AES128' 'AES192' 'AES256' 'DES' 'DES3' 'GCMAES128' 'GCMAES256' （必要）
ikeIntegrity	IKE 完整性演算法 （IKE 階段 2）。	'GCMAES128' 'GCMAES256' 'MD5' 'SHA1' 'SHA256' 'SHA384' （必要）
ipsecEncryption	IPSec 加密演算法 （IKE 階段 1）。	'AES128' 'AES192' 'AES256' 'DES' 'DES3' 'GCMAES128' 'GCMAES192' 'GCMAES256' 'None' （必要）
ipsecIntegrity	IPSec 完整性演算法 （IKE 階段 1）。	'GCMAES128' 'GCMAES192' 'GCMAES256' 'MD5' 'SHA1' 'SHA256' （必要）
pfsGroup	IKE 階段 2 中用於新子 SA 的 Pfs 群組。	'ECP256' 'ECP384' 'None' 'PFS1' 'PFS14' 'PFS2' 'PFS2048' 'PFS24' 'PFSMM' （必要）
saDataSizeKilobytes	IPSec 安全性關聯 （也稱為快速模式或階段 2 SA） 承載大小 KB，適用於站對站 VPN 通道。	int （必要）
saLifeTimeSeconds	IPSec 安全性關聯 （也稱為快速模式或階段 2 SA） 存留期，以秒為單位，用於站對站 VPN 通道。	int （必要）

Microsoft.Network/virtualNetworkGateways

名字	描述	價值
位置	資源位置。	字串
名字	資源名稱	字串 （必要）
性能	虛擬網路閘道的屬性。	VirtualNetworkGatewayPropertiesFormat （必要）
標籤	資源標籤	標記名稱和值的字典。
類型	資源類型	“Microsoft.Network/virtualNetworkGateways@2019-11-01”

ResourceTags

名字	描述	價值

SubResource

名字	描述	價值
id	資源標識碼。	字串

VirtualNetworkGatewayIPConfiguration

名字	描述	價值
id	資源標識碼。	字串
名字	資源群組內唯一的資源名稱。 此名稱可用來存取資源。	字串
性能	虛擬網路閘道IP組態的屬性。	VirtualNetworkGatewayIPConfigurationPropertiesFormat

VirtualNetworkGatewayIPConfigurationPropertiesFormat

名字	描述	價值
privateIPAllocationMethod	私人IP位址配置方法。	'Dynamic' 'Static'
publicIPAddress	公用IP資源的參考。	SubResource
子	子網資源的參考。	SubResource

VirtualNetworkGatewayPropertiesFormat

名字	描述	價值
activeActive	ActiveActive 旗標。	bool
bgpSettings	虛擬網路閘道的 BGP 喇叭設定。	BgpSettings
customRoutes	位址空間資源的參考，代表客戶針對虛擬網路網關和 VpnClient 所指定的自定義路由地址空間。	AddressSpace
enableBgp	是否為此虛擬網路閘道啟用 BGP。	bool
enableDnsForwarding	是否啟用 DNS 轉送。	bool
gatewayDefaultSite	LocalNetworkGateway 資源的參考，代表具有預設路由的局域網路網站。 如果移除現有的默認網站設定，請指派 Null 值。	SubResource
gatewayType	此虛擬網路閘道的類型。	'ExpressRoute' 'Vpn'
ipConfigurations	虛擬網路閘道的IP組態。	VirtualNetworkGatewayIPConfiguration[]
sku	VirtualNetworkGatewaySku 資源的參考，代表為虛擬網路網關選取的 SKU。	VirtualNetworkGatewaySku
vpnClientConfiguration	代表 P2S VpnClient 組態之 VpnClientConfiguration 資源的參考。	VpnClientConfiguration
vpnGatewayGeneration	此 VirtualNetworkGateway 的世代。 如果 gatewayType 不是 VPN，則必須是 None。	'Generation1' 'Generation2' 'None'
vpnType	此虛擬網路閘道的類型。	'PolicyBased' 'RouteBased'

VirtualNetworkGatewaySku

名字	描述	價值
名字	閘道 SKU 名稱。	'Basic' 'ErGw1AZ' 'ErGw2AZ' 'ErGw3AZ' 'HighPerformance' 'Standard' 'UltraPerformance' 'VpnGw1' 'VpnGw1AZ' 'VpnGw2' 'VpnGw2AZ' 'VpnGw3' 'VpnGw3AZ' 'VpnGw4' 'VpnGw4AZ' 'VpnGw5' 'VpnGw5AZ'
層	閘道 SKU 層。	'Basic' 'ErGw1AZ' 'ErGw2AZ' 'ErGw3AZ' 'HighPerformance' 'Standard' 'UltraPerformance' 'VpnGw1' 'VpnGw1AZ' 'VpnGw2' 'VpnGw2AZ' 'VpnGw3' 'VpnGw3AZ' 'VpnGw4' 'VpnGw4AZ' 'VpnGw5' 'VpnGw5AZ'

VpnClientConfiguration

名字	描述	價值
aadAudience	用於 AAD 驗證之 Vpn 用戶端連線的 VirtualNetworkGateway 資源的 AADAudience 屬性。	字串
aadIssuer	用於 AAD 驗證之 Vpn 用戶端連線的 VirtualNetworkGateway 資源的 AADIssuer 屬性。	字串
aadTenant	用於 AAD 驗證之 Vpn 用戶端連線的 VirtualNetworkGateway 資源的 AADTenant 屬性。	字串
radiusServerAddress	VPN 用戶端連線 VirtualNetworkGateway 資源的 radius 伺服器地址屬性。	字串
radiusServerSecret	Vpn 用戶端連線的 VirtualNetworkGateway 資源的 radius 秘密屬性。	字串
vpnClientAddressPool	地址空間資源的參考，代表 P2S VpnClient 的地址空間。	AddressSpace
vpnClientIpsecPolicies	虛擬網路閘道 P2S 用戶端的 VpnClientIpsecPolicies。	IpsecPolicy[]
vpnClientProtocols	虛擬網路閘道的 VpnClientProtocols。	包含任何的字串數組： 'IkeV2' 'OpenVPN' 'SSTP'
vpnClientRevokedCertificates	虛擬網路閘道的 VpnClientRevokedCertificate。	VpnClientRevokedCertificate[]
vpnClientRootCertificates	虛擬網路閘道的 VpnClientRootCertificate。	VpnClientRootCertificate[]

VpnClientRevokedCertificate

名字	描述	價值
id	資源標識碼。	字串
名字	資源群組內唯一的資源名稱。 此名稱可用來存取資源。	字串
性能	VPN 用戶端撤銷憑證的屬性。	VpnClientRevokedCertificatePropertiesFormat

VpnClientRevokedCertificatePropertiesFormat

名字	描述	價值
指紋	撤銷的 VPN 用戶端憑證指紋。	字串

VpnClientRootCertificate

名字	描述	價值
id	資源標識碼。	字串
名字	資源群組內唯一的資源名稱。 此名稱可用來存取資源。	字串
性能	vpn 用戶端跟證書的屬性。	VpnClientRootCertificatePropertiesFormat （必要）

VpnClientRootCertificatePropertiesFormat

名字	描述	價值
publicCertData	憑證公用數據。	字串 （必要）