Remove-AzDnsRecordSet
Supprime un jeu d’enregistrements.
Syntaxe
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
L’applet de commande Remove-AzDnsRecordSet supprime le jeu d’enregistrements spécifié de la zone spécifiée. Vous ne pouvez pas supprimer les enregistrements SOA ou serveur de noms (NS) créés automatiquement à l’apex de la zone. Vous pouvez transmettre un objet RecordSet à cette applet de commande à l’aide de l’opérateur de pipeline ou en tant que paramètre. Pour identifier un jeu d’enregistrements par nom et par type sans utiliser d’objet RecordSet, vous devez transmettre la zone en tant qu’objet DnsZone à cette applet de commande à l’aide de l’opérateur de pipeline ou en tant que paramètre, ou vous pouvez également spécifier les paramètres ZoneName et ResourceGroupName. Vous pouvez utiliser le paramètre Confirm et $ConfirmPreference variable Windows PowerShell pour contrôler si l’applet de commande vous invite à confirmer. Lorsque vous spécifiez le jeu d’enregistrements à l’aide d’un objet RecordSet, le jeu d’enregistrements n’est pas supprimé s’il a été modifié dans Azure DNS depuis la récupération de l’objet RecordSet local. Cela offre une protection pour les modifications simultanées. Vous pouvez supprimer cette opération à l’aide du paramètre Overwrite , qui supprime le jeu d’enregistrements indépendamment des modifications simultanées.
Exemples
Exemple 1 : Supprimer un jeu d’enregistrements
$RecordSet = Get-AzDnsRecordSet -Name "www" -ResourceGroupName "MyResourceGroup" -ZoneName "myzone.com"
Remove-AzDnsRecordSet -RecordSet $RecordSet
La première commande obtient le jeu d’enregistrements spécifié, puis le stocke dans la variable $RecordSet. La deuxième commande supprime le jeu d’enregistrements dans $RecordSet.
Exemple 2 : Supprimer un jeu d’enregistrements et supprimer toutes les confirmations
$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
La première commande obtient le jeu d’enregistrements spécifié. La deuxième commande supprime le jeu d’enregistrements, même s’il a changé en attendant. Les invites de confirmation sont supprimées.
Paramètres
-Confirm
Vous demande une confirmation avant d’exécuter l’applet de commande.
Type: | SwitchParameter |
Alias: | cf |
Position: | Named |
Valeur par défaut: | False |
Obligatoire: | False |
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 |
-Name
Spécifie le nom du Jeu d’enregistrements à supprimer. Lorsque vous spécifiez le jeu d’enregistrements par nom, la zone DNS doit être spécifiée à l’aide du paramètre Zone ou des paramètres ZoneName et ResourceGroupName . Vous pouvez également spécifier le jeu d’enregistrements à l’aide d’un objet RecordSet , passé à l’aide du paramètre RecordSet .
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 |
-Overwrite
Lorsque vous spécifiez le jeu d’enregistrements à l’aide d’un objet RecordSet, le jeu d’enregistrements n’est pas supprimé s’il a été modifié dans Azure DNS depuis la récupération de l’objet RecordSet local. Cela offre une protection pour les modifications simultanées. Cela peut être supprimé à l’aide du paramètre Overwrite , qui supprime le jeu d’enregistrements indépendamment des modifications simultanées.
Type: | SwitchParameter |
Position: | Named |
Valeur par défaut: | None |
Obligatoire: | False |
Accepter l'entrée de pipeline: | False |
Accepter les caractères génériques: | False |
-PassThru
passthru
Type: | SwitchParameter |
Position: | Named |
Valeur par défaut: | None |
Obligatoire: | False |
Accepter l'entrée de pipeline: | False |
Accepter les caractères génériques: | False |
-RecordSet
Spécifie l’objet RecordSet à supprimer. Vous pouvez également spécifier le jeu d’enregistrements à l’aide des paramètres Name et Zone, ou à l’aide des paramètres Name, ZoneName et ResourceGroupName.
Type: | DnsRecordSet |
Position: | Named |
Valeur par défaut: | None |
Obligatoire: | True |
Accepter l'entrée de pipeline: | True |
Accepter les caractères génériques: | False |
-RecordType
Spécifie le type d’enregistrement DNS. Les valeurs valides sont :
- Un
- AAAA
- CNAME
- MX
- NS
- PTR
- SRV
- Les enregistrements SOA TXT sont supprimés automatiquement lorsque la zone est supprimée. Vous ne pouvez pas supprimer manuellement les enregistrements SOA.
Type: | RecordType |
Valeurs acceptées: | A, Aaaa, CAA, Cname, MX, NS, PTR, SOA, SRV, TXT, Tlsa, DS, Naptr |
Position: | Named |
Valeur par défaut: | None |
Obligatoire: | True |
Accepter l'entrée de pipeline: | True |
Accepter les caractères génériques: | False |
-ResourceGroupName
Spécifie le groupe de ressources qui contient la zone DNS qui contient l’Objet RecordSet à supprimer. Ce paramètre s’applique uniquement lorsque le jeu d’enregistrements et la zone DNS sont spécifiés à l’aide des paramètres Name et ZoneName . Vous pouvez également spécifier le jeu d’enregistrements à l’aide du paramètre RecordSet ou des paramètres Name et Zone .
Type: | String |
Position: | Named |
Valeur par défaut: | None |
Obligatoire: | True |
Accepter l'entrée de pipeline: | True |
Accepter les caractères génériques: | False |
-WhatIf
Montre ce qui se passe en cas d’exécution de l’applet de commande. L’applet de commande n’est pas exécutée.
Type: | SwitchParameter |
Alias: | wi |
Position: | Named |
Valeur par défaut: | False |
Obligatoire: | False |
Accepter l'entrée de pipeline: | False |
Accepter les caractères génériques: | False |
-Zone
Spécifie la zone DNS qui contient le Jeu d’enregistrements à supprimer. Ce paramètre s’applique uniquement lors de la spécification du jeu d’enregistrements à l’aide du paramètre Name . Vous pouvez également spécifier le jeu d’enregistrements à l’aide du paramètre RecordSet ou des paramètres Name, ZoneName et ResourceGroupName.
Type: | DnsZone |
Position: | Named |
Valeur par défaut: | None |
Obligatoire: | True |
Accepter l'entrée de pipeline: | True |
Accepter les caractères génériques: | False |
-ZoneName
Spécifie le nom de la zone qui contient l’Objet RecordSet à supprimer. Vous devez également spécifier les paramètres Name et ResourceGroupName . Vous pouvez également spécifier le jeu d’enregistrements à l’aide du paramètre RecordSet ou des paramètres Name et Zone .
Type: | String |
Position: | Named |
Valeur par défaut: | None |
Obligatoire: | True |
Accepter l'entrée de pipeline: | True |
Accepter les caractères génériques: | False |
Entrées
Sorties
Notes
Vous pouvez utiliser le paramètre Confirm pour contrôler si cette applet de commande vous invite à confirmer. Par défaut, l’applet de commande vous invite à confirmer si la variable Windows PowerShell $ConfirmPreference a une valeur moyenne ou inférieure. Si vous spécifiez Confirm ou Confirm :$True, cette applet de commande vous invite à confirmer son exécution. Si vous spécifiez Confirm :$False, l’applet de commande ne vous invite pas à confirmer.
Liens associés
Commentaires
https://aka.ms/ContentUserFeedback.
Bientôt disponible : Tout au long de 2024, nous allons supprimer progressivement GitHub Issues comme mécanisme de commentaires pour le contenu et le remplacer par un nouveau système de commentaires. Pour plus d’informations, consultezEnvoyer et afficher des commentaires pour