Remove-AzDnsRecordConfig

Referentie

Module:: Az.Dns

Hiermee verwijdert u een DNS-record uit een lokaal recordsetobject.

Syntaxis

Remove-AzDnsRecordConfig
      -RecordSet <DnsRecordSet>
      -Ipv4Address <String>
      [-DefaultProfile <IAzureContextContainer>]
      [<CommonParameters>]

Remove-AzDnsRecordConfig
      -RecordSet <DnsRecordSet>
      -Ipv6Address <String>
      [-DefaultProfile <IAzureContextContainer>]
      [<CommonParameters>]

Remove-AzDnsRecordConfig
      -RecordSet <DnsRecordSet>
      -Nsdname <String>
      [-DefaultProfile <IAzureContextContainer>]
      [<CommonParameters>]

Remove-AzDnsRecordConfig
      -RecordSet <DnsRecordSet>
      -Exchange <String>
      -Preference <UInt16>
      [-DefaultProfile <IAzureContextContainer>]
      [<CommonParameters>]

Remove-AzDnsRecordConfig
      -RecordSet <DnsRecordSet>
      -Ptrdname <String>
      [-DefaultProfile <IAzureContextContainer>]
      [<CommonParameters>]

Remove-AzDnsRecordConfig
      -RecordSet <DnsRecordSet>
      -Value <String>
      [-DefaultProfile <IAzureContextContainer>]
      [<CommonParameters>]

Remove-AzDnsRecordConfig
      -RecordSet <DnsRecordSet>
      -Priority <UInt16>
      -Target <String>
      -Port <UInt16>
      -Weight <UInt16>
      [-DefaultProfile <IAzureContextContainer>]
      [<CommonParameters>]

Remove-AzDnsRecordConfig
      -RecordSet <DnsRecordSet>
      -Cname <String>
      [-DefaultProfile <IAzureContextContainer>]
      [<CommonParameters>]

Remove-AzDnsRecordConfig
      -RecordSet <DnsRecordSet>
      -CaaFlags <Byte>
      -CaaTag <String>
      -CaaValue <String>
      [-DefaultProfile <IAzureContextContainer>]
      [<CommonParameters>]

Remove-AzDnsRecordConfig
      -RecordSet <DnsRecordSet>
      -KeyTag <Int32>
      -Algorithm <Int32>
      -DigestType <Int32>
      -Digest <String>
      [-DefaultProfile <IAzureContextContainer>]
      [<CommonParameters>]

Remove-AzDnsRecordConfig
      -RecordSet <DnsRecordSet>
      -Usage <Int32>
      -Selector <Int32>
      -MatchingType <Int32>
      -CertificateAssociationData <String>
      [-DefaultProfile <IAzureContextContainer>]
      [<CommonParameters>]

Description

De cmdlet Remove-AzDnsRecordConfig verwijdert een DNS-record (Domain Name System) uit een recordset. Het RecordSet-object is een offlineobject en wijzigingen in het object wijzigen pas de DNS-antwoorden nadat u de cmdlet Set-AzDnsRecordSet hebt uitgevoerd om de wijziging in de Microsoft Azure DNS-service te behouden. Als u een record wilt verwijderen, moeten alle velden voor dat recordtype exact overeenkomen. U kunt GEEN SOA-records toevoegen of verwijderen. SOA-records worden automatisch gemaakt wanneer een DNS-zone wordt gemaakt en automatisch verwijderd wanneer de DNS-zone wordt verwijderd. U kunt het RecordSet-object als parameter doorgeven aan deze cmdlet of met behulp van de pijplijnoperator.

Voorbeelden

Voorbeeld 1: Een A-record verwijderen uit een recordset

$RecordSet = Get-AzDnsRecordSet -Name "www" -RecordType A -ResourceGroupName "MyResourceGroup" -ZoneName "myzone.com"
Remove-AzDnsRecordConfig -RecordSet $RecordSet -Ipv4Address 1.2.3.4
Set-AzDnsRecordSet -RecordSet $RecordSet

# The above sequence can also be piped:

Get-AzDnsRecordSet -Name "www" -RecordType A -ResourceGroupName "MyResourceGroup" -ZoneName "myzone.com" | Remove-AzDnsRecordConfig -Ipv4Address 1.2.3.4 | Set-AzDnsRecordSet

In dit voorbeeld wordt een A-record verwijderd uit een bestaande recordset. Als dit de enige record in de recordset is, is het resultaat een lege recordset. Als u een recordset volledig wilt verwijderen, raadpleegt u Remove-AzDnsRecordSet.

Voorbeeld 2: Een AAAA-record verwijderen uit een recordset

$RecordSet = Get-AzDnsRecordSet -Name "www" -RecordType AAAA -ResourceGroupName "MyResourceGroup" -ZoneName "myzone.com"
Remove-AzDnsRecordConfig -RecordSet $RecordSet -Ipv6Address 2001:DB80:4009:1803::1005
Set-AzDnsRecordSet -RecordSet $RecordSet

# The above sequence can also be piped:

Get-AzDnsRecordSet -Name "www" -RecordType AAAA -ResourceGroupName "MyResourceGroup" -ZoneName "myzone.com" | Remove-AzDnsRecordConfig -Ipv6Address 2001:DB80:4009:1803::1005 | Set-AzDnsRecordSet

In dit voorbeeld wordt een AAAA-record verwijderd uit een bestaande recordset. Als dit de enige record in de recordset is, is het resultaat een lege recordset. Als u een recordset volledig wilt verwijderen, raadpleegt u Remove-AzDnsRecordSet.

Voorbeeld 3: Een CNAME-record verwijderen uit een recordset

$RecordSet = Get-AzDnsRecordSet -Name "www" -RecordType CNAME -ResourceGroupName "MyResourceGroup" -ZoneName "myzone.com"
Remove-AzDnsRecordConfig -RecordSet $RecordSet -Cname contoso.com
Set-AzDnsRecordSet -RecordSet $RecordSet

# The above sequence can also be piped:

Get-AzDnsRecordSet -Name "www" -RecordType CNAME -ResourceGroupName "MyResourceGroup" -ZoneName "myzone.com" | Remove-AzDnsRecordConfig -Cname contoso.com | Set-AzDnsRecordSet

In dit voorbeeld wordt een CNAME-record verwijderd uit een bestaande recordset. Omdat een CNAME-recordset maximaal één record kan bevatten, is het resultaat een lege recordset.

Voorbeeld 4: Een MX-record verwijderen uit een recordset

$RecordSet = Get-AzDnsRecordSet -Name "@" -RecordType MX -ResourceGroupName "MyResourceGroup" -ZoneName "myzone.com"
Remove-AzDnsRecordConfig -Exchange mail.microsoft.com -Preference 5 -RecordSet $RecordSet
Set-AzDnsRecordSet -RecordSet $RecordSet

# The above sequence can also be piped:

Get-AzDnsRecordSet -Name "@" -RecordType MX -ResourceGroupName "MyResourceGroup" -ZoneName "myzone.com" | Remove-AzDnsRecordConfig -Exchange mail.microsoft.com -Preference 5 | Set-AzDnsRecordSet

In dit voorbeeld wordt een MX-record verwijderd uit een bestaande recordset. De recordnaam @geeft een recordset aan in de zone-apex. Als dit de enige record in de recordset is, is het resultaat een lege recordset. Als u een recordset volledig wilt verwijderen, raadpleegt u Remove-AzDnsRecordSet.

Voorbeeld 5: Een NS-record verwijderen uit een recordset

$RecordSet = Get-AzDnsRecordSet -Name "abc" -RecordType NS -ResourceGroupName "MyResourceGroup" -ZoneName "myzone.com"
Remove-AzDnsRecordConfig -Nsdname ns1.myzone.com -RecordSet $RecordSet
Set-AzDnsRecordSet -RecordSet $RecordSet

# The above sequence can also be piped:

Get-AzDnsRecordSet -Name "abc" -RecordType NS -ResourceGroupName "MyResourceGroup" -ZoneName "myzone.com" | Remove-AzDnsRecordConfig -Nsdname "ns1.myzone.com" | Set-AzDnsRecordSet

In dit voorbeeld wordt een NS-record verwijderd uit een bestaande recordset. Als dit de enige record in de recordset is, is het resultaat een lege recordset. Als u een recordset volledig wilt verwijderen, raadpleegt u Remove-AzDnsRecordSet.

Voorbeeld 6: Een PTR-record verwijderen uit een recordset

$RecordSet = Get-AzDnsRecordSet -Name "4" -RecordType PTR -ResourceGroupName "MyResourceGroup" -ZoneName 3.2.1.in-addr.arpa
Remove-AzDnsRecordConfig -Ptrdname www.contoso.com -RecordSet $RecordSet
Set-AzDnsRecordSet -RecordSet $RecordSet

# The above sequence can also be piped:

Get-AzDnsRecordSet -Name "4" -RecordType PTR -ResourceGroupName "MyResourceGroup" -ZoneName "3.2.1.in-addr.arpa" | Remove-AzDnsRecordConfig -Ptrdname www.contoso.com | Set-AzDnsRecordSet

In dit voorbeeld wordt een PTR-record verwijderd uit een bestaande recordset. Als dit de enige record in de recordset is, is het resultaat een lege recordset. Als u een recordset volledig wilt verwijderen, raadpleegt u Remove-AzDnsRecordSet.

Voorbeeld 7: Een SRV-record verwijderen uit een recordset

$RecordSet = Get-AzDnsRecordSet -Name "_sip._tcp" -RecordType SRV -ResourceGroupName "MyResourceGroup" -ZoneName "myzone.com"
Remove-AzDnsRecordConfig -RecordSet $RecordSet -Priority 0 -Weight 5 -Port 8080 -Target target.example.com
Set-AzDnsRecordSet -RecordSet $RecordSet

# The above sequence can also be piped:

Get-AzDnsRecordSet -Name "_sip._tcp" -RecordType SRV -ResourceGroupName "MyResourceGroup" -ZoneName "myzone.com" | Remove-AzDnsRecordConfig -Priority 0 -Weight 5 -Port 8080 -Target target.example.com  | Set-AzDnsRecordSet

In dit voorbeeld wordt een SRV-record verwijderd uit een bestaande recordset. Als dit de enige record in de recordset is, is het resultaat een lege recordset. Als u een recordset volledig wilt verwijderen, raadpleegt u Remove-AzDnsRecordSet.

Voorbeeld 8: Een TXT-record verwijderen uit een recordset

$RecordSet = Get-AzDnsRecordSet -Name "text" -RecordType TXT -ResourceGroupName "MyResourceGroup" -ZoneName "myzone.com"
Remove-AzDnsRecordConfig -RecordSet $RecordSet -Value "This is a TXT Record"
Set-AzDnsRecordSet -RecordSet $RecordSet

# The above sequence can also be piped:

Get-AzDnsRecordSet -Name "text" -RecordType TXT -ResourceGroupName "MyResourceGroup" -ZoneName "myzone.com" | Remove-AzDnsRecordConfig -Value "This is a TXT Record"  | Set-AzDnsRecordSet

In dit voorbeeld wordt een TXT-record verwijderd uit een bestaande recordset. Als dit de enige record in de recordset is, is het resultaat een lege recordset. Als u een recordset volledig wilt verwijderen, raadpleegt u Remove-AzDnsRecordSet.

Voorbeeld 9: Een DS-record verwijderen uit een recordset

$RecordSet = Get-AzDnsRecordSet -Name "www" -RecordType DS -ResourceGroupName "MyResourceGroup" -ZoneName "myzone.com"
Remove-AzDnsRecordConfig -KeyTag 12345 -Algorithm 3 -DigestType 1 -Digest "49FD46E6C4B45C55D4AC"
Set-AzDnsRecordSet -RecordSet $RecordSet

# The above sequence can also be piped:

Get-AzDnsRecordSet -Name "www" -RecordType DS -ResourceGroupName "MyResourceGroup" -ZoneName "myzone.com" | Remove-AzDnsRecordConfig -KeyTag 12345 -Algorithm 3 -DigestType 1 -Digest "49FD46E6C4B45C55D4AC"  | Set-AzDnsRecordSet

In dit voorbeeld wordt een DS-record verwijderd uit een bestaande recordset. Als dit de enige record in de recordset is, is het resultaat een lege recordset. Als u een recordset volledig wilt verwijderen, raadpleegt u Remove-AzDnsRecordSet.

Voorbeeld 10: Een TLSA-record verwijderen uit een recordset

$RecordSet = Get-AzDnsRecordSet -Name "_443._tcp.www" -RecordType TLSA -ResourceGroupName "MyResourceGroup" -ZoneName "myzone.com"
Remove-AzDnsRecordConfig -Usage 3 -Selector 1 -MatchingType 1 -CertificateAssociationData "49FD46E6C4B45C55D4AC"
Set-AzDnsRecordSet -RecordSet $RecordSet

# The above sequence can also be piped:

Get-AzDnsRecordSet -Name "_443._tcp.www" -RecordType TLSA -ResourceGroupName "MyResourceGroup" -ZoneName "myzone.com" | Remove-AzDnsRecordConfig -Usage 3 -Selector 1 -MatchingType 1 -CertificateAssociationData "49FD46E6C4B45C55D4AC"  | Set-AzDnsRecordSet

In dit voorbeeld wordt een TLSA-record verwijderd uit een bestaande recordset. Als dit de enige record in de recordset is, is het resultaat een lege recordset. Als u een recordset volledig wilt verwijderen, raadpleegt u Remove-AzDnsRecordSet.

Parameters

-Algorithm

Het algoritmeveld van de DS-record dat moet worden verwijderd.

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

-CaaFlags

De vlaggen voor de CAA-record die moeten worden toegevoegd. Moet een getal tussen 0 en 255 zijn.

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

-CaaTag

Het tagveld van de CAA-record die moet worden toegevoegd.

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

-CaaValue

Het waardeveld voor de CAA-record die moet worden toegevoegd.

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

-CertificateAssociationData

Het veld met certificaatkoppelingsgegevens van de TLSA-record die u wilt verwijderen.

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

-Cname

Hiermee geeft u de domeinnaam voor een canonieke naam (CNAME) record.

Type:	String
Position:	Named
Default value:	None
Vereist:	True
Pijplijninvoer accepteren:	True
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

-Digest

Het digest-veld van de DS-record die u wilt verwijderen.

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

-DigestType

Het digest-typeveld van de DS-record die u wilt verwijderen.

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

-Exchange

Hiermee geeft u de naam van de mail exchange-server voor een MX-record (Mail Exchange).

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

-Ipv4Address

Hiermee geeft u een IPv4-adres voor een A-record op.

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

-Ipv6Address

Hiermee geeft u een IPv6-adres voor een AAAA-record op.

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

-KeyTag

Het sleutellabelveld van de DS-record die u wilt verwijderen.

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

-MatchingType

Het overeenkomende typeveld van de TLSA-record die u wilt verwijderen.

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

-Nsdname

Hiermee geeft u de naamserver voor een naamserverrecord (NS).

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

-Port

Hiermee geeft u de poort voor een servicerecord (SRV).

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

-Preference

Hiermee geeft u de voorkeur voor een MX-record.

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

-Priority

Hiermee geeft u de prioriteit voor een SRV-record.

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

-Ptrdname

Hiermee geeft u de doeldomeinnaam van een PTR-record (pointer).

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

-RecordSet

Hiermee geeft u het RecordSet-object op dat de record bevat die u wilt verwijderen.

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

-Selector

Het selectorveld van de TLSA-record die u wilt verwijderen.

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

-Target

Hiermee geeft u het doel voor een SRV-record.

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

-Usage

Het gebruiksveld van de TLSA-record die u wilt verwijderen.

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

-Value

Hiermee geeft u de waarde voor een TXT-record.

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

-Weight

Hiermee geeft u het gewicht voor een SRV-record.

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

Invoerwaarden

DnsRecordSet

String

UInt16

Byte

Uitvoerwaarden