Remove-AzExpressRouteGateway

Módulo:

Az.Network

El cmdlet Remove-AzExpressRouteGateway quita una puerta de enlace de Azure ExpressRoute. Se trata de una puerta de enlace específica de la conectividad definida por software de Azure Virtual WAN.

Sintaxis

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

El cmdlet Remove-AzExpressRouteGateway quita una puerta de enlace de Azure ExpressRoute. Se trata de una puerta de enlace específica de la conectividad definida por software de Azure Virtual WAN.

Ejemplos

Ejemplo 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

En este ejemplo se crea un grupo de recursos, Virtual WAN, un centro de conectividad virtual, una puerta de enlace de ExpressRoute escalable en centro de EE. UU. y, a continuación, se elimina inmediatamente. Para suprimir el mensaje al eliminar la puerta de enlace virtual, use la marca -Force. Esto eliminará ExpressRouteGateway y todos los ExpressRouteConnections conectados a él.

Ejemplo 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

En este ejemplo se crea un grupo de recursos, Virtual WAN, centro virtual, puerta de enlace de ExpressRoute escalable en Centro-oeste de EE. UU. y, a continuación, se elimina inmediatamente. Esta eliminación se produce mediante la canalización de PowerShell, que usa el objeto ExpressRouteGateway devuelto por el comando Get-AzExpressRouteGateway. Para suprimir el mensaje al eliminar la puerta de enlace virtual, use la marca -Force. Esto eliminará ExpressRouteGateway y todos los ExpressRouteConnections conectados a él.

Parámetros

-Confirm

Le solicita su confirmación antes de ejecutar el cmdlet.

Tipo:	SwitchParameter
Alias:	cf
Posición:	Named
Valor predeterminado:	None
Requerido:	False
Aceptar entrada de canalización:	False
Aceptar caracteres comodín:	False

-DefaultProfile

Credenciales, cuenta, inquilino y suscripción usados para la comunicación con Azure.

Tipo:	IAzureContextContainer
Alias:	AzContext, AzureRmContext, AzureCredential
Posición:	Named
Valor predeterminado:	None
Requerido:	False
Aceptar entrada de canalización:	False
Aceptar caracteres comodín:	False

-Force

No pida confirmación.

Tipo:	SwitchParameter
Posición:	Named
Valor predeterminado:	None
Requerido:	False
Aceptar entrada de canalización:	False
Aceptar caracteres comodín:	False

-InputObject

Objeto ExpressRouteGateway que se va a eliminar.

Tipo:	PSExpressRouteGateway
Alias:	ExpressRouteGateway
Posición:	Named
Valor predeterminado:	None
Requerido:	True
Aceptar entrada de canalización:	True
Aceptar caracteres comodín:	False

-Name

Nombre de ExpressRouteGateway.

Tipo:	String
Alias:	ResourceName, ExpressRouteGatewayName
Posición:	Named
Valor predeterminado:	None
Requerido:	True
Aceptar entrada de canalización:	False
Aceptar caracteres comodín:	False

-PassThru

Devuelve un objeto que representa el elemento con el que está trabajando. De forma predeterminada, este cmdlet no genera ningún resultado.

Tipo:	SwitchParameter
Posición:	Named
Valor predeterminado:	None
Requerido:	False
Aceptar entrada de canalización:	False
Aceptar caracteres comodín:	False

-ResourceGroupName

El nombre del grupo de recursos.

Tipo:	String
Posición:	Named
Valor predeterminado:	None
Requerido:	True
Aceptar entrada de canalización:	False
Aceptar caracteres comodín:	False

-ResourceId

Identificador de recurso de Azure para que se elimine ExpressRouteGateway.

Tipo:	String
Alias:	expressRouteGatewayId
Posición:	Named
Valor predeterminado:	None
Requerido:	True
Aceptar entrada de canalización:	True
Aceptar caracteres comodín:	False

-WhatIf

Muestra lo que sucedería si se ejecutara el cmdlet. El cmdlet no se ejecuta.

Tipo:	SwitchParameter
Alias:	wi
Posición:	Named
Valor predeterminado:	None
Requerido:	False
Aceptar entrada de canalización:	False
Aceptar caracteres comodín:	False

Entradas

PSExpressRouteGateway

String

Salidas

Boolean