Remove-AzExpressRouteGateway

Polecenie cmdlet Remove-AzExpressRouteGateway usuwa bramę usługi Azure ExpressRoute. Jest to brama specyficzna dla łączności zdefiniowanej przez oprogramowanie usługi Azure Virtual WAN.

Składnia

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

Opis

Polecenie cmdlet Remove-AzExpressRouteGateway usuwa bramę usługi Azure ExpressRoute. Jest to brama specyficzna dla łączności zdefiniowanej przez oprogramowanie usługi Azure Virtual WAN.

Przykłady

Przykład 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

W tym przykładzie tworzona jest grupa zasobów, usługa Virtual WAN, koncentrator wirtualny, skalowalna brama usługi ExpressRoute w regionie Środkowe stany USA, a następnie natychmiast ją usuwa. Aby pominąć monit podczas usuwania bramy wirtualnej, użyj flagi -Force. Spowoduje to usunięcie bramy ExpressRouteGateway i wszystkich dołączonych do niej jednostek ExpressRoute Połączenie ions.

Przykład 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

W tym przykładzie tworzona jest grupa zasobów, usługa Virtual WAN, koncentrator wirtualny, skalowalna brama usługi ExpressRoute w regionie Zachodnie środkowe stany USA, a następnie natychmiast ją usuwa. Usunięcie odbywa się przy użyciu potoków programu PowerShell, które używa obiektu ExpressRouteGateway zwróconego przez polecenie Get-AzExpressRouteGateway. Aby pominąć monit podczas usuwania bramy wirtualnej, użyj flagi -Force. Spowoduje to usunięcie bramy ExpressRouteGateway i wszystkich dołączonych do niej jednostek ExpressRoute Połączenie ions.

Parametry

-Confirm

Monituje o potwierdzenie przed uruchomieniem polecenia cmdlet.

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

-DefaultProfile

Poświadczenia, konto, dzierżawa i subskrypcja używane do komunikacji z platformą Azure.

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

-Force

Nie pytaj o potwierdzenie.

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

-InputObject

Obiekt ExpressRouteGateway do usunięcia.

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

-Name

Nazwa bramy usługi ExpressRouteGateway.

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

-PassThru

Zwraca obiekt reprezentujący element, z którym pracujesz. Domyślnie to polecenie cmdlet nie generuje żadnych danych wyjściowych.

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

-ResourceGroupName

Nazwa grupy zasobów.

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

-ResourceId

Identyfikator zasobu platformy Azure dla bramy ExpressRouteGateway do usunięcia.

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

-WhatIf

Pokazuje, co się stanie po uruchomieniu polecenia cmdlet. Polecenie cmdlet nie zostało uruchomione.

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

Dane wejściowe

PSExpressRouteGateway

String

Dane wyjściowe

Boolean