Remove-AzPrivateDnsRecordConfig
Supprime un enregistrement DNS privé d’un objet de jeu d’enregistrements local.
Syntaxe
Remove-AzPrivateDnsRecordConfig
-RecordSet <PSPrivateDnsRecordSet>
-Ipv4Address <String>
[-DefaultProfile <IAzureContextContainer>]
[<CommonParameters>] Remove-AzPrivateDnsRecordConfig
-RecordSet <PSPrivateDnsRecordSet>
-Ipv6Address <String>
[-DefaultProfile <IAzureContextContainer>]
[<CommonParameters>] Remove-AzPrivateDnsRecordConfig
-RecordSet <PSPrivateDnsRecordSet>
-Exchange <String>
-Preference <UInt16>
[-DefaultProfile <IAzureContextContainer>]
[<CommonParameters>] Remove-AzPrivateDnsRecordConfig
-RecordSet <PSPrivateDnsRecordSet>
-Ptrdname <String>
[-DefaultProfile <IAzureContextContainer>]
[<CommonParameters>] Remove-AzPrivateDnsRecordConfig
-RecordSet <PSPrivateDnsRecordSet>
-Value <String>
[-DefaultProfile <IAzureContextContainer>]
[<CommonParameters>] Remove-AzPrivateDnsRecordConfig
-RecordSet <PSPrivateDnsRecordSet>
-Priority <UInt16>
-Target <String>
-Port <UInt16>
-Weight <UInt16>
[-DefaultProfile <IAzureContextContainer>]
[<CommonParameters>] Remove-AzPrivateDnsRecordConfig
-RecordSet <PSPrivateDnsRecordSet>
-Cname <String>
[-DefaultProfile <IAzureContextContainer>]
[<CommonParameters>] Description
L’applet de commande Remove-AzPrivateDnsRecordConfig supprime un enregistrement DNS (Private Domain Name System) d’un jeu d’enregistrements. L’objet RecordSet est un objet hors connexion et ne modifie pas les réponses DNS privées tant que vous n’avez pas exécuté l’applet de commande Set-AzPrivateDnsRecordSet pour conserver la modification apportée au service DNS privé 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 privée est créée et supprimée automatiquement lorsque la zone DNS privée 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-AzPrivateDnsRecordSet -Name "www" -RecordType A -ResourceGroupName "MyResourceGroup" -ZoneName "myzone.com"
Remove-AzPrivateDnsRecordConfig -RecordSet $RecordSet -Ipv4Address 1.2.3.4
Set-AzPrivateDnsRecordSet -RecordSet $RecordSet
# The above sequence can also be piped:
Get-AzPrivateDnsRecordSet -Name "www" -RecordType A -ResourceGroupName "MyResourceGroup" -ZoneName "myzone.com" | Remove-AzPrivateDnsRecordConfig -Ipv4Address 1.2.3.4 | Set-AzPrivateDnsRecordSet
Id : /subscriptions/xxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx/resourceGroups/myresourcegroup/providers/Micros
oft.Network/privateDnsZones/myzone.com/A/www
Name : www
ZoneName : myzone.com
ResourceGroupName : MyResourceGroup
Ttl : 3600
Etag : xxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx
RecordType : A
Records : {}
Metadata :
IsAutoRegistered :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-AzPrivateDnsRecordSet.
Exemple 2 : Supprimer un enregistrement AAAA d’un jeu d’enregistrements
$RecordSet = Get-AzPrivateDnsRecordSet -Name "www" -RecordType AAAA -ResourceGroupName "MyResourceGroup" -ZoneName "myzone.com"
Remove-AzPrivateDnsRecordConfig -RecordSet $RecordSet -Ipv6Address 2001:DB80:4009:1803::1005
Set-AzPrivateDnsRecordSet -RecordSet $RecordSet
# The above sequence can also be piped:
Get-AzPrivateDnsRecordSet -Name "www" -RecordType AAAA -ResourceGroupName "MyResourceGroup" -ZoneName "myzone.com" | Remove-AzPrivateDnsRecordConfig -Ipv6Address 2001:DB80:4009:1803::1005 | Set-AzPrivateDnsRecordSet
Id : /subscriptions/xxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx/resourceGroups/myresourcegroup/providers/Micros
oft.Network/privateDnsZones/myzone.com/AAAA/www
Name : www
ZoneName : myzone.com
ResourceGroupName : MyResourceGroup
Ttl : 3600
Etag : xxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx
RecordType : AAAA
Records : {}
Metadata :
IsAutoRegistered :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-AzPrivateDnsRecordSet.
Exemple 3 : Supprimer un enregistrement CNAME d’un jeu d’enregistrements
$RecordSet = Get-AzPrivateDnsRecordSet -Name "www" -RecordType CNAME -ResourceGroupName "MyResourceGroup" -ZoneName "myzone.com"
Remove-AzPrivateDnsRecordConfig -RecordSet $RecordSet -Cname contoso.com
Set-AzPrivateDnsRecordSet -RecordSet $RecordSet
# The above sequence can also be piped:
Get-AzPrivateDnsRecordSet -Name "www" -RecordType CNAME -ResourceGroupName "MyResourceGroup" -ZoneName "myzone.com" | Remove-AzPrivateDnsRecordConfig -Cname contoso.com | Set-AzPrivateDnsRecordSet
Id : /subscriptions/xxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx/resourceGroups/myresourcegroup/providers/Micros
oft.Network/privateDnsZones/myzone.com/CNAME/www
Name : www
ZoneName : myzone.com
ResourceGroupName : MyResourceGroup
Ttl : 3600
Etag : xxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx
RecordType : CNAME
Records : {}
Metadata :
IsAutoRegistered :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-AzPrivateDnsRecordSet -Name "@" -RecordType MX -ResourceGroupName "MyResourceGroup" -ZoneName "myzone.com"
Remove-AzPrivateDnsRecordConfig -Exchange mail.microsoft.com -Preference 5 -RecordSet $RecordSet
Set-AzPrivateDnsRecordSet -RecordSet $RecordSet
# The above sequence can also be piped:
Get-AzPrivateDnsRecordSet -Name "@" -RecordType MX -ResourceGroupName "MyResourceGroup" -ZoneName "myzone.com" | Remove-AzPrivateDnsRecordConfig -Exchange mail.microsoft.com -Preference 5 | Set-AzPrivateDnsRecordSet
Id : /subscriptions/xxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx/resourceGroups/myresourcegroup/providers/Micros
oft.Network/privateDnsZones/myzone.com/MX/www
Name : www
ZoneName : myzone.com
ResourceGroupName : MyResourceGroup
Ttl : 3600
Etag : xxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx
RecordType : MX
Records : {}
Metadata :
IsAutoRegistered :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-AzPrivateDnsRecordSet.
Exemple 5 : Supprimer un enregistrement PTR d’un jeu d’enregistrements
$RecordSet = Get-AzPrivateDnsRecordSet -Name "4" -RecordType PTR -ResourceGroupName "MyResourceGroup" -ZoneName 3.2.1.in-addr.arpa
Remove-AzPrivateDnsRecordConfig -Ptrdname www.contoso.com -RecordSet $RecordSet
Set-AzPrivateDnsRecordSet -RecordSet $RecordSet
# The above sequence can also be piped:
Get-AzPrivateDnsRecordSet -Name "4" -RecordType PTR -ResourceGroupName "MyResourceGroup" -ZoneName "3.2.1.in-addr.arpa" | Remove-AzPrivateDnsRecordConfig -Ptrdname www.contoso.com | Set-AzPrivateDnsRecordSet
Id : /subscriptions/xxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx/resourceGroups/myresourcegroup/providers/Micros
oft.Network/privateDnsZones/3.2.1.in-addr.arpa/PTR/4
Name : 4
ZoneName : 3.2.1.in-addr.arpa
ResourceGroupName : MyResourceGroup
Ttl : 3600
Etag : xxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx
RecordType : PTR
Records : {}
Metadata :
IsAutoRegistered :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-AzPrivateDnsRecordSet.
Exemple 6 : Supprimer un enregistrement SRV d’un jeu d’enregistrements
$RecordSet = Get-AzPrivateDnsRecordSet -Name "_sip._tcp" -RecordType SRV -ResourceGroupName "MyResourceGroup" -ZoneName "myzone.com"
Remove-AzPrivateDnsRecordConfig -RecordSet $RecordSet -Priority 0 -Weight 5 -Port 8080 -Target target.example.com
Set-AzPrivateDnsRecordSet -RecordSet $RecordSet
# The above sequence can also be piped:
Get-AzPrivateDnsRecordSet -Name "_sip._tcp" -RecordType SRV -ResourceGroupName "MyResourceGroup" -ZoneName "myzone.com" | Remove-AzPrivateDnsRecordConfig -Priority 0 -Weight 5 -Port 8080 -Target target.example.com | Set-AzPrivateDnsRecordSet
Id : /subscriptions/xxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx/resourceGroups/myresourcegroup/providers/Micros
oft.Network/privateDnsZones/myzone.com/SRV/_sip._tcp
Name : _sip._tcp
ZoneName : myzone.com
ResourceGroupName : MyResourceGroup
Ttl : 3600
Etag : xxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx
RecordType : SRV
Records : {}
Metadata :
IsAutoRegistered :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-AzPrivateDnsRecordSet.
Exemple 7 : Supprimer un enregistrement TXT d’un jeu d’enregistrements
$RecordSet = Get-AzPrivateDnsRecordSet -Name "text" -RecordType TXT -ResourceGroupName "MyResourceGroup" -ZoneName "myzone.com"
Remove-AzPrivateDnsRecordConfig -RecordSet $RecordSet -Value "This is a TXT Record"
Set-AzPrivateDnsRecordSet -RecordSet $RecordSet
# The above sequence can also be piped:
Get-AzPrivateDnsRecordSet -Name "text" -RecordType TXT -ResourceGroupName "MyResourceGroup" -ZoneName "myzone.com" | Remove-AzPrivateDnsRecordConfig -Value "This is a TXT Record" | Set-AzPrivateDnsRecordSet
Id : /subscriptions/xxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx/resourceGroups/myresourcegroup/providers/Micros
oft.Network/privateDnsZones/myzone.com/TXT/text
Name : text
ZoneName : myzone.com
ResourceGroupName : MyResourceGroup
Ttl : 3600
Etag : xxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx
RecordType : TXT
Records : {}
Metadata :
IsAutoRegistered :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-AzPrivateDnsRecordSet.
Paramètres
-Cname
Nom canonique de l’enregistrement CNAME à supprimer. Ne doit pas être relatif au nom de la zone. Ne doit pas avoir de point de fin
| Type: | String |
| Position: | Named |
| Valeur par défaut: | None |
| Obligatoire: | True |
| Accepter l'entrée de pipeline: | False |
| Accepter les caractères génériques: | False |
-DefaultProfile
Informations d’identification, compte, locataire et abonnement utilisés pour la communication avec Azure.
| Type: | IAzureContextContainer |
| Alias: | AzContext, AzureRmContext, AzureCredential |
| Position: | Named |
| Valeur par défaut: | None |
| Obligatoire: | False |
| Accepter l'entrée de pipeline: | False |
| Accepter les caractères génériques: | False |
-Exchange
Hôte d’échange de courrier de l’enregistrement MX à supprimer. Ne doit pas être relatif au nom de la zone. Ne doit pas avoir de point de fin
| Type: | String |
| Position: | Named |
| Valeur par défaut: | None |
| Obligatoire: | True |
| Accepter l'entrée de pipeline: | False |
| Accepter les caractères génériques: | False |
-Ipv4Address
Adresse IPv4 de l’enregistrement A à supprimer.
| Type: | String |
| Position: | Named |
| Valeur par défaut: | None |
| Obligatoire: | True |
| Accepter l'entrée de pipeline: | False |
| Accepter les caractères génériques: | False |
-Ipv6Address
Adresse IPv6 de l’enregistrement AAAA à supprimer.
| Type: | String |
| Position: | Named |
| Valeur par défaut: | None |
| Obligatoire: | True |
| Accepter l'entrée de pipeline: | False |
| Accepter les caractères génériques: | False |
-Port
Numéro de port de l’enregistrement SRV à supprimer.
| Type: | UInt16 |
| Position: | Named |
| Valeur par défaut: | None |
| Obligatoire: | True |
| Accepter l'entrée de pipeline: | False |
| Accepter les caractères génériques: | False |
-Preference
Valeur de préférence de l’enregistrement MX à supprimer.
| Type: | UInt16 |
| Position: | Named |
| Valeur par défaut: | None |
| Obligatoire: | True |
| Accepter l'entrée de pipeline: | False |
| Accepter les caractères génériques: | False |
-Priority
Valeur de priorité de l’enregistrement SRV à supprimer.
| Type: | UInt16 |
| Position: | Named |
| Valeur par défaut: | None |
| Obligatoire: | True |
| Accepter l'entrée de pipeline: | False |
| Accepter les caractères génériques: | False |
-Ptrdname
Hôte cible de l’enregistrement PTR à supprimer. Ne doit pas être relatif au nom de la zone. Ne doit pas avoir de point de fin
| Type: | String |
| Position: | Named |
| Valeur par défaut: | None |
| Obligatoire: | True |
| Accepter l'entrée de pipeline: | False |
| Accepter les caractères génériques: | False |
-RecordSet
Jeu d’enregistrements à partir duquel supprimer l’enregistrement.
| Type: | PSPrivateDnsRecordSet |
| Position: | Named |
| Valeur par défaut: | None |
| Obligatoire: | True |
| Accepter l'entrée de pipeline: | True |
| Accepter les caractères génériques: | False |
-Target
Hôte cible de l’enregistrement SRV à supprimer. Ne doit pas être relatif au nom de la zone. Ne doit pas avoir de point de fin
| Type: | String |
| Position: | Named |
| Valeur par défaut: | None |
| Obligatoire: | True |
| Accepter l'entrée de pipeline: | False |
| Accepter les caractères génériques: | False |
-Value
Valeur de texte de l’enregistrement TXT à supprimer.
| Type: | String |
| Position: | Named |
| Valeur par défaut: | None |
| Obligatoire: | True |
| Accepter l'entrée de pipeline: | False |
| Accepter les caractères génériques: | False |
-Weight
Valeur de poids de l’enregistrement SRV à supprimer.
| Type: | UInt16 |
| Position: | Named |
| Valeur par défaut: | None |
| Obligatoire: | True |
| Accepter l'entrée de pipeline: | False |
| Accepter les caractères génériques: | False |
