Delen via

Remove-AzVpnGateway

  • Referentie
Module:
Az.Network

Met de cmdlet Remove-AzVpnGateway wordt een Azure VPN-gateway verwijderd. Dit is een gateway die specifiek is voor de software-gedefinieerde connectiviteit van Azure Virtual WAN.

Syntaxis

Remove-AzVpnGateway
      -ResourceGroupName <String>
      -Name <String>
      [-PassThru]
      [-Force]
      [-DefaultProfile <IAzureContextContainer>]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]
Remove-AzVpnGateway
      -InputObject <PSVpnGateway>
      [-PassThru]
      [-Force]
      [-DefaultProfile <IAzureContextContainer>]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]
Remove-AzVpnGateway
      -ResourceId <String>
      [-PassThru]
      [-Force]
      [-DefaultProfile <IAzureContextContainer>]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]

Description

Met de cmdlet Remove-AzVpnGateway wordt een Azure VPN-gateway verwijderd. Dit is een gateway die specifiek is voor de software-gedefinieerde connectiviteit van Azure Virtual WAN.

Voorbeelden

Voorbeeld 1

New-AzResourceGroup -Location "West US" -Name "testRG"
$virtualWan = New-AzVirtualWan -ResourceGroupName testRG -Name myVirtualWAN -Location "West US"
$virtualHub = New-AzVirtualHub -VirtualWan $virtualWan -ResourceGroupName "testRG" -Name "westushub" -AddressPrefix "10.0.0.1/24"
New-AzVpnGateway -ResourceGroupName "testRG" -Name "testvpngw" -VirtualHubId $virtualHub.Id -VpnGatewayScaleUnit 2
Remove-AzVpnGateway -ResourceGroupName "testRG" -Name "testvpngw" -Passthru

In dit voorbeeld wordt een resourcegroep, Virtual WAN, virtuele hub, schaalbare VPN-gateway gemaakt in VS - centraal en vervolgens onmiddellijk verwijderd. Als u de prompt wilt onderdrukken bij het verwijderen van de virtuele gateway, gebruikt u de vlag -Force. Hierdoor worden de VpnGateway en alle Eraan gekoppelde VpnConnections verwijderd.

Voorbeeld 2

New-AzResourceGroup -Location "West US" -Name "testRG"
$virtualWan = New-AzVirtualWan -ResourceGroupName testRG -Name myVirtualWAN -Location "West US"
$virtualHub = New-AzVirtualHub -VirtualWan $virtualWan -ResourceGroupName "testRG" -Name "westushub" -AddressPrefix "10.0.0.1/24"
New-AzVpnGateway -ResourceGroupName "testRG" -Name "testvpngw" -VirtualHubId $virtualHub.Id -VpnGatewayScaleUnit 2
Get-AzVpnGateway -ResourceGroupName "testRG" -Name "testvpngw" | Remove-AzVpnGateway -Passthru

In dit voorbeeld wordt een resourcegroep, Virtual WAN, virtuele hub, schaalbare VPN-gateway gemaakt in VS - centraal en vervolgens onmiddellijk verwijderd. Deze verwijdering vindt plaats met behulp van PowerShell-pijpen, die gebruikmaakt van het VpnGateway-object dat wordt geretourneerd door de opdracht Get-AzVpnGateway. Als u de prompt wilt onderdrukken bij het verwijderen van de virtuele gateway, gebruikt u de vlag -Force. Hierdoor worden de VpnGateway en alle Eraan gekoppelde VpnConnections verwijderd.

Parameters

-Confirm

Hiermee wordt u gevraagd om bevestiging voordat u de cmdlet uitvoert.

Type:SwitchParameter
Aliassen:cf
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-DefaultProfile

De referenties, accounts, tenants en abonnementen die worden gebruikt voor communicatie met Azure.

Type:IAzureContextContainer
Aliassen:AzContext, AzureRmContext, AzureCredential
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-Force

Vraag niet om bevestiging.

Type:SwitchParameter
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-InputObject

Het vpnGateway-object dat moet worden verwijderd.

Type:PSVpnGateway
Aliassen:VpnGateway
Position:Named
Default value:None
Vereist:True
Pijplijninvoer accepteren:True
Jokertekens accepteren:False

-Name

De naam van de vpnGateway.

Type:String
Aliassen:ResourceName, VpnGatewayName
Position:Named
Default value:None
Vereist:True
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-PassThru

Retourneert een object dat het item aangeeft waarmee u werkt. Deze cmdlet genereert standaard geen uitvoer.

Type:SwitchParameter
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-ResourceGroupName

De naam van de resourcegroep.

Type:String
Position:Named
Default value:None
Vereist:True
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-ResourceId

De Azure-resource-id voor de vpnGateway die moet worden verwijderd.

Type:String
Aliassen:vpnGatewayId
Position:Named
Default value:None
Vereist:True
Pijplijninvoer accepteren:True
Jokertekens accepteren:False

-WhatIf

Hiermee wordt weergegeven wat er zou gebeuren als u de cmdlet uitvoert. De cmdlet wordt niet uitgevoerd.

Type:SwitchParameter
Aliassen:wi
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

Invoerwaarden

PSVpnGateway

String

Uitvoerwaarden

Boolean