Remove-AzExpressRouteGateway

Referenz

Modul:: Az.Network

Das Cmdlet Remove-AzExpressRouteGateway entfernt ein Azure ExpressRoute-Gateway. Dies ist ein Gateway, das für die softwaredefinierte Konnektivität von Azure Virtual WAN spezifisch ist.

Syntax

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>]

Beschreibung

Das Cmdlet Remove-AzExpressRouteGateway entfernt ein Azure ExpressRoute-Gateway. Dies ist ein Gateway, das für die softwaredefinierte Konnektivität von Azure Virtual WAN spezifisch ist.

Beispiele

Beispiel 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 diesem Beispiel wird eine Ressourcengruppe, virtuelles WAN, Virtual Hub, skalierbares ExpressRoute-Gateway in Central US erstellt und dann sofort gelöscht. Verwenden Sie das Flag "-Force", um die Eingabeaufforderung beim Löschen des virtuellen Gateways zu unterdrücken. Dadurch werden das ExpressRouteGateway und alle daran angefügten ExpressRoute Verbinden ions gelöscht.

Beispiel 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 diesem Beispiel wird eine Ressourcengruppe, virtuelles WAN, Virtual Hub, skalierbares ExpressRoute-Gateway in West Central US erstellt und dann sofort gelöscht. Dieser Löschvorgang erfolgt mithilfe der PowerShell-Rohrleitung, die das expressRouteGateway-Objekt verwendet, das vom Befehl "Get-AzExpressRouteGateway" zurückgegeben wird. Verwenden Sie das Flag "-Force", um die Eingabeaufforderung beim Löschen des virtuellen Gateways zu unterdrücken. Dadurch werden das ExpressRouteGateway und alle daran angefügten ExpressRoute Verbinden ions gelöscht.

Parameter

-Confirm

Hiermit werden Sie vor der Ausführung des Cmdlets zur Bestätigung aufgefordert.

Type:	SwitchParameter
Aliases:	cf
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-DefaultProfile

Anmeldeinformationen, Konto, Mandant und Abonnement für die Kommunikation mit Azure

Type:	IAzureContextContainer
Aliases:	AzContext, AzureRmContext, AzureCredential
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-Force

Bitten Sie nicht um Bestätigung.

Type:	SwitchParameter
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-InputObject

Das zu löschende ExpressRouteGateway-Objekt.

Type:	PSExpressRouteGateway
Aliases:	ExpressRouteGateway
Position:	Named
Default value:	None
Required:	True
Accept pipeline input:	True
Accept wildcard characters:	False

-Name

Der ExpressRouteGateway-Name.

Type:	String
Aliases:	ResourceName, ExpressRouteGatewayName
Position:	Named
Default value:	None
Required:	True
Accept pipeline input:	False
Accept wildcard characters:	False

-PassThru

Gibt ein Objekt zurück, das das Element darstellt, mit dem Sie arbeiten. Standardmäßig wird von diesem Cmdlet keine Ausgabe generiert.

Type:	SwitchParameter
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-ResourceGroupName

Der Name der Ressourcengruppe.

Type:	String
Position:	Named
Default value:	None
Required:	True
Accept pipeline input:	False
Accept wildcard characters:	False

-ResourceId

Die Azure-Ressourcen-ID für das zu löschende ExpressRouteGateway.

Type:	String
Aliases:	expressRouteGatewayId
Position:	Named
Default value:	None
Required:	True
Accept pipeline input:	True
Accept wildcard characters:	False

-WhatIf

Zeigt, was geschieht, wenn das Cmdlet ausgeführt wird. Das Cmdlet wird nicht ausgeführt.

Type:	SwitchParameter
Aliases:	wi
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

Eingaben

PSExpressRouteGateway

String

Ausgaben

Boolean