Поделиться через

New-AzVirtualNetworkGatewayConnection

Модуль:
Az.Network Module

Создает VPN-подключение типа "сеть — сеть" между шлюзом виртуальной сети и локальным VPN-устройством.

Синтаксис

SetByResource (По умолчанию) 

New-AzVirtualNetworkGatewayConnection
    -Name <String>
    -ResourceGroupName <String>
    -Location <String>
    -VirtualNetworkGateway1 <PSVirtualNetworkGateway>
    -ConnectionType <String>
    [-AuthorizationKey <String>]
    [-VirtualNetworkGateway2 <PSVirtualNetworkGateway>]
    [-LocalNetworkGateway2 <PSLocalNetworkGateway>]
    [-RoutingWeight <Int32>]
    [-DpdTimeoutInSeconds <Int32>]
    [-ConnectionMode <String>]
    [-SharedKey <String>]
    [-Peer <PSPeering>]
    [-EnableBgp <Boolean>]
    [-UseLocalAzureIpAddress]
    [-Tag <Hashtable>]
    [-Force]
    [-UsePolicyBasedTrafficSelectors <Boolean>]
    [-IpsecPolicies <PSIpsecPolicy[]>]
    [-TrafficSelectorPolicy <PSTrafficSelectorPolicy[]>]
    [-ConnectionProtocol <String>]
    [-IngressNatRule <PSResourceId[]>]
    [-EgressNatRule <PSResourceId[]>]
    [-GatewayCustomBgpIpAddress <PSGatewayCustomBgpIpConfiguration[]>]
    [-AuthenticationType <String>]
    [-CertificateAuthentication <PSCertificateAuthentication>]
    [-AsJob]
    [-ExpressRouteGatewayBypass]
    [-EnablePrivateLinkFastPath]
    [-DefaultProfile <IAzureContextContainer>]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

SetByResourceId 

New-AzVirtualNetworkGatewayConnection
    -Name <String>
    -ResourceGroupName <String>
    -Location <String>
    -VirtualNetworkGateway1 <PSVirtualNetworkGateway>
    -ConnectionType <String>
    [-AuthorizationKey <String>]
    [-VirtualNetworkGateway2 <PSVirtualNetworkGateway>]
    [-LocalNetworkGateway2 <PSLocalNetworkGateway>]
    [-RoutingWeight <Int32>]
    [-DpdTimeoutInSeconds <Int32>]
    [-ConnectionMode <String>]
    [-SharedKey <String>]
    [-PeerId <String>]
    [-EnableBgp <Boolean>]
    [-UseLocalAzureIpAddress]
    [-Tag <Hashtable>]
    [-Force]
    [-UsePolicyBasedTrafficSelectors <Boolean>]
    [-IpsecPolicies <PSIpsecPolicy[]>]
    [-TrafficSelectorPolicy <PSTrafficSelectorPolicy[]>]
    [-ConnectionProtocol <String>]
    [-IngressNatRule <PSResourceId[]>]
    [-EgressNatRule <PSResourceId[]>]
    [-GatewayCustomBgpIpAddress <PSGatewayCustomBgpIpConfiguration[]>]
    [-AuthenticationType <String>]
    [-CertificateAuthentication <PSCertificateAuthentication>]
    [-AsJob]
    [-ExpressRouteGatewayBypass]
    [-EnablePrivateLinkFastPath]
    [-DefaultProfile <IAzureContextContainer>]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

Описание

Создает VPN-подключение типа "сеть — сеть" между шлюзом виртуальной сети и локальным VPN-устройством.

Примеры

Пример 1

$vnetgw1 = Get-AzVirtualNetworkGateway -ResourceGroupName "Rg1" -Name "gw1"
$vnetgw2 = Get-AzVirtualNetworkGateway -ResourceGroupName "Rg1" -Name "gw2"
New-AzVirtualNetworkGatewayConnection -Name conn-client-1 -ResourceGroupName "Rg1" -VirtualNetworkGateway1 $vnetgw1 -VirtualNetworkGateway2 $vnetgw2 -Location "eastus" -ConnectionType Vnet2Vnet -SharedKey 'a1b2c3d4e5'

Пример 2. Добавление и обновление ingressNatRule/EgressNatRule к существующему подключению шлюза виртуальной сети

$vnetgw1 = Get-AzVirtualNetworkGateway -ResourceGroupName "Rg1" -Name "vnetgw1"
$vnetgw2 = Get-AzVirtualNetworkGateway -ResourceGroupName "Rg1" -Name "vnetgw2"
$ingressnatrule = Get-AzVirtualNetworkGatewayNatRule -ResourceGroupName "Rg1" -Name "natRule1" -ParentResourceName vnetgw1
$egressnatrule = Get-AzVirtualNetworkGatewayNatRule -ResourceGroupName "Rg1" -Name "natRule2" -ParentResourceName vnetgw1
New-AzVirtualNetworkGatewayConnection -Name conn-client-1 -ResourceGroupName $RG1 -VirtualNetworkGateway1 $vnetgw1 -VirtualNetworkGateway2 $vnetgw2 -Location "eastus" -ConnectionType Vnet2Vnet -SharedKey 'a1b2c3d4e5' `
-IngressNatRule $ingressnatrule -EgressNatRule $egressnatrule

Первая команда получает шлюз виртуальной сети natRule с именем natRule1, который является типом IngressSnat. Вторая команда получает шлюз виртуальной сети natRule с именем natRule2, который является типом EgressSnat. Третья команда создает это новое подключение шлюза виртуальной сети с Ingress и Egress NatRules.

Пример 3. Добавление шлюза GatewayCustomBgpIpAddress в подключение шлюза виртуальной сети

$LocalnetGateway = Get-AzLocalNetworkGateway -ResourceGroupName "PS_testing" -name "testLng"
$gateway = Get-AzVirtualNetworkGateway -ResourceGroupName PS_testing -ResourceName testGw
$address = New-AzGatewayCustomBgpIpConfigurationObject -IpConfigurationId "/subscriptions/83704d68-d560-4c67-b1c7-12404db89dc3/resourceGroups/PS_testing/providers/Microsoft.Network/virtualNetworkGateways/testGw/ipConfigurations/default" -CustomBgpIpAddress "169.254.21.1"

New-AzVirtualNetworkGatewayConnection -ResourceGroupName "PS_testing" -name "Conn" -location "eastus" -VirtualNetworkGateway1 $gateway -LocalNetworkGateway2 $localnetGateway -ConnectionType IPsec -RoutingWeight 3 -SharedKey abc -GatewayCustomBgpIpAddress $address -EnableBgp $true

Эта команда получает шлюз локальной сети и шлюз виртуальной сети. Третья команда создает AzGatewayCustomBgpIpConfigurationObject. Третья команда создает это новое подключение шлюза виртуальной сети к gatewayCustomBgpIpAddress.

Пример 4. Создание подключения шлюза виртуальной сети с проверкой подлинности на основе сертификатов

$gateway = Get-AzVirtualNetworkGateway -ResourceGroupName "myResourceGroup" -Name "myVnetGateway"
$localGateway = Get-AzLocalNetworkGateway -ResourceGroupName "myResourceGroup" -Name "myLocalGateway"

# Create certificate chain array with base64-encoded certificates (without BEGIN/END CERTIFICATE headers)
$certChain = @(
    "MIIDfzCCAmegAwIBAgIQIFxjNWTuGjYGa8zJVnpfnDANBgkqhkiG9w0BAQsFADAYMRYwFAYDVQQDDA1DZXJ0QmFzZWRBdXRoMB4XDTI0MTIxODA1MjkzOVoXDTI1MTIxODA2MDk...",
    "MIIDezCCAmOgAwIBAgIQQIpJdJF8D8JwkqF6fJ6zGDANBgkqhkiG9w0BAQsFADAYMRYwFAYDVQQDDA1DZXJ0QmFzZWRBdXRoMB4XDTI0MTIxODA1MjkzOVoXDTI1MTIxODA2MDk..."
)

$certAuth = New-AzVirtualNetworkGatewayCertificateAuthentication `
    -OutboundAuthCertificate "https://myvault.vault.azure.net/certificates/mycert/abc123" `
    -InboundAuthCertificateSubjectName "MyCertSubject" `
    -InboundAuthCertificateChain $certChain

New-AzVirtualNetworkGatewayConnection -Name "myCertConnection" -ResourceGroupName "myResourceGroup" -Location "eastus" `
    -VirtualNetworkGateway1 $gateway -LocalNetworkGateway2 $localGateway -ConnectionType IPsec `
    -AuthenticationType "Certificate" -CertificateAuthentication $certAuth

В этом примере создается новое подключение шлюза виртуальной сети с проверкой подлинности на основе сертификатов. Первые две команды получают шлюз виртуальной сети и локальный сетевой шлюз. Командлет New-AzVirtualNetworkGatewayCertificateAuthentication создает конфигурацию проверки подлинности сертификата с URL-адресом сертификата Key Vault для исходящей проверки подлинности, именем субъекта сертификата для входящие проверки подлинности и цепочкой сертификатов. Последняя команда создает новое подключение с проверкой подлинности на основе сертификатов вместо предварительного общего ключа.

Параметры

-AsJob

Запуск командлета в фоновом режиме

Свойства параметров

Тип:SwitchParameter
Default value:None
Поддерживаются подстановочные знаки:False
DontShow:False

Наборы параметров

(All)
Position:Named
Обязательно:False
Значение из конвейера:False
Значение из конвейера по имени свойства:False
Значение из оставшихся аргументов:False

-AuthenticationType

Тип аутентификации подключения к шлюзу.

Свойства параметров

Тип:String
Default value:None
Допустимые значения:PSK, Certificate
Поддерживаются подстановочные знаки:False
DontShow:False

Наборы параметров

(All)
Position:Named
Обязательно:False
Значение из конвейера:False
Значение из конвейера по имени свойства:True
Значение из оставшихся аргументов:False

-AuthorizationKey

AuthorizationKey.

Свойства параметров

Тип:String
Default value:None
Поддерживаются подстановочные знаки:False
DontShow:False

Наборы параметров

(All)
Position:Named
Обязательно:False
Значение из конвейера:False
Значение из конвейера по имени свойства:True
Значение из оставшихся аргументов:False

-CertificateAuthentication

Сведения о проверке подлинности сертификата для подключения проверки подлинности на основе сертификатов.

Свойства параметров

Тип:PSCertificateAuthentication
Default value:None
Поддерживаются подстановочные знаки:False
DontShow:False

Наборы параметров

(All)
Position:Named
Обязательно:False
Значение из конвейера:False
Значение из конвейера по имени свойства:True
Значение из оставшихся аргументов:False

-Confirm

Запрашивает подтверждение перед запуском cmdlet.

Свойства параметров

Тип:SwitchParameter
Default value:None
Поддерживаются подстановочные знаки:False
DontShow:False
Aliases:cf

Наборы параметров

(All)
Position:Named
Обязательно:False
Значение из конвейера:False
Значение из конвейера по имени свойства:False
Значение из оставшихся аргументов:False

-ConnectionMode

Режим подключения шлюза виртуальной сети.

Свойства параметров

Тип:String
Default value:None
Поддерживаются подстановочные знаки:False
DontShow:False

Наборы параметров

(All)
Position:Named
Обязательно:False
Значение из конвейера:False
Значение из конвейера по имени свойства:False
Значение из оставшихся аргументов:False

-ConnectionProtocol

Протокол подключения шлюза:IKEv1/IKEv2

Свойства параметров

Тип:String
Default value:None
Допустимые значения:IKEv1, IKEv2
Поддерживаются подстановочные знаки:False
DontShow:False

Наборы параметров

(All)
Position:Named
Обязательно:False
Значение из конвейера:False
Значение из конвейера по имени свойства:False
Значение из оставшихся аргументов:False

-ConnectionType

Тип подключения шлюза:IPsec/Vnet2Vnet/ExpressRoute/VPNClient

Свойства параметров

Тип:String
Default value:None
Допустимые значения:IPsec, Vnet2Vnet, ExpressRoute, VPNClient
Поддерживаются подстановочные знаки:False
DontShow:False

Наборы параметров

(All)
Position:Named
Обязательно:True
Значение из конвейера:False
Значение из конвейера по имени свойства:True
Значение из оставшихся аргументов:False

-DefaultProfile

Учетные данные, учетная запись, клиент и подписка, используемые для взаимодействия с Azure.

Свойства параметров

Тип:IAzureContextContainer
Default value:None
Поддерживаются подстановочные знаки:False
DontShow:False
Aliases:AzContext, AzureRmContext, AzureCredential

Наборы параметров

(All)
Position:Named
Обязательно:False
Значение из конвейера:False
Значение из конвейера по имени свойства:False
Значение из оставшихся аргументов:False

-DpdTimeoutInSeconds

Время ожидания обнаружения недоставленных одноранговых узлов подключения в секундах.

Свойства параметров

Тип:Int32
Default value:None
Поддерживаются подстановочные знаки:False
DontShow:False

Наборы параметров

(All)
Position:Named
Обязательно:False
Значение из конвейера:False
Значение из конвейера по имени свойства:True
Значение из оставшихся аргументов:False

-EgressNatRule

Список правил NAT исходящего трафика, связанных с этим подключением.

Свойства параметров

Тип:

PSResourceId[]

Default value:None
Поддерживаются подстановочные знаки:False
DontShow:False

Наборы параметров

(All)
Position:Named
Обязательно:False
Значение из конвейера:False
Значение из конвейера по имени свойства:False
Значение из оставшихся аргументов:False

-EnableBgp

Установка сеанса BGP через vpn-туннель S2S

Свойства параметров

Тип:Boolean
Default value:None
Поддерживаются подстановочные знаки:False
DontShow:False

Наборы параметров

(All)
Position:Named
Обязательно:False
Значение из конвейера:False
Значение из конвейера по имени свойства:True
Значение из оставшихся аргументов:False

-EnablePrivateLinkFastPath

Обход шлюза ExpressRoute при доступе к закрытым ссылкам. Необходимо включить ExpressRoute FastPath (ExpressRouteGatewayBypass).

Свойства параметров

Тип:SwitchParameter
Default value:None
Поддерживаются подстановочные знаки:False
DontShow:False

Наборы параметров

(All)
Position:Named
Обязательно:False
Значение из конвейера:False
Значение из конвейера по имени свойства:True
Значение из оставшихся аргументов:False

-ExpressRouteGatewayBypass

Использование ускоренного доступа к виртуальной сети путем обхода шлюза

Свойства параметров

Тип:SwitchParameter
Default value:None
Поддерживаются подстановочные знаки:False
DontShow:False

Наборы параметров

(All)
Position:Named
Обязательно:False
Значение из конвейера:False
Значение из конвейера по имени свойства:True
Значение из оставшихся аргументов:False

-Force

Не запрашивайте подтверждение, если вы хотите перезаписать ресурс

Свойства параметров

Тип:SwitchParameter
Default value:None
Поддерживаются подстановочные знаки:False
DontShow:False

Наборы параметров

(All)
Position:Named
Обязательно:False
Значение из конвейера:False
Значение из конвейера по имени свойства:False
Значение из оставшихся аргументов:False

-GatewayCustomBgpIpAddress

Шлюз GatewayCustomBgpIpAddress шлюза виртуальной сети, используемый в этом подключении.

Свойства параметров

Тип:

PSGatewayCustomBgpIpConfiguration[]

Default value:None
Поддерживаются подстановочные знаки:False
DontShow:False

Наборы параметров

(All)
Position:Named
Обязательно:False
Значение из конвейера:False
Значение из конвейера по имени свойства:True
Значение из оставшихся аргументов:False

-IngressNatRule

Список правил NAT для входящего трафика, связанных с этим подключением.

Свойства параметров

Тип:

PSResourceId[]

Default value:None
Поддерживаются подстановочные знаки:False
DontShow:False

Наборы параметров

(All)
Position:Named
Обязательно:False
Значение из конвейера:False
Значение из конвейера по имени свойства:False
Значение из оставшихся аргументов:False

-IpsecPolicies

Список политик IPSec.

Свойства параметров

Тип:

PSIpsecPolicy[]

Default value:None
Поддерживаются подстановочные знаки:False
DontShow:False

Наборы параметров

(All)
Position:Named
Обязательно:False
Значение из конвейера:False
Значение из конвейера по имени свойства:True
Значение из оставшихся аргументов:False

-LocalNetworkGateway2

шлюз локальной сети.

Свойства параметров

Тип:PSLocalNetworkGateway
Default value:None
Поддерживаются подстановочные знаки:False
DontShow:False

Наборы параметров

(All)
Position:Named
Обязательно:False
Значение из конвейера:False
Значение из конвейера по имени свойства:True
Значение из оставшихся аргументов:False

-Location

местоположение.

Свойства параметров

Тип:String
Default value:None
Поддерживаются подстановочные знаки:False
DontShow:False

Наборы параметров

(All)
Position:Named
Обязательно:True
Значение из конвейера:False
Значение из конвейера по имени свойства:True
Значение из оставшихся аргументов:False

-Name

Имя ресурса.

Свойства параметров

Тип:String
Default value:None
Поддерживаются подстановочные знаки:False
DontShow:False
Aliases:ИмяРесурса

Наборы параметров

(All)
Position:Named
Обязательно:True
Значение из конвейера:False
Значение из конвейера по имени свойства:True
Значение из оставшихся аргументов:False

-Peer

Пэр

Свойства параметров

Тип:PSPeering
Default value:None
Поддерживаются подстановочные знаки:False
DontShow:False

Наборы параметров

SetByResource
Position:Named
Обязательно:False
Значение из конвейера:False
Значение из конвейера по имени свойства:True
Значение из оставшихся аргументов:False

-PeerId

PeerId

Свойства параметров

Тип:String
Default value:None
Поддерживаются подстановочные знаки:False
DontShow:False

Наборы параметров

SetByResourceId
Position:Named
Обязательно:False
Значение из конвейера:False
Значение из конвейера по имени свойства:True
Значение из оставшихся аргументов:False

-ResourceGroupName

Имя группы ресурсов.

Свойства параметров

Тип:String
Default value:None
Поддерживаются подстановочные знаки:False
DontShow:False

Наборы параметров

(All)
Position:Named
Обязательно:True
Значение из конвейера:False
Значение из конвейера по имени свойства:True
Значение из оставшихся аргументов:False

-RoutingWeight

Маршрутизация в весе.

Свойства параметров

Тип:Int32
Default value:None
Поддерживаются подстановочные знаки:False
DontShow:False

Наборы параметров

(All)
Position:Named
Обязательно:False
Значение из конвейера:False
Значение из конвейера по имени свойства:True
Значение из оставшихся аргументов:False

-SharedKey

Ключ общего ресурса Ipsec.

Свойства параметров

Тип:String
Default value:None
Поддерживаются подстановочные знаки:False
DontShow:False

Наборы параметров

(All)
Position:Named
Обязательно:False
Значение из конвейера:False
Значение из конвейера по имени свойства:True
Значение из оставшихся аргументов:False

-Tag

Хэш-файл, представляющий теги ресурсов.

Свойства параметров

Тип:Hashtable
Default value:None
Поддерживаются подстановочные знаки:False
DontShow:False

Наборы параметров

(All)
Position:Named
Обязательно:False
Значение из конвейера:False
Значение из конвейера по имени свойства:True
Значение из оставшихся аргументов:False

-TrafficSelectorPolicy

Список политик селектора трафика.

Свойства параметров

Тип:

PSTrafficSelectorPolicy[]

Default value:None
Поддерживаются подстановочные знаки:False
DontShow:False

Наборы параметров

(All)
Position:Named
Обязательно:False
Значение из конвейера:False
Значение из конвейера по имени свойства:True
Значение из оставшихся аргументов:False

-UseLocalAzureIpAddress

Следует ли использовать PrivateIP для этого VPN-туннеля S2S

Свойства параметров

Тип:SwitchParameter
Default value:None
Поддерживаются подстановочные знаки:False
DontShow:False

Наборы параметров

(All)
Position:Named
Обязательно:False
Значение из конвейера:False
Значение из конвейера по имени свойства:True
Значение из оставшихся аргументов:False

-UsePolicyBasedTrafficSelectors

Использование селекторов трафика на основе политик для подключения S2S

Свойства параметров

Тип:Boolean
Default value:None
Поддерживаются подстановочные знаки:False
DontShow:False

Наборы параметров

(All)
Position:Named
Обязательно:False
Значение из конвейера:False
Значение из конвейера по имени свойства:False
Значение из оставшихся аргументов:False

-VirtualNetworkGateway1

Первый шлюз виртуальной сети.

Свойства параметров

Тип:PSVirtualNetworkGateway
Default value:None
Поддерживаются подстановочные знаки:False
DontShow:False

Наборы параметров

(All)
Position:Named
Обязательно:True
Значение из конвейера:False
Значение из конвейера по имени свойства:True
Значение из оставшихся аргументов:False

-VirtualNetworkGateway2

Второй шлюз виртуальной сети.

Свойства параметров

Тип:PSVirtualNetworkGateway
Default value:None
Поддерживаются подстановочные знаки:False
DontShow:False

Наборы параметров

(All)
Position:Named
Обязательно:False
Значение из конвейера:False
Значение из конвейера по имени свойства:True
Значение из оставшихся аргументов:False

-WhatIf

Показывает, что произойдет, если командлет будет запущен. Командлет не запускается.

Свойства параметров

Тип:SwitchParameter
Default value:None
Поддерживаются подстановочные знаки:False
DontShow:False
Aliases:wi

Наборы параметров

(All)
Position:Named
Обязательно:False
Значение из конвейера:False
Значение из конвейера по имени свойства:False
Значение из оставшихся аргументов:False

CommonParameters

Этот командлет поддерживает общие параметры: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction и -WarningVariable. Дополнительные сведения см. в разделе about_CommonParameters.

Входные данные

String

PSVirtualNetworkGateway

PSLocalNetworkGateway

Int32

PSPeering

Boolean

SwitchParameter

Hashtable

PSIpsecPolicy

PSTrafficSelectorPolicy

PSGatewayCustomBgpIpConfiguration

Выходные данные

PSVirtualNetworkGatewayConnection