Partilhar via


New-AzExpressRouteGateway

Cria um gateway de Rota Expressa escalável.

Sintaxe

New-AzExpressRouteGateway
   -ResourceGroupName <String>
   -Name <String>
   -MinScaleUnits <UInt32>
   [-MaxScaleUnits <UInt32>]
   -VirtualHubName <String>
   [-Tag <Hashtable>]
   [-AsJob]
   [-DefaultProfile <IAzureContextContainer>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]
New-AzExpressRouteGateway
   -ResourceGroupName <String>
   -Name <String>
   -MinScaleUnits <UInt32>
   [-MaxScaleUnits <UInt32>]
   -VirtualHub <PSVirtualHub>
   [-Tag <Hashtable>]
   [-AsJob]
   [-DefaultProfile <IAzureContextContainer>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]
New-AzExpressRouteGateway
   -ResourceGroupName <String>
   -Name <String>
   -MinScaleUnits <UInt32>
   [-MaxScaleUnits <UInt32>]
   -VirtualHubId <String>
   [-Tag <Hashtable>]
   [-AsJob]
   [-DefaultProfile <IAzureContextContainer>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Description

New-AzExpressRouteGateway cria um Gateway de Rota Expressa escalável. Esta é a conectividade definida por software para o Azure no local dentro do VirtualHub.

Esse gateway pode ser dimensionado com base na unidade de escala especificada neste ou no cmdlet Set-AzExpressRouteGateway.

Uma conexão é configurada a partir de um circuito de Rota Expressa local para o gateway escalável.

O ExpressRouteGateway estará no mesmo local que o VirtualHub referenciado.

Exemplos

Exemplo 1

New-AzResourceGroup -Location "West US" -Name "testRG"
$virtualWan = New-AzVirtualWan -ResourceGroupName testRG -Name myVirtualWAN -Location "West US"
$virtualHub = New-AzVirtualHub -VirtualWan $virtualWan -ResourceGroupName "testRG" -Name "westushub" -AddressPrefix "10.0.0.1/24"
New-AzExpressRouteGateway -ResourceGroupName "testRG" -Name "testergw" -VirtualHubId $virtualHub.Id -MinScaleUnits 2

ResourceGroupName   : testRG
Name                : testergw
Id                  : /subscriptions/{subscriptionId}/resourceGroups/testRG/providers/Microsoft.Network/expressRouteGateways/testergw
Location            : West US
MinScaleUnits       : 2
VirtualHub          : /subscriptions/{subscriptionId}/resourceGroups/testRG/providers/Microsoft.Network/virtualHubs/westushub
BgpSettings         : {}
Type                : Microsoft.Network/expressRouteGateways
ProvisioningState   : Succeeded

O acima criará um grupo de recursos, WAN Virtual, Rede Virtual, Hub Virtual no Oeste dos EUA no grupo de recursos "testRG" no Azure. Um gateway ExpressRoute será criado posteriormente no Hub Virtual com 2 unidades de escala.

Exemplo 2

Cria um gateway de Rota Expressa escalável. (gerado automaticamente)

New-AzExpressRouteGateway -MaxScaleUnits <UInt32> -MinScaleUnits 2 -Name 'testExpressRoutegw' -ResourceGroupName 'testRG' -Tag @{"tag1"="value1"; "tag2"="value2"} -VirtualHubName <String>

Parâmetros

-AsJob

Executar cmdlet em segundo plano

Tipo:SwitchParameter
Position:Named
Default value:None
Necessário:False
Aceitar entrada de pipeline:False
Aceitar carateres universais:False

-Confirm

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

Tipo:SwitchParameter
Aliases:cf
Position:Named
Default value:None
Necessário:False
Aceitar entrada de pipeline:False
Aceitar carateres universais:False

-DefaultProfile

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

Tipo:IAzureContextContainer
Aliases:AzContext, AzureRmContext, AzureCredential
Position:Named
Default value:None
Necessário:False
Aceitar entrada de pipeline:False
Aceitar carateres universais:False

-MaxScaleUnits

O número máximo de unidades de escala para este ExpressRouteGateway. Intervalo > válido 2

Tipo:UInt32
Position:Named
Default value:None
Necessário:False
Aceitar entrada de pipeline:False
Aceitar carateres universais:False

-MinScaleUnits

O número mínimo de unidades de escala para este ExpressRouteGateway. Intervalo > válido 2

Tipo:UInt32
Position:Named
Default value:None
Necessário:True
Aceitar entrada de pipeline:False
Aceitar carateres universais:False

-Name

O nome do recurso.

Tipo:String
Aliases:ResourceName, ExpressRouteGatewayName
Position:Named
Default value:None
Necessário:True
Aceitar entrada de pipeline:False
Aceitar carateres universais:False

-ResourceGroupName

O nome do recurso.

Tipo:String
Position:Named
Default value:None
Necessário:True
Aceitar entrada de pipeline:False
Aceitar carateres universais:False

-Tag

Uma hashtable que representa marcas de recursos.

Tipo:Hashtable
Position:Named
Default value:None
Necessário:False
Aceitar entrada de pipeline:False
Aceitar carateres universais:False

-VirtualHub

O VirtualHub ao qual este VpnGateway precisa estar associado.

Tipo:PSVirtualHub
Position:Named
Default value:None
Necessário:True
Aceitar entrada de pipeline:True
Aceitar carateres universais:False

-VirtualHubId

O Id do VirtualHub ao qual este VpnGateway precisa estar associado.

Tipo:String
Position:Named
Default value:None
Necessário:True
Aceitar entrada de pipeline:True
Aceitar carateres universais:False

-VirtualHubName

O Id do VirtualHub ao qual este VpnGateway precisa estar associado.

Tipo:String
Position:Named
Default value:None
Necessário:True
Aceitar entrada de pipeline:False
Aceitar carateres universais:False

-WhatIf

Apresenta o que aconteceria mediante a execução do cmdlet. O cmdlet não é executado.

Tipo:SwitchParameter
Aliases:wi
Position:Named
Default value:None
Necessário:False
Aceitar entrada de pipeline:False
Aceitar carateres universais:False

Entradas

PSVirtualHub

String

Saídas

PSExpressRouteGateway