New-AzExpressRouteGateway

Vytvoří škálovatelnou bránu ExpressRoute.

Syntaxe

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 vytvoří škálovatelnou bránu ExpressRoute. Toto je softwarově definované připojení pro místní připojení k Azure v rámci VirtualHubu.

Tuto bránu je možné škálovat na základě jednotky škálování zadané v této nebo rutině Set-AzExpressRouteGateway.

Připojení se nastavuje z místního okruhu ExpressRoute do škálovatelné brány.

ExpressRouteGateway bude ve stejném umístění jako odkazovaný VirtualHub.

Příklady

Příklad 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

Výše uvedené informace vytvoří skupinu prostředků Virtual WAN, virtuální síť, virtuální centrum v oblasti USA – západ ve skupině prostředků testRG v Azure. Následně se ve virtuálním centru vytvoří brána ExpressRoute se 2 jednotkami škálování.

Příklad 2

Vytvoří škálovatelnou bránu ExpressRoute. (automaticky vygenerováno)

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

Parametry

-AsJob

Spuštění rutiny na pozadí

Typ:SwitchParameter
Position:Named
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:False
Přijmout zástupné znaky:False

-Confirm

Před spuštěním rutiny zobrazí výzvu k potvrzení.

Typ:SwitchParameter
Aliasy:cf
Position:Named
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:False
Přijmout zástupné znaky:False

-DefaultProfile

Přihlašovací údaje, účet, tenant a předplatné používané ke komunikaci s Azure.

Typ:IAzureContextContainer
Aliasy:AzContext, AzureRmContext, AzureCredential
Position:Named
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:False
Přijmout zástupné znaky:False

-MaxScaleUnits

Maximální počet jednotek škálování pro tento ExpressRouteGateway. Platný rozsah > 2

Typ:UInt32
Position:Named
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:False
Přijmout zástupné znaky:False

-MinScaleUnits

Minimální počet jednotek škálování pro tento ExpressRouteGateway. Platný rozsah > 2

Typ:UInt32
Position:Named
Default value:None
Vyžadováno:True
Přijmout vstup kanálu:False
Přijmout zástupné znaky:False

-Name

Název prostředku.

Typ:String
Aliasy:ResourceName, ExpressRouteGatewayName
Position:Named
Default value:None
Vyžadováno:True
Přijmout vstup kanálu:False
Přijmout zástupné znaky:False

-ResourceGroupName

Název prostředku.

Typ:String
Position:Named
Default value:None
Vyžadováno:True
Přijmout vstup kanálu:False
Přijmout zástupné znaky:False

-Tag

Zatřiďovací tabulka, která představuje značky prostředků.

Typ:Hashtable
Position:Named
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:False
Přijmout zástupné znaky:False

-VirtualHub

VirtualHub tento VpnGateway musí být přidružený.

Typ:PSVirtualHub
Position:Named
Default value:None
Vyžadováno:True
Přijmout vstup kanálu:True
Přijmout zástupné znaky:False

-VirtualHubId

ID VirtualHubu, ke které je potřeba tuto vpnGateway přidružit.

Typ:String
Position:Named
Default value:None
Vyžadováno:True
Přijmout vstup kanálu:True
Přijmout zástupné znaky:False

-VirtualHubName

ID VirtualHubu, ke které je potřeba tuto vpnGateway přidružit.

Typ:String
Position:Named
Default value:None
Vyžadováno:True
Přijmout vstup kanálu:False
Přijmout zástupné znaky:False

-WhatIf

Zobrazuje, co by se stalo při spuštění rutiny. Rutina není spuštěna.

Typ:SwitchParameter
Aliasy:wi
Position:Named
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:False
Přijmout zástupné znaky:False

Vstupy

PSVirtualHub

String

Výstupy

PSExpressRouteGateway