Add-AzVirtualNetworkPeering
Cria um emparelhamento entre duas redes virtuais.
Sintaxe
Default (Padrão)
Add-AzVirtualNetworkPeering
-Name <String>
-VirtualNetwork <PSVirtualNetwork>
-RemoteVirtualNetworkId <String>
[-PeerCompleteVnets <Boolean>]
[-LocalSubnetNames <String[]>]
[-RemoteSubnetNames <String[]>]
[-EnableOnlyIPv6Peering <Boolean>]
[-BlockVirtualNetworkAccess]
[-AllowForwardedTraffic]
[-AllowGatewayTransit]
[-UseRemoteGateways]
[-AsJob]
[-DefaultProfile <IAzureContextContainer>]
[<CommonParameters>]
Descrição
O cmdlet Add-AzVirtualNetworkPeering cria um emparelhamento entre duas redes virtuais.
Exemplos
Exemplo 1: Criar um emparelhamento entre duas redes virtuais na mesma região
# Variables for common values used throughout the script.
$rgName='myResourceGroup'
$location='eastus'
# Create a resource group.
New-AzResourceGroup -Name $rgName -Location $location
# Create virtual network 1.
$vnet1 = New-AzVirtualNetwork -ResourceGroupName $rgName -Name 'myVnet1' -AddressPrefix '10.0.0.0/16' -Location $location
# Create virtual network 2.
$vnet2 = New-AzVirtualNetwork -ResourceGroupName $rgName -Name 'myVnet2' -AddressPrefix '10.1.0.0/16' -Location $location
# Peer VNet1 to VNet2.
Add-AzVirtualNetworkPeering -Name 'myVnet1ToMyVnet2' -VirtualNetwork $vnet1 -RemoteVirtualNetworkId $vnet2.Id
# Peer VNet2 to VNet1.
Add-AzVirtualNetworkPeering -Name 'myVnet2ToMyVnet1' -VirtualNetwork $vnet2 -RemoteVirtualNetworkId $vnet1.Id
Observe que um link de emparelhamento deve ser criado de vnet1 para vnet2 e vice-versa para que o emparelhamento funcione.
Exemplo 2: Criar um emparelhamento entre duas redes virtuais em regiões diferentes
# Variables for common values used throughout the script.
$rgName='myResourceGroup'
# Create a resource group.
New-AzResourceGroup -Name $rgName -Location westcentralus
# Create virtual network 1.
$vnet1 = New-AzVirtualNetwork -ResourceGroupName $rgName -Name 'myVnet1' -AddressPrefix '10.0.0.0/16' -Location westcentralus
# Create virtual network 2.
$vnet2 = New-AzVirtualNetwork -ResourceGroupName $rgName -Name 'myVnet2' -AddressPrefix '10.1.0.0/16' -Location canadacentral
# Peer VNet1 to VNet2.
Add-AzVirtualNetworkPeering -Name 'myVnet1ToMyVnet2' -VirtualNetwork $vnet1 -RemoteVirtualNetworkId $vnet2.Id
# Peer VNet2 to VNet1.
Add-AzVirtualNetworkPeering -Name 'myVnet2ToMyVnet1' -VirtualNetwork $vnet2 -RemoteVirtualNetworkId $vnet1.Id
Aqui 'myVnet1' no Centro-Oeste dos EUA é emparelhado com 'myVnet2' no Canadá Central.
Parâmetros
-AllowForwardedTraffic
Indica que esse cmdlet permite o tráfego encaminhado das máquinas virtuais na rede virtual remota.
Propriedades dos parâmetros
Tipo: SwitchParameter
Valor padrão: None Suporta curingas: False DontShow: False
Conjuntos de parâmetros
(All)
Posição: Named Obrigatório: False Valor do pipeline: False Valor do pipeline por nome da propriedade: False Valor dos argumentos restantes: False
-AllowGatewayTransit
Sinalizador para permitir que gatewayLinks sejam usados no link da rede virtual remota para esta rede virtual
Propriedades dos parâmetros
Tipo: SwitchParameter
Valor padrão: None Suporta curingas: False DontShow: False
Conjuntos de parâmetros
(All)
Posição: Named Obrigatório: False Valor do pipeline: False Valor do pipeline por nome da propriedade: False Valor dos argumentos restantes: False
-AsJob
Executar cmdlet em segundo plano
Propriedades dos parâmetros
Tipo: SwitchParameter
Valor padrão: None Suporta curingas: False DontShow: False
Conjuntos de parâmetros
(All)
Posição: Named Obrigatório: False Valor do pipeline: False Valor do pipeline por nome da propriedade: False Valor dos argumentos restantes: False
-BlockVirtualNetworkAccess
Indica que esse cmdlet bloqueia as máquinas virtuais no espaço de rede virtual vinculado para acessar todas as máquinas virtuais no espaço de rede virtual local.
Propriedades dos parâmetros
Tipo: SwitchParameter
Valor padrão: None Suporta curingas: False DontShow: False
Conjuntos de parâmetros
(All)
Posição: Named Obrigatório: False Valor do pipeline: False Valor do pipeline por nome da propriedade: False Valor dos argumentos restantes: False
-DefaultProfile
As credenciais, a conta, o locatário e a assinatura usados para comunicação com o azure.
Propriedades dos parâmetros
Tipo: IAzureContextContainer
Valor padrão: None Suporta curingas: False DontShow: False Pseudónimos: AzContext, AzureRmContext, AzureCredential
Conjuntos de parâmetros
(All)
Posição: Named Obrigatório: False Valor do pipeline: False Valor do pipeline por nome da propriedade: False Valor dos argumentos restantes: False
-EnableOnlyIPv6Peering
Especifica se este é um emparelhamento somente IPv6
Propriedades dos parâmetros
Conjuntos de parâmetros
(All)
Posição: Named Obrigatório: False Valor do pipeline: False Valor do pipeline por nome da propriedade: False Valor dos argumentos restantes: False
-LocalSubnetNames
Lista de sub-redes locais a serem emparelhadas
Propriedades dos parâmetros
Tipo: String [ ]
Valor padrão: None Suporta curingas: False DontShow: False
Conjuntos de parâmetros
(All)
Posição: Named Obrigatório: False Valor do pipeline: False Valor do pipeline por nome da propriedade: False Valor dos argumentos restantes: False
-Name
Especifica o nome do emparelhamento de rede virtual.
Propriedades dos parâmetros
Tipo: String
Valor padrão: None Suporta curingas: False DontShow: False
Conjuntos de parâmetros
(All)
Posição: Named Obrigatório: True Valor do pipeline: False Valor do pipeline por nome da propriedade: False Valor dos argumentos restantes: False
-PeerCompleteVnets
Especifica se este é um emparelhamento Vnet ou emparelhamento de sub-rede
Propriedades dos parâmetros
Conjuntos de parâmetros
(All)
Posição: Named Obrigatório: False Valor do pipeline: False Valor do pipeline por nome da propriedade: False Valor dos argumentos restantes: False
-RemoteSubnetNames
Lista de sub-redes remotas a serem emparelhadas
Propriedades dos parâmetros
Tipo: String [ ]
Valor padrão: None Suporta curingas: False DontShow: False
Conjuntos de parâmetros
(All)
Posição: Named Obrigatório: False Valor do pipeline: False Valor do pipeline por nome da propriedade: False Valor dos argumentos restantes: False
-RemoteVirtualNetworkId
Especifica a ID da rede virtual remota.
Propriedades dos parâmetros
Tipo: String
Valor padrão: None Suporta curingas: False DontShow: False
Conjuntos de parâmetros
(All)
Posição: Named Obrigatório: True Valor do pipeline: True Valor do pipeline por nome da propriedade: False Valor dos argumentos restantes: False
-UseRemoteGateways
Indica que esse cmdlet permite gateways remotos nessa rede virtual.
Propriedades dos parâmetros
Tipo: SwitchParameter
Valor padrão: None Suporta curingas: False DontShow: False
Conjuntos de parâmetros
(All)
Posição: Named Obrigatório: False Valor do pipeline: False Valor do pipeline por nome da propriedade: False Valor dos argumentos restantes: False
-VirtualNetwork
Especifica a rede virtual pai.
Propriedades dos parâmetros
Conjuntos de parâmetros
(All)
Posição: Named Obrigatório: True Valor do pipeline: True Valor do pipeline por 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 .
Saídas
