Remove-AzDnsRecordConfig

Supprime un enregistrement DNS d’un objet de jeu d’enregistrements local.

Syntax

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

L’applet de commande Remove-AzDnsRecordConfig supprime un enregistrement DNS (Domain Name System) d’un jeu d’enregistrements. L’objet RecordSet est un objet hors connexion et les modifications apportées à celui-ci ne modifient pas les réponses DNS tant que vous n’avez pas exécuté l’applet de commande Set-AzDnsRecordSet pour conserver la modification apportée au service DNS Microsoft Azure. Pour supprimer un enregistrement, tous les champs de ce type d’enregistrement doivent correspondre exactement. Vous ne pouvez pas ajouter ou supprimer des enregistrements SOA. Les enregistrements SOA sont créés automatiquement lorsqu’une zone DNS est créée et supprimée automatiquement lorsque la zone DNS est supprimée. Vous pouvez transmettre l’objet RecordSet à cette applet de commande en tant que paramètre ou à l’aide de l’opérateur de pipeline.

Exemples

Exemple 1 : Supprimer un enregistrement A d’un jeu d’enregistrements

$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

Cet exemple supprime un enregistrement A d’un jeu d’enregistrements existant. S’il s’agit du seul enregistrement dans le jeu d’enregistrements, le résultat est un jeu d’enregistrements vide. Pour supprimer entièrement un jeu d’enregistrements, consultez Remove-AzDnsRecordSet.

Exemple 2 : Supprimer un enregistrement AAAA d’un jeu d’enregistrements

$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

Cet exemple supprime un enregistrement AAAA d’un jeu d’enregistrements existant. S’il s’agit du seul enregistrement dans le jeu d’enregistrements, le résultat est un jeu d’enregistrements vide. Pour supprimer entièrement un jeu d’enregistrements, consultez Remove-AzDnsRecordSet.

Exemple 3 : Supprimer un enregistrement CNAME d’un jeu d’enregistrements

$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

Cet exemple supprime un enregistrement CNAME d’un jeu d’enregistrements existant. Étant donné qu’un jeu d’enregistrements CNAME peut contenir au maximum un enregistrement, le résultat est un jeu d’enregistrements vide.

Exemple 4 : Supprimer un enregistrement MX d’un jeu d’enregistrements

$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

Cet exemple supprime un enregistrement MX d’un jeu d’enregistrements existant. Le nom d’enregistrement « @ » indique un jeu d’enregistrements à l’apex de la zone. S’il s’agit du seul enregistrement du jeu d’enregistrements, le résultat est un jeu d’enregistrements vide. Pour supprimer entièrement un jeu d’enregistrements, consultez Remove-AzDnsRecordSet.

Exemple 5 : Supprimer un enregistrement NS d’un jeu d’enregistrements

$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

Cet exemple supprime un enregistrement NS d’un jeu d’enregistrements existant. S’il s’agit du seul enregistrement du jeu d’enregistrements, le résultat est un jeu d’enregistrements vide. Pour supprimer entièrement un jeu d’enregistrements, consultez Remove-AzDnsRecordSet.

Exemple 6 : Supprimer un enregistrement PTR d’un jeu d’enregistrements

$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

Cet exemple supprime un enregistrement PTR d’un jeu d’enregistrements existant. S’il s’agit du seul enregistrement du jeu d’enregistrements, le résultat est un jeu d’enregistrements vide. Pour supprimer entièrement un jeu d’enregistrements, consultez Remove-AzDnsRecordSet.

Exemple 7 : Supprimer un enregistrement SRV d’un jeu d’enregistrements

$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

Cet exemple supprime un enregistrement SRV d’un jeu d’enregistrements existant. S’il s’agit du seul enregistrement du jeu d’enregistrements, le résultat est un jeu d’enregistrements vide. Pour supprimer entièrement un jeu d’enregistrements, consultez Remove-AzDnsRecordSet.

Exemple 8 : Supprimer un enregistrement TXT d’un jeu d’enregistrements

$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

Cet exemple supprime un enregistrement TXT d’un jeu d’enregistrements existant. S’il s’agit du seul enregistrement du jeu d’enregistrements, le résultat est un jeu d’enregistrements vide. Pour supprimer entièrement un jeu d’enregistrements, consultez Remove-AzDnsRecordSet.

Exemple 9 : Supprimer un enregistrement DS d’un jeu d’enregistrements

$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

Cet exemple supprime un enregistrement DS d’un jeu d’enregistrements existant. S’il s’agit du seul enregistrement du jeu d’enregistrements, le résultat est un jeu d’enregistrements vide. Pour supprimer entièrement un jeu d’enregistrements, consultez Remove-AzDnsRecordSet.

Exemple 10 : Supprimer un enregistrement TLSA d’un jeu d’enregistrements

$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

Cet exemple supprime un enregistrement TLSA d’un jeu d’enregistrements existant. S’il s’agit du seul enregistrement du jeu d’enregistrements, le résultat est un jeu d’enregistrements vide. Pour supprimer entièrement un jeu d’enregistrements, consultez Remove-AzDnsRecordSet.

Paramètres

-Algorithm

Champ d’algorithme de l’enregistrement DS à supprimer.

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

-CaaFlags

Indicateurs pour l’enregistrement CAA à ajouter. Doit être un nombre compris entre 0 et 255.

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

-CaaTag

Champ d’étiquette de l’enregistrement CAA à ajouter.

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

-CaaValue

Champ valeur de l’enregistrement CAA à ajouter.

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

-CertificateAssociationData

Champ de données d’association de certificats de l’enregistrement TLSA à supprimer.

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

-Cname

Spécifie le nom de domaine d’un enregistrement de nom canonique (CNAME).

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

-DefaultProfile

Informations d’identification, compte, locataire et abonnement utilisés pour la communication avec Azure

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

-Digest

Champ de synthèse de l’enregistrement DS à supprimer.

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

-DigestType

Champ de type digest de l’enregistrement DS à supprimer.

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

-Exchange

Spécifie le nom du serveur d’échange de courrier pour un enregistrement MX (Mail Exchange).

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

-Ipv4Address

Spécifie une adresse IPv4 pour un enregistrement A.

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

-Ipv6Address

Spécifie une adresse IPv6 pour un enregistrement AAAA.

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

-KeyTag

Champ d’étiquette de clé de l’enregistrement DS à supprimer.

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

-MatchingType

Champ de type correspondant de l’enregistrement TLSA à supprimer.

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

-Nsdname

Spécifie le serveur de noms pour un enregistrement de serveur de noms (NS).

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

-Port

Spécifie le port d’un enregistrement de service (SRV).

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

-Preference

Spécifie la préférence pour un enregistrement MX.

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

-Priority

Spécifie la priorité d’un enregistrement SRV.

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

-Ptrdname

Spécifie le nom de domaine cible d’un enregistrement de pointeur (PTR).

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

-RecordSet

Spécifie l’objet RecordSet qui contient l’enregistrement à supprimer.

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

-Selector

Champ sélecteur de l’enregistrement TLSA à supprimer.

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

-Target

Spécifie la cible d’un enregistrement SRV.

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

-Usage

Champ d’utilisation de l’enregistrement TLSA à supprimer.

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

-Value

Spécifie la valeur d’un enregistrement TXT.

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

-Weight

Spécifie le poids d’un enregistrement SRV.

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

Entrées

DnsRecordSet

String

UInt16

Byte

Sorties

DnsRecordSet