Remove-AzExpressRouteGateway

Referência

Módulo:: Az.Network

O cmdlet Remove-AzExpressRouteGateway remove um gateway do Azure ExpressRoute. Esse é um gateway específico para a conectividade definida pelo software da WAN Virtual do Azure.

Sintaxe

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

O cmdlet Remove-AzExpressRouteGateway remove um gateway do Azure ExpressRoute. Esse é um gateway específico para a conectividade definida pelo software da WAN Virtual do Azure.

Exemplos

Exemplo 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

Este exemplo cria um grupo de recursos, WAN Virtual, Hub Virtual, gateway de ExpressRoute escalonável no Centro dos EUA e o exclui imediatamente. Para suprimir o prompt ao excluir o Gateway Virtual, use o sinalizador -Force. Isso excluirá o ExpressRouteGateway e todas as ExpressRouteConnections anexadas a ela.

Exemplo 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

Este exemplo cria um grupo de recursos, WAN Virtual, Hub Virtual, gateway de ExpressRoute escalonável no Centro-Oeste dos EUA e o exclui imediatamente. Essa exclusão ocorre usando a tubulação do PowerShell, que usa o objeto ExpressRouteGateway retornado pelo comando Get-AzExpressRouteGateway. Para suprimir o prompt ao excluir o Gateway Virtual, use o sinalizador -Force. Isso excluirá o ExpressRouteGateway e todas as ExpressRouteConnections anexadas a ela.

Parâmetros

-Confirm

Solicita a confirmação antes de executar o cmdlet.

Tipo:	SwitchParameter
Aliases:	cf
Cargo:	Named
Valor padrão:	None
Obrigatório:	False
Aceitar a entrada de pipeline:	False
Aceitar caracteres curinga:	False

-DefaultProfile

As credenciais, a conta, o locatário e a assinatura usados para comunicação com o Azure.

Tipo:	IAzureContextContainer
Aliases:	AzContext, AzureRmContext, AzureCredential
Cargo:	Named
Valor padrão:	None
Obrigatório:	False
Aceitar a entrada de pipeline:	False
Aceitar caracteres curinga:	False

-Force

Não peça confirmação.

Tipo:	SwitchParameter
Cargo:	Named
Valor padrão:	None
Obrigatório:	False
Aceitar a entrada de pipeline:	False
Aceitar caracteres curinga:	False

-InputObject

O objeto ExpressRouteGateway a ser excluído.

Tipo:	PSExpressRouteGateway
Aliases:	ExpressRouteGateway
Cargo:	Named
Valor padrão:	None
Obrigatório:	True
Aceitar a entrada de pipeline:	True
Aceitar caracteres curinga:	False

-Name

O nome do ExpressRouteGateway.

Tipo:	String
Aliases:	ResourceName, ExpressRouteGatewayName
Cargo:	Named
Valor padrão:	None
Obrigatório:	True
Aceitar a entrada de pipeline:	False
Aceitar caracteres curinga:	False

-PassThru

Retorna um objeto que representa o item com o qual você está trabalhando. Por padrão, esse cmdlet não gera nenhuma saída.

Tipo:	SwitchParameter
Cargo:	Named
Valor padrão:	None
Obrigatório:	False
Aceitar a entrada de pipeline:	False
Aceitar caracteres curinga:	False

-ResourceGroupName

O nome do grupo de recursos.

Tipo:	String
Cargo:	Named
Valor padrão:	None
Obrigatório:	True
Aceitar a entrada de pipeline:	False
Aceitar caracteres curinga:	False

-ResourceId

A ID do recurso do Azure para o ExpressRouteGateway a ser excluída.

Tipo:	String
Aliases:	expressRouteGatewayId
Cargo:	Named
Valor padrão:	None
Obrigatório:	True
Aceitar a entrada de pipeline:	True
Aceitar caracteres curinga:	False

-WhatIf

Mostra o que aconteceria se o cmdlet fosse executado. O cmdlet não é executado.

Tipo:	SwitchParameter
Aliases:	wi
Cargo:	Named
Valor padrão:	None
Obrigatório:	False
Aceitar a entrada de pipeline:	False
Aceitar caracteres curinga:	False

Entradas

PSExpressRouteGateway

String

Saídas

Boolean

Compartilhar via