Partager via

Remove-AzDnsRecordSet

Module:
Az.Dns Module

Supprime un jeu d’enregistrements.

Syntaxe

Fields 

Remove-AzDnsRecordSet
    -Name <String>
    -RecordType <RecordType>
    -ZoneName <String>
    -ResourceGroupName <String>
    [-PassThru]
    [-DefaultProfile <IAzureContextContainer>]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

Mixed 

Remove-AzDnsRecordSet
    -Name <String>
    -RecordType <RecordType>
    -Zone <DnsZone>
    [-PassThru]
    [-DefaultProfile <IAzureContextContainer>]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

Object 

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 invite à confirmer avant d’exécuter l’applet de commande.

Propriétés du paramètre

Type:SwitchParameter
Valeur par défaut:False
Prend en charge les caractères génériques:False
DontShow:False
Alias:cf

Jeux de paramètres

(All)
Position:Named
Obligatoire:False
Valeur du pipeline:False
Valeur du pipeline par nom de propriété:False
Valeur des arguments restants:False

-DefaultProfile

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

Propriétés du paramètre

Type:IAzureContextContainer
Valeur par défaut:None
Prend en charge les caractères génériques:False
DontShow:False
Alias:AzContext, AzureRmContext, AzureCredential

Jeux de paramètres

(All)
Position:Named
Obligatoire:False
Valeur du pipeline:False
Valeur du pipeline par nom de propriété:False
Valeur des arguments restants: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 .

Propriétés du paramètre

Type:String
Valeur par défaut:None
Prend en charge les caractères génériques:False
DontShow:False

Jeux de paramètres

Fields
Position:Named
Obligatoire:True
Valeur du pipeline:False
Valeur du pipeline par nom de propriété:False
Valeur des arguments restants:False
Mixed
Position:Named
Obligatoire:True
Valeur du pipeline:False
Valeur du pipeline par nom de propriété:False
Valeur des arguments restants: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.

Propriétés du paramètre

Type:SwitchParameter
Valeur par défaut:None
Prend en charge les caractères génériques:False
DontShow:False

Jeux de paramètres

Object
Position:Named
Obligatoire:False
Valeur du pipeline:False
Valeur du pipeline par nom de propriété:False
Valeur des arguments restants:False

-PassThru

Passthru

Propriétés du paramètre

Type:SwitchParameter
Valeur par défaut:None
Prend en charge les caractères génériques:False
DontShow:False

Jeux de paramètres

(All)
Position:Named
Obligatoire:False
Valeur du pipeline:False
Valeur du pipeline par nom de propriété:False
Valeur des arguments restants: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 .

Propriétés du paramètre

Type:DnsRecordSet
Valeur par défaut:None
Prend en charge les caractères génériques:False
DontShow:False

Jeux de paramètres

Object
Position:Named
Obligatoire:True
Valeur du pipeline:True
Valeur du pipeline par nom de propriété:False
Valeur des arguments restants:False

-RecordType

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

  • A
  • AAAA
  • CNAME
  • MX
  • NAPTR
  • 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.

Propriétés du paramètre

Type:RecordType
Valeur par défaut:None
Valeurs acceptées:A, Aaaa, CAA, Cname, MX, NS, PTR, SOA, SRV, TXT, Tlsa, DS, Naptr
Prend en charge les caractères génériques:False
DontShow:False

Jeux de paramètres

Fields
Position:Named
Obligatoire:True
Valeur du pipeline:False
Valeur du pipeline par nom de propriété:True
Valeur des arguments restants:False
Mixed
Position:Named
Obligatoire:True
Valeur du pipeline:False
Valeur du pipeline par nom de propriété:True
Valeur des arguments restants: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 .

Propriétés du paramètre

Type:String
Valeur par défaut:None
Prend en charge les caractères génériques:False
DontShow:False

Jeux de paramètres

Fields
Position:Named
Obligatoire:True
Valeur du pipeline:False
Valeur du pipeline par nom de propriété:True
Valeur des arguments restants:False

-WhatIf

Affiche ce qui se passerait si l’applet de commande s’exécute. L’applet de commande ne s’exécute pas.

Propriétés du paramètre

Type:SwitchParameter
Valeur par défaut:False
Prend en charge les caractères génériques:False
DontShow:False
Alias:Wi

Jeux de paramètres

(All)
Position:Named
Obligatoire:False
Valeur du pipeline:False
Valeur du pipeline par nom de propriété:False
Valeur des arguments restants: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 .

Propriétés du paramètre

Type:DnsZone
Valeur par défaut:None
Prend en charge les caractères génériques:False
DontShow:False

Jeux de paramètres

Mixed
Position:Named
Obligatoire:True
Valeur du pipeline:True
Valeur du pipeline par nom de propriété:False
Valeur des arguments restants: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 .

Propriétés du paramètre

Type:String
Valeur par défaut:None
Prend en charge les caractères génériques:False
DontShow:False

Jeux de paramètres

Fields
Position:Named
Obligatoire:True
Valeur du pipeline:False
Valeur du pipeline par nom de propriété:True
Valeur des arguments restants:False

CommonParameters

Cette applet de commande prend en charge les paramètres courants : -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction et -WarningVariable. Pour plus d’informations, consultez about_CommonParameters.

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.