Share via

Remove-AzDnsRecordSet

  • Referentie
Module:
Az.Dns

Hiermee verwijdert u een recordset.

Syntax

Remove-AzDnsRecordSet
      -Name <String>
      -RecordType <RecordType>
      -ZoneName <String>
      -ResourceGroupName <String>
      [-PassThru]
      [-DefaultProfile <IAzureContextContainer>]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]
Remove-AzDnsRecordSet
      -Name <String>
      -RecordType <RecordType>
      -Zone <DnsZone>
      [-PassThru]
      [-DefaultProfile <IAzureContextContainer>]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]
Remove-AzDnsRecordSet
      -RecordSet <DnsRecordSet>
      [-Overwrite]
      [-PassThru]
      [-DefaultProfile <IAzureContextContainer>]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]

Description

De cmdlet Remove-AzDnsRecordSet verwijdert de opgegeven recordset uit de opgegeven zone. U kunt GEEN SOA- of naamserverrecords (NS) verwijderen die automatisch worden gemaakt in de zone-apex. U kunt een RecordSet-object doorgeven aan deze cmdlet met behulp van de pijplijnoperator of als parameter. Als u een recordset op naam en type wilt identificeren zonder een RecordSet-object te gebruiken, moet u de zone als dnszone-object doorgeven aan deze cmdlet met behulp van de pijplijnoperator of als parameter, of u kunt ook de parameters ZoneName en ResourceGroupName 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 recordset opgeeft met behulp van een RecordSet-object , wordt de recordset niet verwijderd als deze is gewijzigd in Azure DNS sinds het lokale RecordSet-object is opgehaald. Dit biedt beveiliging voor gelijktijdige wijzigingen. U kunt dit onderdrukken met behulp van de parameter Overschrijven , waarmee de recordset wordt verwijderd, ongeacht gelijktijdige wijzigingen.

Voorbeelden

Voorbeeld 1: Een recordset verwijderen

$RecordSet = Get-AzDnsRecordSet -Name "www" -ResourceGroupName "MyResourceGroup" -ZoneName "myzone.com"
Remove-AzDnsRecordSet -RecordSet $RecordSet

Met de eerste opdracht wordt de opgegeven recordset opgeslagen en vervolgens opgeslagen in de $RecordSet variabele. Met de tweede opdracht wordt de recordset in $RecordSet verwijderd.

Voorbeeld 2: Een recordset verwijderen en alle bevestigingen onderdrukken

$RecordSet = Get-AzDnsRecordSet -Name "www" -ZoneName "myzone.com" -ResourceGroupName "MyResourceGroup"
Remove-AzDnsRecordSet -RecordSet $RecordSet -Confirm:$False -Overwrite

# Alternatively, the record set can be removed as follows.  In this case,
# because the record set is specified by name rather than by object, the
# Overwrite parameter is not applicable.

Remove-AzDnsRecordSet -Name "www" -ZoneName "myzone.com" -ResourceGroupName "MyResourceGroup" -Confirm:$False

Met de eerste opdracht wordt de opgegeven recordset ophaalt. Met de tweede opdracht wordt de recordset verwijderd, zelfs als deze in de tussentijd is gewijzigd. Bevestigingsprompts worden onderdrukt.

Parameters

-Confirm

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

Type:SwitchParameter
Aliases:cf
Position:Named
Default value:False
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-DefaultProfile

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

Type:IAzureContextContainer
Aliases:AzContext, AzureRmContext, AzureCredential
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Name

Hiermee geeft u de naam van de RecordSet te verwijderen. Wanneer u de recordset op naam opgeeft, moet de DNS-zone worden opgegeven met behulp van de zoneparameter of de parameters ZoneName en ResourceGroupName. U kunt de recordset ook opgeven met behulp van een RecordSet-object , doorgegeven met behulp van de parameter RecordSet .

Type:String
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-Overwrite

Wanneer u de recordset opgeeft met behulp van een RecordSet-object , wordt de recordset niet verwijderd als deze is gewijzigd in Azure DNS sinds het lokale RecordSet-object is opgehaald. Dit biedt beveiliging voor gelijktijdige wijzigingen. Dit kan worden onderdrukt met behulp van de parameter Overschrijven , waardoor de recordset wordt verwijderd, ongeacht gelijktijdige wijzigingen.

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-PassThru

passthru

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-RecordSet

Hiermee geeft u het RecordSet-object te verwijderen. U kunt de recordset ook opgeven met behulp van de parameters Naam en Zone , of met behulp van de parameters Name, ZoneName en ResourceGroupName .

Type:DnsRecordSet
Position:Named
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-RecordType

Hiermee geeft u het type DNS-record. Geldige waarden zijn:

  • A
  • AAAA
  • CNAME
  • MX
  • NS
  • POINTER
  • SRV
  • TXT SOA-records worden automatisch verwijderd wanneer de zone wordt verwijderd. U kunt SOA-records niet handmatig verwijderen.
Type:RecordType
Accepted values:A, Aaaa, CAA, Cname, MX, NS, PTR, SOA, SRV, TXT, Tlsa, DS, Naptr
Position:Named
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-ResourceGroupName

Hiermee geeft u de resourcegroep op die de DNS-zone bevat die de RecordSet bevat die moet worden verwijderd. Deze parameter is alleen van toepassing wanneer de recordset en de DNS-zone worden opgegeven met behulp van de parameters Name en ZoneName . U kunt ook de recordset opgeven met behulp van de parameter RecordSet of de parameters Name en Zone .

Type:String
Position:Named
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-WhatIf

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

Type:SwitchParameter
Aliases:wi
Position:Named
Default value:False
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Zone

Hiermee geeft u de DNS-zone die de RecordSet bevat die moet worden verwijderd. Deze parameter is alleen van toepassing wanneer u de recordset opgeeft met behulp van de parameter Name . U kunt ook de recordset opgeven met behulp van de parameter RecordSet of de parameters Name, ZoneName en ResourceGroupName .

Type:DnsZone
Position:Named
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-ZoneName

Hiermee geeft u de naam op van de zone die de RecordSet bevat die u wilt verwijderen. U moet ook de parameters Name en ResourceGroupName opgeven. U kunt de recordset ook opgeven met behulp van de parameter RecordSet of de parameters Name en Zone .

Type:String
Position:Named
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

Invoerwaarden

RecordType

String

DnsZone

DnsRecordSet

Uitvoerwaarden

Boolean

Notities

U kunt de parameter Bevestigen gebruiken om te bepalen of deze cmdlet u om bevestiging vraagt. De cmdlet vraagt u standaard om bevestiging als de $ConfirmPreference Windows PowerShell-variabele een waarde gemiddeld of lager heeft. Als u Bevestigen of Bevestigen:$True opgeeft, wordt u door deze cmdlet gevraagd om bevestiging voordat deze wordt uitgevoerd. Als u Confirm:$False opgeeft, wordt u niet om bevestiging gevraagd.