Partager via

Remove-AzDnsZone

  • Référence
Module:
Az.Dns

Supprime une zone DNS d’un groupe de ressources.

Syntaxe

Remove-AzDnsZone
      -Name <String>
      -ResourceGroupName <String>
      [-PassThru]
      [-DefaultProfile <IAzureContextContainer>]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]
Remove-AzDnsZone
      -Zone <DnsZone>
      [-Overwrite]
      [-PassThru]
      [-DefaultProfile <IAzureContextContainer>]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]

Description

L’applet de commande Remove-AzDnsZone supprime définitivement une zone DNS (Domain Name System) d’un groupe de ressources spécifié. Tous les jeux d’enregistrements contenus dans la zone sont également supprimés. Vous pouvez transmettre un objet DnsZone à l’aide du paramètre Name ou à l’aide de l’opérateur de pipeline, 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 la zone à l’aide d’un objet DnsZone (transmis via le pipeline ou le paramètre Zone), la zone n’est pas supprimée si elle a été modifiée dans Azure DNS depuis que l’objet DnsZone local a été récupéré (seules les opérations directement sur le nombre de ressources de la zone DNS en tant que modifications, les opérations sur les jeux d’enregistrements dans la zone ne le font pas). Cela offre une protection pour les modifications simultanées de zone. Cela peut être supprimé à l’aide du paramètre Overwrite , qui supprime la zone indépendamment des modifications simultanées.

Exemples

Exemple 1 : Supprimer une zone

Remove-AzDnsZone -Name "myzone.com" -ResourceGroupName "MyResourceGroup"

Cette commande supprime la zone nommée myzone.com du groupe de ressources nommé MyResourceGroup.

Paramètres

-Confirm

Vous demande une confirmation avant d’exécuter la commande cmdlet.

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 de la zone DNS supprimée par cette applet de commande. Vous devez également spécifier le paramètre ResourceGroupName . Vous pouvez également spécifier la zone DNS à l’aide du paramètre 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

-Overwrite

Lorsque vous spécifiez la zone à l’aide d’un objet DnsZone (transmis via le pipeline ou le paramètre Zone), la zone n’est pas supprimée si elle a été modifiée dans Azure DNS depuis que l’objet DnsZone local a été récupéré (seules les opérations directement sur le nombre de ressources de la zone DNS en tant que modifications, les opérations sur les jeux d’enregistrements dans la zone ne le font pas). Cela offre une protection pour les modifications simultanées de zone. Cela peut être supprimé à l’aide du paramètre Overwrite , qui supprime la zone 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

-ResourceGroupName

Spécifie le nom du groupe de ressources qui contient la zone à supprimer. Vous devez également spécifier le paramètre ZoneName . Vous pouvez également spécifier la zone DNS à l’aide d’un objet DnsZone , transmis via le pipeline ou le paramètre 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 à supprimer. L’objet DnsZone transmis peut également être transmis via le pipeline. Vous pouvez également spécifier la zone DNS à supprimer à l’aide des paramètres 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

Entrées

String

DnsZone

Sorties

Boolean

Notes

En raison de l’impact potentiellement élevé de la suppression d’une zone DNS, par défaut, cette applet de commande vous invite à confirmer si la variable $ConfirmPreference Windows PowerShell a une valeur autre que None. 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.