Delen via


Remove-AzExpressRouteGateway

Met de cmdlet Remove-AzExpressRouteGateway wordt een Azure ExpressRoute-gateway verwijderd. Dit is een gateway die specifiek is voor de software-gedefinieerde connectiviteit van Azure Virtual WAN.

Syntaxis

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

Met de cmdlet Remove-AzExpressRouteGateway wordt een Azure ExpressRoute-gateway verwijderd. Dit is een gateway die specifiek is voor de software-gedefinieerde connectiviteit van Azure Virtual WAN.

Voorbeelden

Voorbeeld 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

In dit voorbeeld wordt een resourcegroep, Virtual WAN, virtuele hub, schaalbare ExpressRoute-gateway gemaakt in VS - centraal en vervolgens onmiddellijk verwijderd. Als u de prompt wilt onderdrukken bij het verwijderen van de virtuele gateway, gebruikt u de vlag -Force. Hiermee verwijdert u de ExpressRouteGateway en alle ExpressRouteConnections die eraan zijn gekoppeld.

Voorbeeld 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

In dit voorbeeld wordt een resourcegroep, Virtual WAN, virtuele hub, schaalbare ExpressRoute-gateway gemaakt in VS - west-centraal en vervolgens onmiddellijk verwijderd. Deze verwijdering vindt plaats met behulp van PowerShell-piping, dat gebruikmaakt van het ExpressRouteGateway-object dat wordt geretourneerd door de opdracht Get-AzExpressRouteGateway. Als u de prompt wilt onderdrukken bij het verwijderen van de virtuele gateway, gebruikt u de vlag -Force. Hiermee verwijdert u de ExpressRouteGateway en alle ExpressRouteConnections die eraan zijn gekoppeld.

Parameters

-Confirm

Hiermee wordt u gevraagd om bevestiging voordat u de cmdlet uitvoert.

Type:SwitchParameter
Aliassen:cf
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-DefaultProfile

De referenties, accounts, tenants en abonnementen die worden gebruikt voor communicatie met Azure.

Type:IAzureContextContainer
Aliassen:AzContext, AzureRmContext, AzureCredential
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-Force

Vraag niet om bevestiging.

Type:SwitchParameter
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-InputObject

Het ExpressRouteGateway-object dat moet worden verwijderd.

Type:PSExpressRouteGateway
Aliassen:ExpressRouteGateway
Position:Named
Default value:None
Vereist:True
Pijplijninvoer accepteren:True
Jokertekens accepteren:False

-Name

De naam van de ExpressRouteGateway.

Type:String
Aliassen:ResourceName, ExpressRouteGatewayName
Position:Named
Default value:None
Vereist:True
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-PassThru

Retourneert een object dat het item aangeeft waarmee u werkt. Deze cmdlet genereert standaard geen uitvoer.

Type:SwitchParameter
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-ResourceGroupName

De naam van de resourcegroep.

Type:String
Position:Named
Default value:None
Vereist:True
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-ResourceId

De Azure-resource-id voor de ExpressRouteGateway die moet worden verwijderd.

Type:String
Aliassen:expressRouteGatewayId
Position:Named
Default value:None
Vereist:True
Pijplijninvoer accepteren:True
Jokertekens accepteren:False

-WhatIf

Hiermee wordt weergegeven wat er zou gebeuren als u de cmdlet uitvoert. De cmdlet wordt niet uitgevoerd.

Type:SwitchParameter
Aliassen:wi
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

Invoerwaarden

PSExpressRouteGateway

String

Uitvoerwaarden

Boolean