Remove-AzExpressRouteGateway

Module:

Az.Network

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