Set-AzExpressRouteGateway
Aktualizuje škálovatelnou bránu ExpressRoute.
Syntaxe
Set-AzExpressRouteGateway
-ResourceGroupName <String>
-Name <String>
[-MinScaleUnits <UInt32>]
[-MaxScaleUnits <UInt32>]
[-AllowNonVirtualWanTraffic <Boolean>]
[-Tag <Hashtable>]
[-AsJob]
[-DefaultProfile <IAzureContextContainer>]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Set-AzExpressRouteGateway
-InputObject <PSExpressRouteGateway>
[-MinScaleUnits <UInt32>]
[-MaxScaleUnits <UInt32>]
[-AllowNonVirtualWanTraffic <Boolean>]
[-Tag <Hashtable>]
[-AsJob]
[-DefaultProfile <IAzureContextContainer>]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Set-AzExpressRouteGateway
-ResourceId <String>
[-MinScaleUnits <UInt32>]
[-MaxScaleUnits <UInt32>]
[-AllowNonVirtualWanTraffic <Boolean>]
[-Tag <Hashtable>]
[-AsJob]
[-DefaultProfile <IAzureContextContainer>]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Description
Rutina Set-AzExpressRouteGateway umožňuje aktualizovat jednotky škálování pro existující ExpressRouteGateway nebo aktualizovat značky prostředků.
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
Set-AzExpressRouteGateway -ResourceGroupName "testRG" -Name "testergw" -MinScaleUnits 3
ResourceGroupName : testRG
Name : testergw
Id : /subscriptions/{subscriptionId}/resourceGroups/testRG/providers/Microsoft.Network/expressRouteGateways/testergw
Location : West US
MinScaleUnits : 3
Type : Microsoft.Network/expressRouteGateways
ProvisioningState : Succeeded
Výše uvedený postup vytvoří skupinu prostředků testRG, virtual WAN a virtuální centrum v oblasti USA – západ v této skupině prostředků v Azure. Následně se ve virtuálním centru vytvoří brána ExpressRoute se 2 jednotkami škálování, které se pak upraví na 3 jednotky škálování.
Příklad 2: Nakonfigurujte tuto bránu tak, aby přijímala provoz ze sítí mimo Virtual Wan.
Bránu můžete buď načíst, nakonfigurovat její vlastnost AllowNonVirtualWanTraffic a uložit změny do brány, nebo můžete použít přepínač rutiny Set-AzExpressRouteGateway.
# Option 1 - Retrieve the gateway object, configure it to allow traffic from VNets and persist those changes.
$gateway = Get-AzExpressRouteGateway -ResourceGroupName "resourceGroup001" -Name "gateway001"
$gateway.AllowNonVirtualWanTraffic = $true
$gateway = Set-AzExpressRouteGateway -InputObject $gateway
# Option 2 - Use the cmdlet switch
Set-AzExpressRouteGateway -ResourceGroupName "resourceGroup001" -Name "gateway001" -AllowNonVirtualWanTraffic $true
Příklad 3: Nakonfigurujte tuto bránu tak, aby blokovala provoz ze sítí mimo Virtual Wan.
Bránu můžete buď načíst, nakonfigurovat její vlastnost AllowNonVirtualWanTraffic a uložit změny do brány, nebo můžete použít přepínač rutiny Set-AzExpressRouteGateway.
# Option 1 - Retrieve the gateway object, configure it to block traffic from VNets and persist those changes.
$gateway=Get-AzExpressRouteGateway -ResourceGroupName "resourceGroup001" -Name "gateway001"
$gateway.AllowNonVirtualWanTraffic = $false
$gateway = Set-AzExpressRouteGateway -InputObject $gateway
# Option 2 - Use the cmdlet switch
Set-AzExpressRouteGateway -ResourceGroupName "resourceGroup001" -Name "gateway001" -AllowNonVirtualWanTraffic $false
Parametry
-AllowNonVirtualWanTraffic
Určuje, jestli má tato brána přijímat provoz z jiných virtuálních sítí.
Typ: | Nullable<T>[Boolean] |
Position: | Named |
Default value: | None |
Vyžadováno: | False |
Přijmout vstup kanálu: | True |
Přijmout zástupné znaky: | False |
-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 |
-InputObject
ExpressRouteGateway, který je potřeba aktualizovat.
Typ: | PSExpressRouteGateway |
Aliasy: | ExpressRouteGateway |
Position: | Named |
Default value: | None |
Vyžadováno: | True |
Přijmout vstup kanálu: | True |
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: | False |
Přijmout vstup kanálu: | False |
Přijmout zástupné znaky: | False |
-Name
Název prostředku.
Typ: | String |
Aliasy: | ResourceName, ExpressRouteGatewayName, GatewayName |
Position: | Named |
Default value: | None |
Vyžadováno: | True |
Přijmout vstup kanálu: | False |
Přijmout zástupné znaky: | False |
-ResourceGroupName
Název skupiny prostředků ExpressRouteGateway, která se má aktualizovat.
Typ: | String |
Position: | Named |
Default value: | None |
Vyžadováno: | True |
Přijmout vstup kanálu: | False |
Přijmout zástupné znaky: | False |
-ResourceId
ID expressRouteGateway, které je potřeba aktualizovat.
Typ: | String |
Position: | Named |
Default value: | None |
Vyžadováno: | True |
Přijmout vstup kanálu: | True |
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 |
-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
Výstupy
Azure PowerShell