Udostępnij za pośrednictwem

Remove-AzExpressRouteGateway

  • Odwołanie
Moduł:
Az.Network

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 połączeń ExpressRouteConnections.

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 połączeń ExpressRouteConnections.

Parametry

-Confirm

Monituje o potwierdzenie przed uruchomieniem polecenia cmdlet.

Typ:SwitchParameter
Aliasy:cf
Position:Named
Domyślna wartość:None
Wymagane:False
Akceptowanie danych wejściowych potoku:False
Akceptowanie symboli wieloznacznych:False

-DefaultProfile

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

Typ:IAzureContextContainer
Aliasy:AzContext, AzureRmContext, AzureCredential
Position:Named
Domyślna wartość:None
Wymagane:False
Akceptowanie danych wejściowych potoku:False
Akceptowanie symboli wieloznacznych:False

-Force

Nie pytaj o potwierdzenie.

Typ:SwitchParameter
Position:Named
Domyślna wartość:None
Wymagane:False
Akceptowanie danych wejściowych potoku:False
Akceptowanie symboli wieloznacznych:False

-InputObject

Obiekt ExpressRouteGateway do usunięcia.

Typ:PSExpressRouteGateway
Aliasy:ExpressRouteGateway
Position:Named
Domyślna wartość:None
Wymagane:True
Akceptowanie danych wejściowych potoku:True
Akceptowanie symboli wieloznacznych:False

-Name

Nazwa bramy usługi ExpressRouteGateway.

Typ:String
Aliasy:ResourceName, ExpressRouteGatewayName
Position:Named
Domyślna wartość:None
Wymagane:True
Akceptowanie danych wejściowych potoku:False
Akceptowanie symboli wieloznacznych:False

-PassThru

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

Typ:SwitchParameter
Position:Named
Domyślna wartość:None
Wymagane:False
Akceptowanie danych wejściowych potoku:False
Akceptowanie symboli wieloznacznych:False

-ResourceGroupName

Nazwa grupy zasobów.

Typ:String
Position:Named
Domyślna wartość:None
Wymagane:True
Akceptowanie danych wejściowych potoku:False
Akceptowanie symboli wieloznacznych:False

-ResourceId

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

Typ:String
Aliasy:expressRouteGatewayId
Position:Named
Domyślna wartość:None
Wymagane:True
Akceptowanie danych wejściowych potoku:True
Akceptowanie symboli wieloznacznych:False

-WhatIf

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

Typ:SwitchParameter
Aliasy:wi
Position:Named
Domyślna wartość:None
Wymagane:False
Akceptowanie danych wejściowych potoku:False
Akceptowanie symboli wieloznacznych:False

Dane wejściowe

PSExpressRouteGateway

String

Dane wyjściowe

Boolean