New-AzExpressRouteGateway
Cria um gateway de Rota Expressa escalável.
Sintaxe
ByVirtualHubName (Predefinição)
New-AzExpressRouteGateway
-ResourceGroupName <String>
-Name <String>
-MinScaleUnits <UInt32>
-VirtualHubName <String>
[-MaxScaleUnits <UInt32>]
[-Tag <Hashtable>]
[-AsJob]
[-DefaultProfile <IAzureContextContainer>]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
ByVirtualHubObject
New-AzExpressRouteGateway
-ResourceGroupName <String>
-Name <String>
-MinScaleUnits <UInt32>
-VirtualHub <PSVirtualHub>
[-MaxScaleUnits <UInt32>]
[-Tag <Hashtable>]
[-AsJob]
[-DefaultProfile <IAzureContextContainer>]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
ByVirtualHubResourceId
New-AzExpressRouteGateway
-ResourceGroupName <String>
-Name <String>
-MinScaleUnits <UInt32>
-VirtualHubId <String>
[-MaxScaleUnits <UInt32>]
[-Tag <Hashtable>]
[-AsJob]
[-DefaultProfile <IAzureContextContainer>]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Description
New-AzExpressRouteGateway cria um Gateway de Rota Expressa escalável. Isto é uma conectividade definida por software para on-premise para o Azure 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, Virtual Hub 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. (autogenerated)
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
Propriedades dos parâmetros
Tipo: SwitchParameter
Default value: None
Suporta carateres universais: False
NãoMostrar: False
Conjuntos de parâmetros
(All)
Position: Named
Obrigatório: False
Valor do pipeline: False
Valor do pipeline por nome de propriedade: False
Valor dos restantes argumentos: False
-Confirm
Solicita confirmação antes de executar o cmdlet.
Propriedades dos parâmetros
Tipo: SwitchParameter
Default value: None
Suporta carateres universais: False
NãoMostrar: False
Aliases: Cf.
Conjuntos de parâmetros
(All)
Position: Named
Obrigatório: False
Valor do pipeline: False
Valor do pipeline por nome de propriedade: False
Valor dos restantes argumentos: False
-DefaultProfile
As credenciais, conta, inquilino e subscrição usados para comunicação com o Azure.
Propriedades dos parâmetros
Tipo: IAzureContextContainer
Default value: None
Suporta carateres universais: False
NãoMostrar: False
Aliases: AzContext, AzureRmContext, AzureCredential
Conjuntos de parâmetros
(All)
Position: Named
Obrigatório: False
Valor do pipeline: False
Valor do pipeline por nome de propriedade: False
Valor dos restantes argumentos: False
-MaxScaleUnits
O número máximo de unidades de escala para este ExpressRouteGateway. Intervalo > válido 2
Propriedades dos parâmetros
Tipo: UInt32
Default value: None
Suporta carateres universais: False
NãoMostrar: False
Conjuntos de parâmetros
(All)
Position: Named
Obrigatório: False
Valor do pipeline: False
Valor do pipeline por nome de propriedade: False
Valor dos restantes argumentos: False
-MinScaleUnits
O número mínimo de unidades de escala para este ExpressRouteGateway. Intervalo > válido 2
Propriedades dos parâmetros
Tipo: UInt32
Default value: None
Suporta carateres universais: False
NãoMostrar: False
Conjuntos de parâmetros
(All)
Position: Named
Obrigatório: True
Valor do pipeline: False
Valor do pipeline por nome de propriedade: False
Valor dos restantes argumentos: False
-Name
O nome do recurso.
Propriedades dos parâmetros
Tipo: String
Default value: None
Suporta carateres universais: False
NãoMostrar: False
Aliases: Nome do Recurso, ExpressRouteGatewayName
Conjuntos de parâmetros
(All)
Position: Named
Obrigatório: True
Valor do pipeline: False
Valor do pipeline por nome de propriedade: False
Valor dos restantes argumentos: False
-ResourceGroupName
O nome do recurso.
Propriedades dos parâmetros
Tipo: String
Default value: None
Suporta carateres universais: False
NãoMostrar: False
Conjuntos de parâmetros
(All)
Position: Named
Obrigatório: True
Valor do pipeline: False
Valor do pipeline por nome de propriedade: False
Valor dos restantes argumentos: False
-Tag
Uma hashtable que representa marcas de recursos.
Propriedades dos parâmetros
Tipo: Hashtable
Default value: None
Suporta carateres universais: False
NãoMostrar: False
Conjuntos de parâmetros
(All)
Position: Named
Obrigatório: False
Valor do pipeline: False
Valor do pipeline por nome de propriedade: False
Valor dos restantes argumentos: False
-VirtualHub
O VirtualHub ao qual este VpnGateway precisa estar associado.
Propriedades dos parâmetros
Tipo: PSVirtualHub
Default value: None
Suporta carateres universais: False
NãoMostrar: False
Conjuntos de parâmetros
ByVirtualHubObject
Position: Named
Obrigatório: True
Valor do pipeline: True
Valor do pipeline por nome de propriedade: False
Valor dos restantes argumentos: False
-VirtualHubId
O Id do VirtualHub ao qual este VpnGateway precisa estar associado.
Propriedades dos parâmetros
Tipo: String
Default value: None
Suporta carateres universais: False
NãoMostrar: False
Conjuntos de parâmetros
ByVirtualHubResourceId
Position: Named
Obrigatório: True
Valor do pipeline: False
Valor do pipeline por nome de propriedade: True
Valor dos restantes argumentos: False
-VirtualHubName
O Id do VirtualHub ao qual este VpnGateway precisa estar associado.
Propriedades dos parâmetros
Tipo: String
Default value: None
Suporta carateres universais: False
NãoMostrar: False
Conjuntos de parâmetros
ByVirtualHubName
Position: Named
Obrigatório: True
Valor do pipeline: False
Valor do pipeline por nome de propriedade: False
Valor dos restantes argumentos: False
-WhatIf
Mostra o que aconteceria se o cmdlet fosse executado.
O cmdlet não é executado.
Propriedades dos parâmetros
Tipo: SwitchParameter
Default value: None
Suporta carateres universais: False
NãoMostrar: False
Aliases: Wi
Conjuntos de parâmetros
(All)
Position: Named
Obrigatório: False
Valor do pipeline: False
Valor do pipeline por nome de propriedade: False
Valor dos restantes argumentos: 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