Remove-AzExpressRouteGateway

參考

模組:: Az.Network

Remove-AzExpressRouteGateway Cmdlet 會移除 Azure ExpressRoute 閘道。這是 Azure 虛擬 WAN 軟體定義連線的特定閘道。

語法

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

Remove-AzExpressRouteGateway Cmdlet 會移除 Azure ExpressRoute 閘道。這是 Azure 虛擬 WAN 軟體定義連線的特定閘道。

範例

範例 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

此範例會在美國中部建立資源群組、虛擬 WAN、虛擬中樞、可調整的 ExpressRoute 閘道，然後立即刪除它。若要在刪除虛擬閘道時隱藏提示，請使用 -Force 旗標。這會刪除 ExpressRouteGateway 及其附加的所有 ExpressRouteConnections。

範例 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

此範例會在美國中西部建立資源群組虛擬 WAN、虛擬中樞、可調整的 ExpressRoute 閘道，然後立即將其刪除。此刪除作業會使用 powershell 管線進行，它會使用 Get-AzExpressRouteGateway 命令所傳回的 ExpressRouteGateway 物件。若要在刪除虛擬閘道時隱藏提示，請使用 -Force 旗標。這會刪除 ExpressRouteGateway 及其附加的所有 ExpressRouteConnections。

參數

-Confirm

在執行 Cmdlet 之前，提示您進行確認。

類型:	SwitchParameter
別名:	cf
Position:	Named
預設值:	None
必要:	False
接受管線輸入:	False
接受萬用字元:	False

-DefaultProfile

用於與 Azure 通訊的認證、帳戶、租用戶和訂用帳戶。

類型:	IAzureContextContainer
別名:	AzContext, AzureRmContext, AzureCredential
Position:	Named
預設值:	None
必要:	False
接受管線輸入:	False
接受萬用字元:	False

-Force

請勿要求確認。

類型:	SwitchParameter
Position:	Named
預設值:	None
必要:	False
接受管線輸入:	False
接受萬用字元:	False

-InputObject

要刪除的 ExpressRouteGateway 物件。

類型:	PSExpressRouteGateway
別名:	ExpressRouteGateway
Position:	Named
預設值:	None
必要:	True
接受管線輸入:	True
接受萬用字元:	False

-Name

ExpressRouteGateway 名稱。

類型:	String
別名:	ResourceName, ExpressRouteGatewayName
Position:	Named
預設值:	None
必要:	True
接受管線輸入:	False
接受萬用字元:	False

-PassThru

會傳回物件，代表您正在使用的專案。根據預設，此 Cmdlet 不會產生任何輸出。

類型:	SwitchParameter
Position:	Named
預設值:	None
必要:	False
接受管線輸入:	False
接受萬用字元:	False

-ResourceGroupName

資源組名。

類型:	String
Position:	Named
預設值:	None
必要:	True
接受管線輸入:	False
接受萬用字元:	False

-ResourceId

要刪除之 ExpressRouteGateway 的 Azure 資源識別碼。

類型:	String
別名:	expressRouteGatewayId
Position:	Named
預設值:	None
必要:	True
接受管線輸入:	True
接受萬用字元:	False

-WhatIf

顯示 Cmdlet 執行時會發生什麼事。 Cmdlet 未執行。

類型:	SwitchParameter
別名:	wi
Position:	Named
預設值:	None
必要:	False
接受管線輸入:	False
接受萬用字元:	False

輸入

PSExpressRouteGateway

String

輸出

Boolean

共用方式為