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 ExpressRouteConnections 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 ExpressRouteConnections gelöscht.

Parameter

-Confirm

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

Typ:	SwitchParameter
Aliase:	cf
Position:	Named
Standardwert:	None
Erforderlich:	False
Pipelineeingabe akzeptieren:	False
Platzhalterzeichen akzeptieren:	False

-DefaultProfile

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

Typ:	IAzureContextContainer
Aliase:	AzContext, AzureRmContext, AzureCredential
Position:	Named
Standardwert:	None
Erforderlich:	False
Pipelineeingabe akzeptieren:	False
Platzhalterzeichen akzeptieren:	False

-Force

Bitten Sie nicht um Bestätigung.

Typ:	SwitchParameter
Position:	Named
Standardwert:	None
Erforderlich:	False
Pipelineeingabe akzeptieren:	False
Platzhalterzeichen akzeptieren:	False

-InputObject

Das zu löschende ExpressRouteGateway-Objekt.

Typ:	PSExpressRouteGateway
Aliase:	ExpressRouteGateway
Position:	Named
Standardwert:	None
Erforderlich:	True
Pipelineeingabe akzeptieren:	True
Platzhalterzeichen akzeptieren:	False

-Name

Der ExpressRouteGateway-Name.

Typ:	String
Aliase:	ResourceName, ExpressRouteGatewayName
Position:	Named
Standardwert:	None
Erforderlich:	True
Pipelineeingabe akzeptieren:	False
Platzhalterzeichen akzeptieren:	False

-PassThru

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

Typ:	SwitchParameter
Position:	Named
Standardwert:	None
Erforderlich:	False
Pipelineeingabe akzeptieren:	False
Platzhalterzeichen akzeptieren:	False

-ResourceGroupName

Der Name der Ressourcengruppe.

Typ:	String
Position:	Named
Standardwert:	None
Erforderlich:	True
Pipelineeingabe akzeptieren:	False
Platzhalterzeichen akzeptieren:	False

-ResourceId

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

Typ:	String
Aliase:	expressRouteGatewayId
Position:	Named
Standardwert:	None
Erforderlich:	True
Pipelineeingabe akzeptieren:	True
Platzhalterzeichen akzeptieren:	False

-WhatIf

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

Typ:	SwitchParameter
Aliase:	wi
Position:	Named
Standardwert:	None
Erforderlich:	False
Pipelineeingabe akzeptieren:	False
Platzhalterzeichen akzeptieren:	False

Eingaben

PSExpressRouteGateway

String

Ausgaben

Boolean

Freigeben über