Remove-AzDnsRecordSet

  • Référence
Module:
Az.Dns

Supprime un jeu d’enregistrements.

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

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
Aliases:cf
Position:Named
Default value:False
Required:False
Accept pipeline input:False
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

-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
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters: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
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

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
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-RecordType

Spécifie le type d’enregistrement DNS. Les valeurs valides sont :

  • A
  • 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
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

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
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters: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
Aliases:wi
Position:Named
Default value:False
Required:False
Accept pipeline input:False
Accept wildcard characters: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
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters: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
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

Entrées

RecordType

String

DnsZone

DnsRecordSet

Sorties

Boolean

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.