Remove-AzExpressRouteGateway

Referens

Modul:: Az.Network

Cmdleten Remove-AzExpressRouteGateway tar bort en Azure ExpressRoute-gateway. Det här är en gateway som är specifik för Azure Virtual WAN:s programvarudefinierade anslutning.

Syntax

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

Cmdleten Remove-AzExpressRouteGateway tar bort en Azure ExpressRoute-gateway. Det här är en gateway som är specifik för Azure Virtual WAN:s programvarudefinierade anslutning.

Exempel

Exempel 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

Det här exemplet skapar en resursgrupp, Virtual WAN, virtual hub, skalbar ExpressRoute-gateway i USA, centrala och tar sedan bort den omedelbart. Om du vill ignorera uppmaningen när du tar bort den virtuella gatewayen använder du flaggan -Force. Detta tar bort ExpressRouteGateway och alla ExpressRouteConnections som är kopplade till den.

Exempel 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

Det här exemplet skapar en resursgrupp, Virtual WAN, virtual hub, skalbar ExpressRoute-gateway i USA, västra centrala och tar sedan bort den omedelbart. Den här borttagningen sker med hjälp av powershell-rör, som använder ExpressRouteGateway-objektet som returneras av kommandot Get-AzExpressRouteGateway. Om du vill ignorera uppmaningen när du tar bort den virtuella gatewayen använder du flaggan -Force. Detta tar bort ExpressRouteGateway och alla ExpressRouteConnections som är kopplade till den.

Parametrar

-Confirm

Uppmanar dig att bekräfta innan du kör cmdleten.

Typ:	SwitchParameter
Alias:	cf
Position:	Named
Standardvärde:	None
Obligatorisk:	False
Godkänn pipeline-indata:	False
Godkänn jokertecken:	False

-DefaultProfile

Autentiseringsuppgifter, konto, klientorganisation och prenumeration som används för kommunikation med Azure.

Typ:	IAzureContextContainer
Alias:	AzContext, AzureRmContext, AzureCredential
Position:	Named
Standardvärde:	None
Obligatorisk:	False
Godkänn pipeline-indata:	False
Godkänn jokertecken:	False

-Force

Be inte om bekräftelse.

Typ:	SwitchParameter
Position:	Named
Standardvärde:	None
Obligatorisk:	False
Godkänn pipeline-indata:	False
Godkänn jokertecken:	False

-InputObject

ExpressRouteGateway-objektet som ska tas bort.

Typ:	PSExpressRouteGateway
Alias:	ExpressRouteGateway
Position:	Named
Standardvärde:	None
Obligatorisk:	True
Godkänn pipeline-indata:	True
Godkänn jokertecken:	False

-Name

ExpressRouteGateway-namnet.

Typ:	String
Alias:	ResourceName, ExpressRouteGatewayName
Position:	Named
Standardvärde:	None
Obligatorisk:	True
Godkänn pipeline-indata:	False
Godkänn jokertecken:	False

-PassThru

Returnerar ett objekt som representerar det objekt som du arbetar med. Som standard genererar den här cmdleten inga utdata.

Typ:	SwitchParameter
Position:	Named
Standardvärde:	None
Obligatorisk:	False
Godkänn pipeline-indata:	False
Godkänn jokertecken:	False

-ResourceGroupName

Resursgruppens namn.

Typ:	String
Position:	Named
Standardvärde:	None
Obligatorisk:	True
Godkänn pipeline-indata:	False
Godkänn jokertecken:	False

-ResourceId

Azure-resurs-ID:t för ExpressRouteGateway som ska tas bort.

Typ:	String
Alias:	expressRouteGatewayId
Position:	Named
Standardvärde:	None
Obligatorisk:	True
Godkänn pipeline-indata:	True
Godkänn jokertecken:	False

-WhatIf

Visar vad som skulle hända om cmdleten kördes. Cmdleten körs inte.

Typ:	SwitchParameter
Alias:	wi
Position:	Named
Standardvärde:	None
Obligatorisk:	False
Godkänn pipeline-indata:	False
Godkänn jokertecken:	False

Indata

PSExpressRouteGateway

String

Utdata

Boolean

Dela via