Delen via

Remove-AzDnsZone

  • Referentie
Module:
Az.Dns

Hiermee verwijdert u een DNS-zone uit een resourcegroep.

Syntaxis

Remove-AzDnsZone
      -Name <String>
      -ResourceGroupName <String>
      [-PassThru]
      [-DefaultProfile <IAzureContextContainer>]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]
Remove-AzDnsZone
      -Zone <DnsZone>
      [-Overwrite]
      [-PassThru]
      [-DefaultProfile <IAzureContextContainer>]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]

Description

De Remove-AzDnsZone cmdlet verwijdert definitief een DNS-zone (Domain Name System) uit een opgegeven resourcegroep. Alle recordsets in de zone worden ook verwijderd. U kunt een DnsZone--object doorgeven met behulp van de parameter Name of met behulp van de pijplijnoperator. U kunt ook de parameters ZoneName en ResourceGroup Name opgeven. U kunt de parameter Bevestigen en $ConfirmPreference Windows PowerShell-variabele gebruiken om te bepalen of de cmdlet u om bevestiging vraagt. Wanneer u de zone opgeeft met behulp van een DnsZone--object (doorgegeven via de pijplijn of zone- parameter), wordt de zone niet verwijderd als deze is gewijzigd in Azure DNS sinds het lokale DnsZone--object is opgehaald (alleen bewerkingen rechtstreeks op de DNS-zoneresource tellen als wijzigingen, bewerkingen op recordsets binnen de zone niet). Dit biedt beveiliging voor gelijktijdige zonewijzigingen. Dit kan worden onderdrukt met behulp van de parameter Overschrijven, waardoor de zone wordt verwijderd, ongeacht gelijktijdige wijzigingen.

Voorbeelden

Voorbeeld 1: Een zone verwijderen

Remove-AzDnsZone -Name "myzone.com" -ResourceGroupName "MyResourceGroup"

Met deze opdracht verwijdert u de zone met de naam myzone.com uit de resourcegroep met de naam MyResourceGroup.

Parameters

-Confirm

U wordt gevraagd om bevestiging voordat u de cmdlet uitvoert.

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

-DefaultProfile

De referenties, het account, de tenant en het abonnement dat wordt gebruikt voor communicatie met Azure

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

-Name

Hiermee geeft u de naam op van de DNS-zone die door deze cmdlet wordt verwijderd. U moet ook de parameter ResourceGroupName opgeven. U kunt ook de DNS-zone opgeven met behulp van de parameter Zone.

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

-Overwrite

Wanneer u de zone opgeeft met behulp van een DnsZone--object (doorgegeven via de pijplijn of zone- parameter), wordt de zone niet verwijderd als deze is gewijzigd in Azure DNS sinds het lokale DnsZone--object is opgehaald (alleen bewerkingen rechtstreeks op de DNS-zoneresource tellen als wijzigingen, bewerkingen op recordsets binnen de zone niet). Dit biedt beveiliging voor gelijktijdige zonewijzigingen. Dit kan worden onderdrukt met behulp van de parameter Overschrijven, waardoor de zone wordt verwijderd, ongeacht gelijktijdige wijzigingen.

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

-PassThru

passthru

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

-ResourceGroupName

Hiermee geeft u de naam op van de resourcegroep die de zone bevat die u wilt verwijderen. U moet ook de parameter ZoneName opgeven. U kunt ook de DNS-zone opgeven met behulp van een DnsZone-object, doorgegeven via de pijplijn of de parameter Zone.

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

-WhatIf

Toont wat er zou gebeuren als de cmdlet wordt uitgevoerd. De cmdlet wordt niet uitgevoerd.

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

-Zone

Hiermee geeft u de DNS-zone te verwijderen. De DnsZone doorgegeven object kan ook worden doorgegeven via de pijplijn. U kunt ook de DNS-zone opgeven die u wilt verwijderen met behulp van de parameters ZoneName en ResourceGroupName.

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

Invoerwaarden

Uitvoerwaarden

Notities

Vanwege de mogelijk grote impact van het verwijderen van een DNS-zone wordt standaard door deze cmdlet gevraagd om bevestiging als de $ConfirmPreference Windows PowerShell-variabele een andere waarde heeft dan Geen. Als u bevestigen of Confirm:$Trueopgeeft, wordt u door deze cmdlet gevraagd om bevestiging voordat deze wordt uitgevoerd. Als u Confirm:$Falseopgeeft, wordt u niet om bevestiging gevraagd.