Compartilhar via


New-AzVirtualHubBgpConnection

O cmdlet New-AzVirtualHubBgpConnection cria um recurso HubBgpConnection que emparelha o WAN Virtual do Azure Hub Router com um par habilitado para BGP em uma rede virtual conectada ao Hub WAN Virtual.

Sintaxe

ByVirtualHubNameByHubVirtualNetworkConnectionObject (Default)

New-AzVirtualHubBgpConnection
    -ResourceGroupName <String>
    -VirtualHubName <String>
    -PeerIp <String>
    -PeerAsn <UInt32>
    -Name <String>
    -VirtualHubVnetConnection <PSHubVirtualNetworkConnection>
    [-AsJob]
    [-DefaultProfile <IAzureContextContainer>]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

ByVirtualHubNameByHubVirtualNetworkConnectionResourceId

New-AzVirtualHubBgpConnection
    -ResourceGroupName <String>
    -VirtualHubName <String>
    -PeerIp <String>
    -PeerAsn <UInt32>
    -Name <String>
    -VirtualHubVnetConnectionId <String>
    [-AsJob]
    [-DefaultProfile <IAzureContextContainer>]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

ByVirtualHubObjectByHubVirtualNetworkConnectionObject

New-AzVirtualHubBgpConnection
    -PeerIp <String>
    -PeerAsn <UInt32>
    -Name <String>
    -VirtualHubVnetConnection <PSHubVirtualNetworkConnection>
    -VirtualHub <PSVirtualHub>
    [-AsJob]
    [-DefaultProfile <IAzureContextContainer>]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

ByVirtualHubResourceIdByHubVirtualNetworkConnectionObject

New-AzVirtualHubBgpConnection
    -PeerIp <String>
    -PeerAsn <UInt32>
    -Name <String>
    -VirtualHubVnetConnection <PSHubVirtualNetworkConnection>
    -VirtualHubId <String>
    [-AsJob]
    [-DefaultProfile <IAzureContextContainer>]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

ByVirtualHubObjectByHubVirtualNetworkConnectionResourceId

New-AzVirtualHubBgpConnection
    -PeerIp <String>
    -PeerAsn <UInt32>
    -Name <String>
    -VirtualHubVnetConnectionId <String>
    -VirtualHub <PSVirtualHub>
    [-AsJob]
    [-DefaultProfile <IAzureContextContainer>]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

ByVirtualHubResourceIdByHubVirtualNetworkConnectionResourceId

New-AzVirtualHubBgpConnection
    -PeerIp <String>
    -PeerAsn <UInt32>
    -Name <String>
    -VirtualHubVnetConnectionId <String>
    -VirtualHubId <String>
    [-AsJob]
    [-DefaultProfile <IAzureContextContainer>]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

Description

O cmdlet New-AzVirtualHubBgpConnection cria um recurso HubBgpConnection que emparelha WAN Virtual do Azure Hub Router com um par habilitado para BGP na rede virtual conectada ao Hub WAN Virtual.

Exemplos

Exemplo 1

New-AzResourceGroup -Location "West US" -Name "testRG"
$frontendSubnet = New-AzVirtualNetworkSubnetConfig -Name frontendSubnet -AddressPrefix "192.168.1.0/24"
$backendSubnet  = New-AzVirtualNetworkSubnetConfig -Name backendSubnet  -AddressPrefix "192.168.2.0/24"
$remoteVirtualNetwork = New-AzVirtualNetwork -Name "testVirtualNetwork" -ResourceGroupName "testRG" -Location "West US" -AddressPrefix "192.168.0.0/16" -Subnet $frontendSubnet,$backendSubnet
$virtualWan = New-AzVirtualWan -ResourceGroupName "testRG" -Name "testWan" -Location "West US"
New-AzVirtualHub -VirtualWan $virtualWan -ResourceGroupName "testRG" -Name "testHub" -AddressPrefix "10.0.1.0/24"
$hubVnetConnection = New-AzVirtualHubVnetConnection -ResourceGroupName "testRG" -VirtualHubName "testHub" -Name "testVnetConnection" -RemoteVirtualNetwork $remoteVirtualNetwork
New-AzVirtualHubBgpConnection -ResourceGroupName "testRG" -VirtualHubName "testHub" -PeerIp 192.168.1.5 -PeerAsn 20000 -Name "testBgpConnection" -VirtualHubVnetConnection $hubVnetConnection
Name                        : testBgpConnection
Id                          : /subscriptions/{subscriptionId}/resourceGroups/testRG/providers/Microsoft.Network/virtualHubs/testHub/bgpConnections/testBgpConnection
HubVirtualNetworkConnection : /subscriptions/{subscriptionId}/resourceGroups/testRG/providers/Microsoft.Network/virtualHubs/testHub/hubVirtualNetworkConnections/testVnetConnection
PeerAsn                     : 20000
PeerIp                      : 192.168.1.5

O acima criará um grupo de recursos, WAN Virtual, Rede Virtual, WAN Virtual Hub no Oeste dos EUA e conectará o Rede Virtual ao Hub WAN Virtual nesse grupo de recursos no Azure. Uma conexão BGP do Hub WAN Virtual será criada posteriormente, o que emparelhará o Hub WAN Virtual com o dispositivo de rede implantado no Rede Virtual.

Exemplo 2

$hubVnetConnection = Get-AzVirtualHubVnetConnection -ResourceGroupName "testRG" -VirtualHubName "testHub" -Name "testVnetConnection"
Get-AzVirtualHub -ResourceGroupName "testRG" -Name "testHub" | New-AzVirtualHubBgpConnection -PeerIp 192.168.1.5 -PeerAsn 20000 -Name "testBgpConnection" -VirtualHubVnetConnection $hubVnetConnection
Name                        : testBgpConnection
Id                          : /subscriptions/{subscriptionId}/resourceGroups/testRG/providers/Microsoft.Network/virtualHubs/testHub/bgpConnections/testBgpConnection
HubVirtualNetworkConnection : /subscriptions/{subscriptionId}/resourceGroups/testRG/providers/Microsoft.Network/virtualHubs/testHub/hubVirtualNetworkConnections/testVnetConnection
PeerAsn                     : 20000
PeerIp                      : 192.168.1.5

O acima criará uma conexão BGP do Hub WAN Virtual para o Hub WAN Virtual existente e a conexão de Vnet do Hub WAN Virtual usando a tubulação do PowerShell na saída do Get-AzVirtualHub.

Parâmetros

-AsJob

Executar cmdlet em segundo plano

Propriedades do parâmetro

Tipo:SwitchParameter
Valor padrão:None
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

(All)
Cargo:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False

-Confirm

Solicita sua confirmação antes de executar o cmdlet.

Propriedades do parâmetro

Tipo:SwitchParameter
Valor padrão:None
Dá suporte a curingas:False
DontShow:False
Aliases:cf

Conjuntos de parâmetros

(All)
Cargo:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False

-DefaultProfile

As credenciais, a conta, o locatário e a assinatura usadas para comunicação com Azure.

Propriedades do parâmetro

Tipo:IAzureContextContainer
Valor padrão:None
Dá suporte a curingas:False
DontShow:False
Aliases:AzContext, AzureRmContext, AzureCredential

Conjuntos de parâmetros

(All)
Cargo:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False

-Name

O nome do recurso.

Propriedades do parâmetro

Tipo:String
Valor padrão:None
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

(All)
Cargo:Named
Obrigatório:True
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False

-PeerAsn

O ASN do par.

Propriedades do parâmetro

Tipo:UInt32
Valor padrão:None
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

(All)
Cargo:Named
Obrigatório:True
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False

-PeerIp

O IP par.

Propriedades do parâmetro

Tipo:String
Valor padrão:None
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

(All)
Cargo:Named
Obrigatório:True
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False

-ResourceGroupName

O nome do grupo de recursos.

Propriedades do parâmetro

Tipo:String
Valor padrão:None
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

ByVirtualHubNameByHubVirtualNetworkConnectionObject
Cargo:Named
Obrigatório:True
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False
ByVirtualHubNameByHubVirtualNetworkConnectionResourceId
Cargo:Named
Obrigatório:True
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False

-VirtualHub

O recurso do hub virtual.

Propriedades do parâmetro

Tipo:PSVirtualHub
Valor padrão:None
Dá suporte a curingas:False
DontShow:False
Aliases:ParentObject, ParentVirtualHub

Conjuntos de parâmetros

ByVirtualHubObjectByHubVirtualNetworkConnectionObject
Cargo:Named
Obrigatório:True
Valor do pipeline:True
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False
ByVirtualHubObjectByHubVirtualNetworkConnectionResourceId
Cargo:Named
Obrigatório:True
Valor do pipeline:True
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False

-VirtualHubId

A ID do recurso do hub virtual.

Propriedades do parâmetro

Tipo:String
Valor padrão:None
Dá suporte a curingas:False
DontShow:False
Aliases:ParentResourceId, ParentVirtualHubId

Conjuntos de parâmetros

ByVirtualHubResourceIdByHubVirtualNetworkConnectionObject
Cargo:Named
Obrigatório:True
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False
ByVirtualHubResourceIdByHubVirtualNetworkConnectionResourceId
Cargo:Named
Obrigatório:True
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False

-VirtualHubName

O nome do hub virtual.

Propriedades do parâmetro

Tipo:String
Valor padrão:None
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

ByVirtualHubNameByHubVirtualNetworkConnectionObject
Cargo:Named
Obrigatório:True
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False
ByVirtualHubNameByHubVirtualNetworkConnectionResourceId
Cargo:Named
Obrigatório:True
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False

-VirtualHubVnetConnection

O recurso VirtualHubVnetConnection.

Propriedades do parâmetro

Tipo:PSHubVirtualNetworkConnection
Valor padrão:None
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

ByVirtualHubNameByHubVirtualNetworkConnectionObject
Cargo:Named
Obrigatório:True
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False
ByVirtualHubObjectByHubVirtualNetworkConnectionObject
Cargo:Named
Obrigatório:True
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False
ByVirtualHubResourceIdByHubVirtualNetworkConnectionObject
Cargo:Named
Obrigatório:True
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False

-VirtualHubVnetConnectionId

A ID do recurso VirtualHubVnetConnection.

Propriedades do parâmetro

Tipo:String
Valor padrão:None
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

ByVirtualHubNameByHubVirtualNetworkConnectionResourceId
Cargo:Named
Obrigatório:True
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False
ByVirtualHubObjectByHubVirtualNetworkConnectionResourceId
Cargo:Named
Obrigatório:True
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False
ByVirtualHubResourceIdByHubVirtualNetworkConnectionResourceId
Cargo:Named
Obrigatório:True
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False

-WhatIf

Mostra o que aconteceria se o cmdlet fosse executado. O cmdlet não é executado.

Propriedades do parâmetro

Tipo:SwitchParameter
Valor padrão:None
Dá suporte a curingas:False
DontShow:False
Aliases:wi

Conjuntos de parâmetros

(All)
Cargo:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False

CommonParameters

Este cmdlet suporta os parâmetros comuns: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction e -WarningVariable. Para obter mais informações, consulte about_CommonParameters.

Entradas

PSVirtualHub

PSHubVirtualNetworkConnection

String

Saídas

PSBgpConnection