New-AzExpressRouteGateway
Tworzy skalowalną bramę usługi ExpressRoute.
Składnia
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>]
Opis
New-AzExpressRouteGateway tworzy skalowalną bramę usługi ExpressRoute. Jest to łączność zdefiniowana programowo dla platformy Azure lokalnie w usłudze VirtualHub.
Tę bramę można skalować na podstawie jednostki skalowania określonej w tym lub Set-AzExpressRouteGateway polecenia cmdlet.
Połączenie jest konfigurowane z lokalnego obwodu usługi ExpressRoute do skalowalnej bramy.
Brama ExpressRouteGateway będzie znajdować się w tej samej lokalizacji co przywołyną usługę VirtualHub.
Przykłady
Przykład 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
Powyższe polecenie spowoduje utworzenie grupy zasobów, usługi Virtual WAN, sieci wirtualnej, koncentratora wirtualnego w regionie Zachodnie stany USA w grupie zasobów "testRG" na platformie Azure. Brama usługi ExpressRoute zostanie utworzona później w koncentratonie wirtualnym z 2 jednostkami skalowania.
Przykład 2
Tworzy skalowalną bramę usługi ExpressRoute. (automatycznie wygenerowane)
New-AzExpressRouteGateway -MaxScaleUnits <UInt32> -MinScaleUnits 2 -Name 'testExpressRoutegw' -ResourceGroupName 'testRG' -Tag @{"tag1"="value1"; "tag2"="value2"} -VirtualHubName <String>
Parametry
-AsJob
Uruchamianie polecenia cmdlet w tle
Typ: | SwitchParameter |
Position: | Named |
Domyślna wartość: | None |
Wymagane: | False |
Akceptowanie danych wejściowych potoku: | False |
Akceptowanie symboli wieloznacznych: | False |
-Confirm
Monituje o potwierdzenie przed uruchomieniem polecenia cmdlet.
Typ: | SwitchParameter |
Aliasy: | cf |
Position: | Named |
Domyślna wartość: | None |
Wymagane: | False |
Akceptowanie danych wejściowych potoku: | False |
Akceptowanie symboli wieloznacznych: | False |
-DefaultProfile
Poświadczenia, konto, dzierżawa i subskrypcja używane do komunikacji z platformą Azure.
Typ: | IAzureContextContainer |
Aliasy: | AzContext, AzureRmContext, AzureCredential |
Position: | Named |
Domyślna wartość: | None |
Wymagane: | False |
Akceptowanie danych wejściowych potoku: | False |
Akceptowanie symboli wieloznacznych: | False |
-MaxScaleUnits
Maksymalna liczba jednostek skalowania dla tej usługi ExpressRouteGateway. Prawidłowy zakres > 2
Typ: | UInt32 |
Position: | Named |
Domyślna wartość: | None |
Wymagane: | False |
Akceptowanie danych wejściowych potoku: | False |
Akceptowanie symboli wieloznacznych: | False |
-MinScaleUnits
Minimalna liczba jednostek skalowania dla tej bramy ExpressRouteGateway. Prawidłowy zakres > 2
Typ: | UInt32 |
Position: | Named |
Domyślna wartość: | None |
Wymagane: | True |
Akceptowanie danych wejściowych potoku: | False |
Akceptowanie symboli wieloznacznych: | False |
-Name
Nazwa zasobu.
Typ: | String |
Aliasy: | ResourceName, ExpressRouteGatewayName |
Position: | Named |
Domyślna wartość: | None |
Wymagane: | True |
Akceptowanie danych wejściowych potoku: | False |
Akceptowanie symboli wieloznacznych: | False |
-ResourceGroupName
Nazwa zasobu.
Typ: | String |
Position: | Named |
Domyślna wartość: | None |
Wymagane: | True |
Akceptowanie danych wejściowych potoku: | False |
Akceptowanie symboli wieloznacznych: | False |
-Tag
Tabela skrótu reprezentująca tagi zasobów.
Typ: | Hashtable |
Position: | Named |
Domyślna wartość: | None |
Wymagane: | False |
Akceptowanie danych wejściowych potoku: | False |
Akceptowanie symboli wieloznacznych: | False |
-VirtualHub
Z usługą VirtualHub musi być skojarzona ta brama VpnGateway.
Typ: | PSVirtualHub |
Position: | Named |
Domyślna wartość: | None |
Wymagane: | True |
Akceptowanie danych wejściowych potoku: | True |
Akceptowanie symboli wieloznacznych: | False |
-VirtualHubId
Identyfikator usługi VirtualHub, z tym elementem VpnGateway musi być skojarzony.
Typ: | String |
Position: | Named |
Domyślna wartość: | None |
Wymagane: | True |
Akceptowanie danych wejściowych potoku: | True |
Akceptowanie symboli wieloznacznych: | False |
-VirtualHubName
Identyfikator usługi VirtualHub, z tym elementem VpnGateway musi być skojarzony.
Typ: | String |
Position: | Named |
Domyślna wartość: | None |
Wymagane: | True |
Akceptowanie danych wejściowych potoku: | False |
Akceptowanie symboli wieloznacznych: | False |
-WhatIf
Pokazuje, co się stanie, jeśli polecenie cmdlet zostanie uruchomione. Polecenie cmdlet nie jest uruchamiane.
Typ: | SwitchParameter |
Aliasy: | wi |
Position: | Named |
Domyślna wartość: | None |
Wymagane: | False |
Akceptowanie danych wejściowych potoku: | False |
Akceptowanie symboli wieloznacznych: | False |