Remove-AzExpressRouteGateway
Rutina Remove-AzExpressRouteGateway odebere bránu Azure ExpressRoute. Jedná se o bránu specifickou pro softwarově definované připojení služby Azure Virtual WAN.
Syntaxe
Remove-AzExpressRouteGateway
-ResourceGroupName <String>
-Name <String>
[-PassThru]
[-Force]
[-DefaultProfile <IAzureContextContainer>]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Remove-AzExpressRouteGateway
-InputObject <PSExpressRouteGateway>
[-PassThru]
[-Force]
[-DefaultProfile <IAzureContextContainer>]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Remove-AzExpressRouteGateway
-ResourceId <String>
[-PassThru]
[-Force]
[-DefaultProfile <IAzureContextContainer>]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Description
Rutina Remove-AzExpressRouteGateway odebere bránu Azure ExpressRoute. Jedná se o bránu specifickou pro softwarově definované připojení služby Azure Virtual WAN.
Příklady
Příklad 1
New-AzResourceGroup -Location "West Central US" -Name "testRG"
$virtualWan = New-AzVirtualWan -ResourceGroupName testRG -Name myVirtualWAN -Location "West Central US"
$virtualHub = New-AzVirtualHub -VirtualWan $virtualWan -ResourceGroupName "testRG" -Name "westushub" -AddressPrefix "10.0.0.1/24"
New-AzExpressRouteGateway -ResourceGroupName "testRG" -Name "testExpressRoutegw" -VirtualHubId $virtualHub.Id -MinScaleUnits 2
Remove-AzExpressRouteGateway -ResourceGroupName "testRG" -Name "testExpressRoutegw" -Passthru
Tento příklad vytvoří skupinu prostředků, Virtual WAN, virtuální centrum, škálovatelnou bránu ExpressRoute v oblasti USA – střed a okamžitě ji odstraní. Pokud chcete potlačit výzvu při odstraňování virtuální brány, použijte příznak -Force. Tím se odstraní expressRouteGateway a všechny připojení ExpressRouteConnections připojené k němu.
Příklad 2
New-AzResourceGroup -Location "West Central US" -Name "testRG"
$virtualWan = New-AzVirtualWan -ResourceGroupName testRG -Name myVirtualWAN -Location "West Central US"
$virtualHub = New-AzVirtualHub -VirtualWan $virtualWan -ResourceGroupName "testRG" -Name "westushub" -AddressPrefix "10.0.0.1/24"
New-AzExpressRouteGateway -ResourceGroupName "testRG" -Name "testExpressRoutegw" -VirtualHubId $virtualHub.Id -MinScaleUnits 2
Get-AzExpressRouteGateway -ResourceGroupName "testRG" -Name "testExpressRoutegw" | Remove-AzExpressRouteGateway -Passthru
Tento příklad vytvoří skupinu prostředků, Virtual WAN, virtuální centrum, škálovatelnou bránu ExpressRoute v oblasti USA – středozápad a okamžitě ji odstraní. K tomuto odstranění dochází pomocí pipingu PowerShellu, který používá objekt ExpressRouteGateway vrácený příkazem Get-AzExpressRouteGateway. Pokud chcete potlačit výzvu při odstraňování virtuální brány, použijte příznak -Force. Tím se odstraní expressRouteGateway a všechny připojení ExpressRouteConnections připojené k němu.
Parametry
-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 |
-Force
Nepožádejte o potvrzení.
Typ: | SwitchParameter |
Position: | Named |
Default value: | None |
Vyžadováno: | False |
Přijmout vstup kanálu: | False |
Přijmout zástupné znaky: | False |
-InputObject
Objekt ExpressRouteGateway, který se má odstranit.
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 |
-Name
Název ExpressRouteGateway.
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 |
-PassThru
Vrátí objekt představující položku, se kterou pracujete. Ve výchozím nastavení tato rutina negeneruje žádný výstup.
Typ: | SwitchParameter |
Position: | Named |
Default value: | None |
Vyžadováno: | False |
Přijmout vstup kanálu: | False |
Přijmout zástupné znaky: | False |
-ResourceGroupName
Název skupiny prostředků.
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 prostředku Azure, které se má odstranit expressRouteGateway.
Typ: | String |
Aliasy: | expressRouteGatewayId |
Position: | Named |
Default value: | None |
Vyžadováno: | True |
Přijmout vstup kanálu: | True |
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 |