Partager via

Remove-AzPrivateDnsRecordSet

  • Référence
Module:
Az.PrivateDns

Supprime un jeu d’enregistrements d’une zone DNS privé.

Syntaxe

Remove-AzPrivateDnsRecordSet
      -ResourceGroupName <String>
      -ZoneName <String>
      -Name <String>
      -RecordType <RecordType>
      [-PassThru]
      [-DefaultProfile <IAzureContextContainer>]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]
Remove-AzPrivateDnsRecordSet
      -Zone <PSPrivateDnsZone>
      -Name <String>
      -RecordType <RecordType>
      [-PassThru]
      [-DefaultProfile <IAzureContextContainer>]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]
Remove-AzPrivateDnsRecordSet
      -RecordSet <PSPrivateDnsRecordSet>
      [-Overwrite]
      [-PassThru]
      [-DefaultProfile <IAzureContextContainer>]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]
Remove-AzPrivateDnsRecordSet
      -ResourceId <String>
      [-PassThru]
      [-DefaultProfile <IAzureContextContainer>]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]

Description

L’applet de commande Remove-AzPrivateDnsRecordSet supprime le jeu d’enregistrements spécifié de la zone spécifiée. Vous ne pouvez pas supprimer les enregistrements SOA créés automatiquement à l’apex de la zone privée. Vous pouvez transmettre un objet RecordSet à cette applet de commande à l’aide de l’opérateur de pipeline ou en tant que paramètre ou en tant que ResourceId. Pour identifier un jeu d’enregistrements par nom et par type sans utiliser d’objet RecordSet, vous devez passer la zone en tant qu’objet PSPrivateDnsZone à 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 privé 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-AzPrivateDnsRecordSet -Name "www" -ResourceGroupName "MyResourceGroup" -ZoneName "myzone.com"
Remove-AzPrivateDnsRecordSet -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-AzPrivateDnsRecordSet -Name "www" -ZoneName "myzone.com" -ResourceGroupName "MyResourceGroup"
Remove-AzPrivateDnsRecordSet -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-AzPrivateDnsRecordSet -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:None
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

Nom des enregistrements dans le jeu d’enregistrements (par rapport au nom de la zone et sans 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

-Overwrite

N’utilisez pas le champ ETag du paramètre RecordSet pour les vérifications d’accès concurrentiel optimistes.

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

Utilisé pour transmettre le résultat (booléen) de l’opération supprimer la zone privée plus bas dans le pipeline.

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

Jeu d’enregistrements dans lequel ajouter 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

-RecordType

Type d’enregistrements DNS privé dans le jeu d’enregistrements.

Type:RecordType
Valeurs acceptées:A, AAAA, CNAME, MX, PTR, SOA, SRV, TXT
Position:Named
Valeur par défaut:None
Obligatoire:True
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-ResourceGroupName

Groupe de ressources auquel appartient la zone.

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

-ResourceId

DNS privé RecordSet ResourceID.

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:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-Zone

Objet PrivateDnsZone représentant la zone dans laquelle créer le jeu d’enregistrements.

Type:PSPrivateDnsZone
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

Zone dans laquelle le jeu d’enregistrements existe (sans 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

Entrées

PSPrivateDnsZone

PSPrivateDnsRecordSet

String

Sorties

Boolean