Share via


New-AzExpressRouteGateway

Crea un gateway ExpressRoute scalabile.

Sintassi

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>]

Descrizione

New-AzExpressRouteGateway crea un gateway ExpressRoute scalabile. Si tratta della connettività definita dal software per l'ambiente locale ad Azure all'interno di VirtualHub.

Questo gateway può essere ridimensionato in base all'unità di scala specificata in questo o al cmdlet Set-AzExpressRouteGateway.

Una connessione viene configurata da un circuito ExpressRoute locale al gateway scalabile.

ExpressRouteGateway si troverà nella stessa posizione di VirtualHub a cui si fa riferimento.

Esempio

Esempio 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

In precedenza verrà creato un gruppo di risorse, rete WAN virtuale, Rete virtuale, hub virtuale negli Stati Uniti occidentali nel gruppo di risorse "testRG" in Azure. Un gateway ExpressRoute verrà creato successivamente nell'hub virtuale con 2 unità di scala.

Esempio 2

Crea un gateway ExpressRoute scalabile. (generato automaticamente)

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

Parametri

-AsJob

Eseguire il cmdlet in background

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Confirm

Richiede conferma prima di eseguire il cmdlet.

Type:SwitchParameter
Aliases:cf
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-DefaultProfile

Le credenziali, l’account, il tenant e la sottoscrizione usati per comunicare con Azure.

Type:IAzureContextContainer
Aliases:AzContext, AzureRmContext, AzureCredential
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-MaxScaleUnits

Numero massimo di unità di scala per ExpressRouteGateway. Intervallo > valido 2

Type:UInt32
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-MinScaleUnits

Numero minimo di unità di scala per ExpressRouteGateway. Intervallo > valido 2

Type:UInt32
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-Name

Nome della risorsa.

Type:String
Aliases:ResourceName, ExpressRouteGatewayName
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-ResourceGroupName

Nome della risorsa.

Type:String
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-Tag

Tabella hash che rappresenta i tag delle risorse.

Type:Hashtable
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-VirtualHub

VirtualHub a cui deve essere associato questo VpnGateway.

Type:PSVirtualHub
Position:Named
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-VirtualHubId

L'ID di VirtualHub a cui deve essere associato questo VpnGateway.

Type:String
Position:Named
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-VirtualHubName

L'ID di VirtualHub a cui deve essere associato questo VpnGateway.

Type:String
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-WhatIf

Mostra gli effetti dell'esecuzione del cmdlet. Il cmdlet non viene eseguito.

Type:SwitchParameter
Aliases:wi
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

Input

PSVirtualHub

String

Output

PSExpressRouteGateway